Hi,
I added to tools.texinfo an Applet Tools chapter containing appletviewer
and gcjwebplugin sections.
Tom
2006-06-11 Thomas Fitzsimmons <[EMAIL PROTECTED]>
* doc/tools.texinfo
(Applet Tools): New chapter.
(appletviewer Tool): New section.
(gcjwebplugin): New section.
Index: doc/tools.texinfo
===================================================================
RCS file: /sources/classpath/classpath/doc/tools.texinfo,v
retrieving revision 1.3
diff -u -r1.3 tools.texinfo
--- doc/tools.texinfo 11 Jun 2006 10:40:51 -0000 1.3
+++ doc/tools.texinfo 12 Jun 2006 00:58:06 -0000
@@ -40,7 +40,7 @@
@contents
@ifinfo
[EMAIL PROTECTED] Top, Security Tools, (dir), (dir)
[EMAIL PROTECTED] Top, Applet Tools, (dir), (dir)
@top GNU Classpath Tools Guide
This document contains important information you need to know in order to use
@@ -53,12 +53,18 @@
@end ifinfo
@menu
+* Applet Tools:: Work with applets
* Security Tools:: Work securely with Java applications
* I18N Issues:: How to add support for non-English languages
@detailmenu
--- The Detailed Node Listing ---
+Applet Tools
+
+* appletviewer Tool:: Load applets
+* gcjwebplugin:: Load applets in a web browser
+
Security Tools
* jarsigner Tool:: Sign and verify .JAR files
@@ -115,7 +121,150 @@
@comment ----------------------------------------------------------------------
[EMAIL PROTECTED] Security Tools, I18N Issues, Top, Top
[EMAIL PROTECTED] Applet Tools, Security Tools, Top, Top
[EMAIL PROTECTED] node-name, next, previous, up
[EMAIL PROTECTED] Applet Tools
+
+Two Applet Tools are available with GNU Classpath: @b{appletviewer}
+and @b{gcjwebplugin}.
+
[EMAIL PROTECTED]
+* appletviewer Tool:: Load applets
+* gcjwebplugin:: Load applets in a web browser
[EMAIL PROTECTED] menu
+
+If while using these tools you think you found a bug, then please report it at @uref{http://www.gnu.org/software/classpath/bugs.html,classpath-bugs}.
+
[EMAIL PROTECTED] ----------------------------------------------------------------------
+
[EMAIL PROTECTED] appletviewer Tool, gcjwebplugin, Applet Tools, Applet Tools
[EMAIL PROTECTED] node-name, next, previous, up
[EMAIL PROTECTED] The @code{appletviewer} Tool
+
[EMAIL PROTECTED] @b
+
[EMAIL PROTECTED] SYNOPSIS
[EMAIL PROTECTED] [OPTION]... [EMAIL PROTECTED]
[EMAIL PROTECTED] [OPTION]... -code [EMAIL PROTECTED]
[EMAIL PROTECTED] [OPTION]... -plugin INPUT,OUTPUT}
+
[EMAIL PROTECTED] DESCRIPTION
+The @code{appletviewer} tool loads and runs an applet.
+
+Use the first form to test applets specified by tag. The URL should
+resolve to an HTML document from which the @code{appletviewer} will
+extract applet tags. The APPLET, EMBED and OBJECT 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 @code{appletviewer} does nothing.
+
[EMAIL PROTECTED]
[EMAIL PROTECTED] http://www.gnu.org/software/classpath/}
[EMAIL PROTECTED] example
+
+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 @code{-code} option. The
[EMAIL PROTECTED] option overrides the URL form -- any URLs specified will
+be ignored.
+
[EMAIL PROTECTED]
[EMAIL PROTECTED] -code Test.class -param datafile,data.txt}
[EMAIL PROTECTED] example
+
[EMAIL PROTECTED] uses the third form to communicate with the
[EMAIL PROTECTED] through named pipes.
+
[EMAIL PROTECTED] URL OPTIONS
[EMAIL PROTECTED] @b
[EMAIL PROTECTED] -debug
+This option is not yet implemented but is provided for compatibility.
+
[EMAIL PROTECTED] -encoding CHARSET
+Use this option to specify an alternate character encoding for the
+specified HTML page.
+
[EMAIL PROTECTED] table
+
[EMAIL PROTECTED] APPLET TAG OPTIONS
[EMAIL PROTECTED] @b
[EMAIL PROTECTED] -code CODE
+Use the @code{-code} option to specify the value of the applet tag
+CODE attribute.
+
[EMAIL PROTECTED] -codebase CODEBASE
+Use the @code{-codebase} option to specify the value of the applet tag
+CODEBASE attribute.
+
[EMAIL PROTECTED] -archive ARCHIVE
+Use the @code{-archive} option to specify the value of the applet tag
+ARCHIVE attribute.
+
[EMAIL PROTECTED] -width WIDTH
+Use the @code{-width} option to specify the value of the applet tag
+WIDTH attribute.
+
[EMAIL PROTECTED] -height HEIGHT
+Use the @code{-height} option to specify the value of the applet tag
+HEIGHT attribute.
+
[EMAIL PROTECTED] -param NAME,VALUE
+Use the @code{-param} option to specify values for the NAME and VALUE
+attributes of an applet PARAM tag.
+
[EMAIL PROTECTED] table
+
[EMAIL PROTECTED] PLUGIN OPTION
[EMAIL PROTECTED] @b
[EMAIL PROTECTED] -plugin INPUT,OUTPUT
[EMAIL PROTECTED] uses the @code{-plugin} option to specify the
+named pipe the @code{appletviewer} should use for receiving commands
+(INPUT) and the one it should use for sending commands to
[EMAIL PROTECTED] (OUTPUT).
+
[EMAIL PROTECTED] table
+
[EMAIL PROTECTED] DEBUGGING OPTION
[EMAIL PROTECTED] @b
[EMAIL PROTECTED] -verbose
+Use the @code{-verbose} option to have the @code{appletviewer} print
+debugging messages.
+
[EMAIL PROTECTED] table
+
[EMAIL PROTECTED] STANDARD OPTIONS
[EMAIL PROTECTED] @b
[EMAIL PROTECTED] -help
+Use the @code{-help} option to have the @code{appletviewer} print a
+usage message, then exit.
+
[EMAIL PROTECTED] -version
+Use the @code{-version} option to have the @code{appletviewer} print
+its version, then exit.
+
[EMAIL PROTECTED] -JOPTION
+Use the @code{-J} option to pass OPTION to the virtual machine that
+will run the @code{appletviewer}. Unlike other options, there must
+not be a space between the -J and OPTION.
+
[EMAIL PROTECTED] table
[EMAIL PROTECTED] table
+
[EMAIL PROTECTED] ----------------------------------------------------------------------
+
[EMAIL PROTECTED] gcjwebplugin, , appletviewer Tool, Applet Tools
[EMAIL PROTECTED] node-name, next, previous, up
[EMAIL PROTECTED] The @code{gcjwebplugin} Tool
+
[EMAIL PROTECTED] is a plugin that adds applet support to web
+browsers. Currently @code{gcjwebplugin} only supports Mozilla-based
+browsers (e.g., Firefox, Galeon, Mozilla).
+
[EMAIL PROTECTED] ----------------------------------------------------------------------
+
[EMAIL PROTECTED] Security Tools, I18N Issues, Applet Tools, Top
@comment node-name, next, previous, up
@chapter Security Tools
