# HotJava - The JAVA World Wide Web Browser

HotJava allows browsing of the World Wide Web and provides the ability to present interactive content across platforms. Interactive content is in the form of applets. Applets are programs written in the JAVA language to run within HotJava.

## SYNOPSIS

hotjava [ url ]

## DESCRIPTION

The hotjava command starts the HotJava browser and connects to the document or resource designated by url. If url is not supplied then HotJava goes to either:

- the page designated by the value of the environment variable WWW_HOME; or
- `file://~/demo` if WWW_HOME is unset.

## ENVIRONMENT VARIABLES

HOTJAVA_HOME
  The directory where HotJava looks for resources that it needs to run itself. By default this is set to the installation directory when the system is first installed.
WWW_HOME
  The default home page.
HOTJAVA_READ_PATH
  Used by HotJava to determine whether any applet has permission read a file. The value of HOTJAVA_READ_PATH is a semicolon-separated list of files or directories. By default HOTJAVA_READ_PATH is set to:

           <hotjava-install-dir>:$HOME/public_html/

  Each component of the path is used as a prefix to compare against the file that the applet wants to open for reading. Applets are allowed to read from
  - files in matching directories
  - files in subdirectories of matching directories
  - files that match a component exactly

  For example, let's say you have a directory:

           $HOME/Images

  As subdirectories under "Images" you have a "Private" subdirectory and a "Public" subdirectory. If you set HOTJAVA_READ_PATH to:

           <hotjava-install-dir>:$HOME/public_html/:$HOME/Images/

  an applet would be able to read the "Private" subdirectory. If you wanted to prevent applets from reading the "Private" subdirectory but allow them to read the "Public" one then you would set HOTJAVA_READ_PATH to:

           <hotjava-install-dir>:$HOME/public_html/:$HOME/Images/Public/

  In this way the directory "$HOME/Images/Private" won't match any component of HOTJAVA_READ_PATH and applets can't read files in it.

  Setting HOTJAVA_READ_PATH to "*" disables file checking for reads. The * should be quoted so the shell doesn't expand it.

HOTJAVA_WRITE_PATH
  Used by HotJava to determine whether an applet has permission to write to a file. The value of HOTJAVA_WRITE_PATH is a semicolon-separated list of files or directories. By default HOTJAVA_WRITE_PATH is set to:

           /tmp/:/devices/:/dev/:~/.hotjava/

  The components of the path are used as a prefix to compare against the file that the applet wants to open for writing.

  See HOTJAVA_READ_PATH for an example of how matching components works. The * should be quoted so the shell doesn't expand it.

  Setting HOTJAVA_WRITE_PATH to "*" disables file checking for writes.