.\" @(#)hotjava.1	1.1 96/11/01
.\" Copyright (c) 1996 Sun Microsystems, Inc.
.\"
.TH hotjava 1 "31 Oct 1996"
.BH "31 Oct 1996"
.\"
.\"
.\"
.SH NAME
hotjava \- the HotJava world-wide web browser
.SH SYNOPSIS
.BI "hotjava [ " options
.BI "] [ url ]"
.\"
.\"
.\"
.SH AVAILABILITY
.LP
SUNWdthj
.\"
.\"
.\"
.SH DESCRIPTION
The
.B HotJava
browser is an Internet browser that displays web pages consisting
of HTML (HyperText Markup Language) which can contain text, images
and interactive content in the form of applets.
.B HotJava
supports HTML 3.2 including forms, tables and client-side
image maps.
.LP
The 
.I hotjava
command starts the
.B HotJava
browser and connects to the 
document or resource designated by
.I url.
If
.I url
is not supplied 
then
.B hotjava
goes to either
the page designated by the value of the environment variable WWW_HOME; or
the default home page if WWW_HOME is not set.
.\"
.\"
.\"
.SH OPTIONS
.TP
\-DpropertyName=newValue
Redefines a property value. 
.I propertyName
is the name of the property
whose value you want to change and
.I newValue
is the value to change
it to. For example, the following
sets your default home page to the index.html file
in your home directory.
.IP
.B "example% hotjava -Dwww.home=~/index.html"
.fi
.\"
.\"
.\"
.SH OPERANDS
.TP
.I url
The URL (Uniform Resource Location) to use as the initial page.
If not specified the
.B www.home
property or the
.B WWW_HOME
environment variable are used.
.\"
.\"
.\"
.SH PROPERTIES
Use the 
.I -D
option to set these properties from the command line.
They may also be saved in the user specific properties
file in $HOME/.hotjava/properties.
See the online User's Guide in
.B HotJava
for other properties of interest.
.\"
.TP
hotjava.home
The directory where
.B HotJava
looks for resources that it needs to run itself.
This is not normally specified and defaults to the
value of the HOTJAVA_HOME environment variable.
.\"
.TP
www.home
The default home page.
By default this is set to the
.I "What's Hot"
page.
.\"
.\"
.\"
.SH ENVIRONMENT
.TP 14
HOTJAVA_HOME
Location of the
.B HotJava
configuration files.
This is not usually specified and defaults
to /usr/dt/appconfig/hotjava.
.TP
WWW_HOME
The URL to use as the default home page.
This overrides the
.I www.home
property.
.\"
.\"
.\"
.SH "EXIT STATUS"
The following exit values are returned:
.TP 14
.B 0
Successful completion.
.TP
.B >0
An error occurred.
.\"
.\"
.\"
.SH FILES
.PD 0
.TP 28
.BR "/usr/dt/appconfig/hotjava"
HotJava configuration files.
.TP
.BR "$HOTJAVA_HOME/lib/mailcap"
Default external viewers.
.TP
.BR "$HOME/.mailcap"
User specific external viewers.
.TP
.BR "$HOME/.hotjava"
Directory used by
.B HotJava
for customizations and state.
.TP
.BR "$HOME/.hotjava/properties"
User specific properties.
.PD
.\"
.\"
.\"
.SH "SEE ALSO"
.na
.BR "Multimedia Mail Configuration (RFC 1524)",
.BR sdthotjava (1),
.BR appletviewer (1),
.BR java (1).