libjava/classpath/doc/gappletviewer.1

   1 .\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16)
   2 .\"
   3 .\" Standard preamble:
   4 .\" ========================================================================
   5 .de Sp \" Vertical space (when we can't use .PP)
   6 .if t .sp .5v
   7 .if n .sp
   8 ..
   9 .de Vb \" Begin verbatim text
  10 .ft CW
  11 .nf
  12 .ne \\$1
  13 ..
  14 .de Ve \" End verbatim text
  15 .ft R
  16 .fi
  17 ..
  18 .\" Set up some character translations and predefined strings.  \*(-- will
  19 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
  20 .\" double quote, and \*(R" will give a right double quote.  \*(C+ will
  21 .\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
  22 .\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
  23 .\" nothing in troff, for use with C<>.
  24 .tr \(*W-
  25 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
  26 .ie n \{\
  27 .    ds -- \(*W-
  28 .    ds PI pi
  29 .    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
  30 .    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
  31 .    ds L" ""
  32 .    ds R" ""
  33 .    ds C` ""
  34 .    ds C' ""
  35 'br\}
  36 .el\{\
  37 .    ds -- \|\(em\|
  38 .    ds PI \(*p
  39 .    ds L" ``
  40 .    ds R" ''
  41 'br\}
  42 .\"
  43 .\" Escape single quotes in literal strings from groff's Unicode transform.
  44 .ie \n(.g .ds Aq \(aq
  45 .el       .ds Aq '
  46 .\"
  47 .\" If the F register is turned on, we'll generate index entries on stderr for
  48 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
  49 .\" entries marked with X<> in POD.  Of course, you'll have to process the
  50 .\" output yourself in some meaningful fashion.
  51 .ie \nF \{\
  52 .    de IX
  53 .    tm Index:\\$1\t\\n%\t"\\$2"
  54 ..
  55 .    nr % 0
  56 .    rr F
  57 .\}
  58 .el \{\
  59 .    de IX
  60 ..
  61 .\}
  62 .\"
  63 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
  64 .\" Fear.  Run.  Save yourself.  No user-serviceable parts.
  65 .    \" fudge factors for nroff and troff
  66 .if n \{\
  67 .    ds #H 0
  68 .    ds #V .8m
  69 .    ds #F .3m
  70 .    ds #[ \f1
  71 .    ds #] \fP
  72 .\}
  73 .if t \{\
  74 .    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
  75 .    ds #V .6m
  76 .    ds #F 0
  77 .    ds #[ \&
  78 .    ds #] \&
  79 .\}
  80 .    \" simple accents for nroff and troff
  81 .if n \{\
  82 .    ds ' \&
  83 .    ds ` \&
  84 .    ds ^ \&
  85 .    ds , \&
  86 .    ds ~ ~
  87 .    ds /
  88 .\}
  89 .if t \{\
  90 .    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
  91 .    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
  92 .    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
  93 .    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
  94 .    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
  95 .    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
  96 .\}
  97 .    \" troff and (daisy-wheel) nroff accents
  98 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
  99 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
 100 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
 101 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
 102 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
 103 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
 104 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
 105 .ds ae a\h'-(\w'a'u*4/10)'e
 106 .ds Ae A\h'-(\w'A'u*4/10)'E
 107 .    \" corrections for vroff
 108 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
 109 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
 110 .    \" for low resolution devices (crt and lpr)
 111 .if \n(.H>23 .if \n(.V>19 \
 112 \{\
 113 .    ds : e
 114 .    ds 8 ss
 115 .    ds o a
 116 .    ds d- d\h'-1'\(ga
 117 .    ds D- D\h'-1'\(hy
 118 .    ds th \o'bp'
 119 .    ds Th \o'LP'
 120 .    ds ae ae
 121 .    ds Ae AE
 122 .\}
 123 .rm #[ #] #H #V #F C
 124 .\" ========================================================================
 125 .\"
 126 .IX Title "GAPPLETVIEWER 1"
 127 .TH GAPPLETVIEWER 1 "2013-05-31" "0.99.1-pre" "GNU"
 128 .\" For nroff, turn off justification.  Always turn off hyphenation; it makes
 129 .\" way too many mistakes in technical documents.
 130 .if n .ad l
 131 .nh
 132 .SH "NAME"
 133 gappletviewer \- Load and runs an applet
 134 .SH "SYNOPSIS"
 135 .IX Header "SYNOPSIS"
 136 appletviewer [\fI\s-1OPTION\s0\fR]... \fI\s-1URL\s0\fR...
 137 .PP
 138 appletviewer [\fI\s-1OPTION\s0\fR]... \fB\-code\fR \fI\s-1CODE\s0\fR
 139 .PP
 140 appletviewer [\fI\s-1OPTION\s0\fR]... \fB\-plugin\fR \fI\s-1INPUT\s0\fR,\fI\s-1OUTPUT\s0\fR
 141 .SH "DESCRIPTION"
 142 .IX Header "DESCRIPTION"
 143 The \fBappletviewer\fR tool loads and runs an applet.
 144 .PP
 145 Use the first form to test applets specified by tag.  The \s-1URL\s0 should
 146 resolve to an \s-1HTML\s0 document from which the \fBappletviewer\fR will
 147 extract applet tags.  The \s-1APPLET\s0, \s-1EMBED\s0 and \s-1OBJECT\s0 tags are supported.
 148 If a given document contains multiple applet tags, all the applets
 149 will be loaded, with each applet appearing in its own window.
 150 Likewise, when multiple URLs are specified, each applet tag instance
 151 is given its own window.  If a given document contains no recognized
 152 tags the \fBappletviewer\fR does nothing.
 153 .PP
 154 .Vb 1
 155 \&        appletviewer http://www.gnu.org/software/classpath/
 156 .Ve
 157 .PP
 158 Use the second form to test an applet in development.  This form
 159 allows applet tag attributes to be supplied on the command line.  Only
 160 one applet may be specified using the \fB\-code\fR option.  The
 161 \&\fB\-code\fR option overrides the \s-1URL\s0 form \*(-- any URLs specified will
 162 be ignored.
 163 .PP
 164 .Vb 1
 165 \&        appletviewer \-code Test.class \-param datafile,data.txt
 166 .Ve
 167 .PP
 168 \&\fBgcjwebplugin\fR uses the third form to communicate with the
 169 \&\fBappletviewer\fR through named pipes.
 170 .SH "OPTIONS"
 171 .IX Header "OPTIONS"
 172 \&\s-1URL\s0 \s-1OPTIONS\s0
 173 .IP "\fB\-debug\fR" 4
 174 .IX Item "-debug"
 175 This option is not yet implemented but is provided for compatibility.
 176 .IP "\fB\-encoding\fR \fI\s-1CHARSET\s0\fR" 4
 177 .IX Item "-encoding CHARSET"
 178 Use this option to specify an alternate character encoding for the
 179 specified \s-1HTML\s0 page.
 180 .PP
 181 \&\s-1APPLET\s0 \s-1TAG\s0 \s-1OPTIONS\s0
 182 .IP "\fB\-code\fR \fI\s-1CODE\s0\fR" 4
 183 .IX Item "-code CODE"
 184 Use the \fB\-code\fR option to specify the value of the applet tag
 185 \&\fI\s-1CODE\s0\fR attribute.
 186 .IP "\fB\-codebase\fR \fI\s-1CODEBASE\s0\fR" 4
 187 .IX Item "-codebase CODEBASE"
 188 Use the \fB\-codebase\fR option to specify the value of the applet tag
 189 \&\fI\s-1CODEBASE\s0\fR attribute.
 190 .IP "\fB\-archive\fR \fI\s-1ARCHIVE\s0\fR" 4
 191 .IX Item "-archive ARCHIVE"
 192 Use the \fB\-archive\fR option to specify the value of the applet tag
 193 \&\fI\s-1ARCHIVE\s0\fR attribute.
 194 .IP "\fB\-width\fR \fI\s-1WIDTH\s0\fR" 4
 195 .IX Item "-width WIDTH"
 196 Use the \fB\-width\fR option to specify the value of the applet tag
 197 \&\fI\s-1WIDTH\s0\fR attribute.
 198 .IP "\fB\-height\fR \fI\s-1HEIGHT\s0\fR" 4
 199 .IX Item "-height HEIGHT"
 200 Use the \fB\-height\fR option to specify the value of the applet tag
 201 \&\fI\s-1HEIGHT\s0\fR attribute.
 202 .IP "\fB\-param\fR \fI\s-1NAME\s0\fR\fB,\fR\fI\s-1VALUE\s0\fR" 4
 203 .IX Item "-param NAME,VALUE"
 204 Use the \fB\-param\fR option to specify values for the \fI\s-1NAME\s0\fR
 205 and \fI\s-1VALUE\s0\fR attributes of an applet \s-1PARAM\s0 tag.
 206 .PP
 207 \&\s-1PLUGIN\s0 \s-1OPTION\s0
 208 .IP "\fB\-plugin\fR \fI\s-1INPUT\s0\fR\fB,\fR\fI\s-1OUTPUT\s0\fR" 4
 209 .IX Item "-plugin INPUT,OUTPUT"
 210 \&\fBgcjwebplugin\fR uses the \fB\-plugin\fR option to specify the
 211 named pipe the \fBappletviewer\fR should use for receiving commands
 212 (\fI\s-1INPUT\s0\fR) and the one it should use for sending commands to
 213 \&\fBgcjwebplugin\fR (\fI\s-1OUTPUT\s0\fR).
 214 .PP
 215 \&\s-1DEBUGGING\s0 \s-1OPTION\s0
 216 .IP "\fB\-verbose\fR" 4
 217 .IX Item "-verbose"
 218 Use the \fB\-verbose\fR option to have the \fBappletviewer\fR print
 219 debugging messages.
 220 .PP
 221 \&\s-1STANDARD\s0 \s-1OPTIONS\s0
 222 .IP "\fB\-help\fR" 4
 223 .IX Item "-help"
 224 Use the \fB\-help\fR option to have the \fBappletviewer\fR print a
 225 usage message, then exit.
 226 .IP "\fB\-version\fR" 4
 227 .IX Item "-version"
 228 Use the \fB\-version\fR option to have the \fBappletviewer\fR print
 229 its version, then exit.
 230 .IP "\fB\-J\fR\fI\s-1OPTION\s0\fR" 4
 231 .IX Item "-JOPTION"
 232 Use the \fB\-J\fR option to pass \fI\s-1OPTION\s0\fR to the virtual machine that
 233 will run the \fBappletviewer\fR.  Unlike other options, there must
 234 not be a space between the \fB\-J\fR and \fI\s-1OPTION\s0\fR.
 235 .SH "BUGS"
 236 .IX Header "BUGS"
 237 .SH "SEE ALSO"
 238 .IX Header "SEE ALSO"
 239 .SH "AUTHOR"
 240 .IX Header "AUTHOR"