Retro68/gcc/libjava/classpath/doc/gappletviewer.1

.\" Automatically generated by Pod::Man 2.27 (Pod::Simple 3.28)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{
.    if \nF \{
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "GAPPLETVIEWER 1"
.TH GAPPLETVIEWER 1 "2014-07-16" "0.99.1-pre" "GNU"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
gappletviewer \- Load and runs an applet
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
appletviewer [\fI\s-1OPTION\s0\fR]... \fI\s-1URL\s0\fR...
.PP
appletviewer [\fI\s-1OPTION\s0\fR]... \fB\-code\fR \fI\s-1CODE\s0\fR
.PP
appletviewer [\fI\s-1OPTION\s0\fR]... \fB\-plugin\fR \fI\s-1INPUT\s0\fR,\fI\s-1OUTPUT\s0\fR
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
The \fBappletviewer\fR tool loads and runs an applet.
.PP
Use the first form to test applets specified by tag.  The \s-1URL\s0 should
resolve to an \s-1HTML\s0 document from which the \fBappletviewer\fR will
extract applet tags.  The \s-1APPLET, EMBED\s0 and \s-1OBJECT\s0 tags are supported.
If a given document contains multiple applet tags, all the applets
will be loaded, with each applet appearing in its own window.
Likewise, when multiple URLs are specified, each applet tag instance
is given its own window.  If a given document contains no recognized
tags the \fBappletviewer\fR does nothing.
.PP
.Vb 1
\&        appletviewer http://www.gnu.org/software/classpath/
.Ve
.PP
Use the second form to test an applet in development.  This form
allows applet tag attributes to be supplied on the command line.  Only
one applet may be specified using the \fB\-code\fR option.  The
\&\fB\-code\fR option overrides the \s-1URL\s0 form \*(-- any URLs specified will
be ignored.
.PP
.Vb 1
\&        appletviewer \-code Test.class \-param datafile,data.txt
.Ve
.PP
\&\fBgcjwebplugin\fR uses the third form to communicate with the
\&\fBappletviewer\fR through named pipes.
.SH "OPTIONS"
.IX Header "OPTIONS"
\&\s-1URL OPTIONS\s0
.IP "\fB\-debug\fR" 4
.IX Item "-debug"
This option is not yet implemented but is provided for compatibility.
.IP "\fB\-encoding\fR \fI\s-1CHARSET\s0\fR" 4
.IX Item "-encoding CHARSET"
Use this option to specify an alternate character encoding for the
specified \s-1HTML\s0 page.
.PP
\&\s-1APPLET TAG OPTIONS\s0
.IP "\fB\-code\fR \fI\s-1CODE\s0\fR" 4
.IX Item "-code CODE"
Use the \fB\-code\fR option to specify the value of the applet tag
\&\fI\s-1CODE\s0\fR attribute.
.IP "\fB\-codebase\fR \fI\s-1CODEBASE\s0\fR" 4
.IX Item "-codebase CODEBASE"
Use the \fB\-codebase\fR option to specify the value of the applet tag
\&\fI\s-1CODEBASE\s0\fR attribute.
.IP "\fB\-archive\fR \fI\s-1ARCHIVE\s0\fR" 4
.IX Item "-archive ARCHIVE"
Use the \fB\-archive\fR option to specify the value of the applet tag
\&\fI\s-1ARCHIVE\s0\fR attribute.
.IP "\fB\-width\fR \fI\s-1WIDTH\s0\fR" 4
.IX Item "-width WIDTH"
Use the \fB\-width\fR option to specify the value of the applet tag
\&\fI\s-1WIDTH\s0\fR attribute.
.IP "\fB\-height\fR \fI\s-1HEIGHT\s0\fR" 4
.IX Item "-height HEIGHT"
Use the \fB\-height\fR option to specify the value of the applet tag
\&\fI\s-1HEIGHT\s0\fR attribute.
.IP "\fB\-param\fR \fI\s-1NAME\s0\fR\fB,\fR\fI\s-1VALUE\s0\fR" 4
.IX Item "-param NAME,VALUE"
Use the \fB\-param\fR option to specify values for the \fI\s-1NAME\s0\fR
and \fI\s-1VALUE\s0\fR attributes of an applet \s-1PARAM\s0 tag.
.PP
\&\s-1PLUGIN OPTION\s0
.IP "\fB\-plugin\fR \fI\s-1INPUT\s0\fR\fB,\fR\fI\s-1OUTPUT\s0\fR" 4
.IX Item "-plugin INPUT,OUTPUT"
\&\fBgcjwebplugin\fR uses the \fB\-plugin\fR option to specify the
named pipe the \fBappletviewer\fR should use for receiving commands
(\fI\s-1INPUT\s0\fR) and the one it should use for sending commands to
\&\fBgcjwebplugin\fR (\fI\s-1OUTPUT\s0\fR).
.PP
\&\s-1DEBUGGING OPTION\s0
.IP "\fB\-verbose\fR" 4
.IX Item "-verbose"
Use the \fB\-verbose\fR option to have the \fBappletviewer\fR print
debugging messages.
.PP
\&\s-1STANDARD OPTIONS\s0
.IP "\fB\-help\fR" 4
.IX Item "-help"
Use the \fB\-help\fR option to have the \fBappletviewer\fR print a
usage message, then exit.
.IP "\fB\-version\fR" 4
.IX Item "-version"
Use the \fB\-version\fR option to have the \fBappletviewer\fR print
its version, then exit.
.IP "\fB\-J\fR\fI\s-1OPTION\s0\fR" 4
.IX Item "-JOPTION"
Use the \fB\-J\fR option to pass \fI\s-1OPTION\s0\fR to the virtual machine that
will run the \fBappletviewer\fR.  Unlike other options, there must
not be a space between the \fB\-J\fR and \fI\s-1OPTION\s0\fR.
.SH "BUGS"
.IX Header "BUGS"
.SH "SEE ALSO"
.IX Header "SEE ALSO"
.SH "AUTHOR"
.IX Header "AUTHOR"