appletviewer(1)						       appletviewer(1)



NNAAMMEE
       appletviewer - Java applet viewer

SSYYNNOOPPSSIISS
       aapppplleettvviieewweerr [ --ddeebbuugg ] [ --eennccooddiinngg _e_n_c_o_d_i_n_g___n_a_m_e ]
	    [ --JJ _j_a_v_a_o_p_t_i_o_n ] _u_r_l_s ...

DDEESSCCRRIIPPTTIIOONN
       The  aapppplleettvviieewweerr  command runs Java(tm) applets outside of the context
       of a World Wide Web browser.

       The aapppplleettvviieewweerr command connects to  the  document(s)  or  resource(s)
       designated by _u_r_l_s and displays each applet referenced by that document
       in its own window.  Notice that if the documents referred to by _u_r_l_s do
       not  reference  any  applets  with  the	OOBBJJEECCTT,	 EEMMBBEEDD, or AAPPPPLLEETT tag,
       aapppplleettvviieewweerr does nothing.

   aapppplleettvviieewweerr TTaaggss
       The aapppplleettvviieewweerr makes it possible to run a Java applet without using a
       browser.	  aapppplleettvviieewweerr	ignores any HTML that is not immediately rele-
       vant to launching an applet.  However, it recognizes a wide variety  of
       applet-launching syntax.	 The HTML code that appletviewer recognizes is
       shown below.  All other HTML code is ignored.

       oobbjjeecctt	 The oobbjjeecctt tag is the HTML 4.0 tag for embedding applets  and
		 multimedia objects into an HTML page.	It is also an Internet
		 Explorer 4.x extension to HTML 3.2 which allows IE to	run  a
		 Java applet using the latest Java plugin from Sun.

		  <<oobbjjeecctt
		    wwiiddtthh==""ppiixxeellWWiiddtthh""
		    hheeiigghhtt==""ppiixxeellHHeeiigghhtt""
		  >>
		    <<ppaarraamm nnaammee==""ccooddee"" vvaalluuee==""yyoouurrCCllaassss..ccllaassss"">>
		    <<ppaarraamm nnaammee==""oobbjjeecctt"" vvaalluuee==""sseerriiaalliizzeeddOObbjjeeccttOOrrJJaavvaaBBeeaann"">>
		    <<ppaarraamm nnaammee==""ccooddeebbaassee"" vvaalluuee==""ccllaassssFFiilleeDDiirreeccttoorryy"">>
		    ......
		    aalltteerrnnaattee--tteexxtt
		 <<//oobbjjeecctt>>

		 Please notice that:

		 +o aapppplleettvviieewweerr	  ignores  the	"classID"  attribute,  on  the
		   assumption that it is pointing to the Java plugin, with the
		   value:

		   ccllaassssiidd==""ccllssiidd::88AADD99CC884400--004444EE--1111DD11--BB33EE99--0000880055FF449999DD9933""

		 +o aapppplleettvviieewweerr	 also ignores the "codebase" attribute that is
		   usually included as part of the oobbjjeecctt tag,	assuming  that
		   it  points  to  a  Java plugin in a network cab file with a
		   value like:

		   ccooddeebbaassee==""hhttttpp::////jjaavvaa..ssuunn..ccoomm//pprroodduuccttss//pplluuggiinn//11..11//jjiinnssttaallll--1111--wwiinn3322..ccaabb##VVeerrssiioonn==11,,11,,00,,00""

		 +o The optional codebase ppaarraamm tag  supplies  a	 relative  URL
		   that specifies the location of the applet class.

		 +o Either ccooddee or oobbjjeecctt is specified, not both.

		 +o The	type ppaarraamm tag is not used by aapppplleettvviieewweerr, but should
		   be present so that browsers load the plugin properly.   For
		   an applet, the value should be something like:

		     <<ppaarraamm nnaammee==""ttyyppee""
		     vvaalluuee==""aapppplliiccaattiioonn//xx--jjaavvaa--aapppplleett;;vveerrssiioonn==11..11"">>

		   or

		     <<ppaarraamm nnaammee==""ttyyppee"" vvaalluuee==""aapppplliiccaattiioonn//xx--jjaavvaa--aapppplleett"">>

		   For	a  serialized object or JavaBean, the type ppaarraamm value
		   should be something like:

		     <<ppaarraamm nnaammee==""ttyyppee""
		      vvaalluuee==""aapppplliiccaattiioonn//xx--jjaavvaa--bbeeaann;;vveerrssiioonn==11..11"">>

		   or

		     <<ppaarraamm nnaammee==""ttyyppee"" vvaalluuee==""aapppplliiccaattiioonn//xx--jjaavvaa--bbeeaann"">>

		 +o Other ppaarraamm	tags  are  argument  values  supplied  to  the
		   applet.

		 +o The oobbjjeecctt tag recognized by IE4.x and the embed tag recog-
		   nized by Netscape 4.x can be combined so that an applet can
		   use	the  latest  Java  plugin  from Sun, regardless of the
		   browser that downloads the applet.

		 +o aapppplleettvviieewweerr does not recognize the	jjaavvaa__ccooddee,  jjaavvaa__ccooddee--
		   bbaassee,  jjaavvaa__oobbjjeecctt, or jjaavvaa__ttyyppee ppaarraamm tags. These tags are
		   only needed when the applet	defines	 parameters  with  the
		   names  ccooddee,	 ccooddeebbaassee,  oobbjjeecctt, or ttyyppee, respectively. (In
		   that situation, the plugin recognizes and  uses  the	 jjaavvaa__
		   version  in	preference to the version that will be used by
		   the applet.)	 If the applet requires a parameter  with  one
		   of these four names, it may not run in aapppplleettvviieewweerr.

       eemmbbeedd	 The  eemmbbeedd  tag  is  the  Netscape extension to HTML 3.2 that
		 allows embedding an applet or a multimedia object in an  HTML
		 page.	 It allows a Netscape 4.x browser (which supports HTML
		 3.2) to run a Java applet using the latest Java  plugin  from
		 Sun.

		   <<eemmbbeedd
		     ccooddee==""yyoouurrCCllaassss..ccllaassss""
		     oobbjjeecctt==""sseerriiaalliizzeeddOObbjjeeccttOOrrJJaavvaaBBeeaann""
		     ccooddeebbaassee==""ccllaassssFFiilleeDDiirreeccttoorryy""
		     wwiiddtthh==""ppiixxeellWWiiddtthh""
		     hheeiigghhtt==""ppiixxeellHHeeiigghhtt""
		   >>
		   ......
		   <<//eemmbbeedd>>

		 Please notice that:

		 +o The oobbjjeecctt and eemmbbeedd tags can be combined so that an applet
		   can use the latest Java plugin from Sun, regardless of  the
		   browser  that  downloads the applet.	 For more information,
		   see the Java PlugIn HTML Specification

		 +o Unlike the oobbjjeecctt tag, all values specified in an eemmbbeedd tag
		   are	attributes  (part  of  the tag) rather than parameters
		   (between the ssttaarrtt tag and eenndd tag, specified with a	 ppaarraamm
		   tag.

		 +o To  supply  argument	 values for applet parameters, you add
		   additional attributes to the eemmbbeedd tag.

		 +o aapppplleettvviieewweerr ignores the "src" attribute  that  is  usually
		   part of an eemmbbeedd tag.

		 +o Either ccooddee or oobbjjeecctt is specified, not both.

		 +o The	optional  ccooddeebbaassee  attribute  supplies a relative URL
		   that specifies the location of the applet class.

		 +o The ttyyppee attribute is not used by aapppplleettvviieewweerr, but	should
		   be  present so that browsers load the plugin properly.  For
		   an applet, the value should be something like:
		     <<ttyyppee==""aapppplliiccaattiioonn//xx--jjaavvaa--aapppplleett;;vveerrssiioonn==11..11"">>......

		   or

		     <<ttyyppee==""aapppplliiccaattiioonn//xx--jjaavvaa--aapppplleett"">>......

		   For a serialized object or JavaBean, the type  param	 value
		   should be something like:

		     <<ttyyppee==""aapppplliiccaattiioonn//xx--jjaavvaa--bbeeaann;;vveerrssiioonn==11..11"">>......

		   or

		     <<ttyyppee==""aapppplliiccaattiioonn//xx--jjaavvaa--bbeeaann"">>......

		 +o The	pplluuggiinnssppaaggee attribute is not used by aapppplleettvviieewweerr, but
		   should be present so that browsers load  the	 plugin	 prop-
		   erly.   It  should  point to a Java plugin in a network cab
		   file with a value like:

		 pplluuggiinnssppaaggee==""hhttttpp::////jjaavvaa..ssuunn..ccoomm//pprroodduuccttss//pplluuggiinn//11..11//jjiinnssttaallll--1111--wwiinn3322..ccaabb##VVeerrssiioonn==11,,11,,00,,00""

       aapppplleett	 The aapppplleett tag is the original HTML 3.2 tag for embedding  an
		 applet	 in an HTML page.  Applets loaded using the aapppplleett tag
		 are run by the browser, which may not	be  using  the	latest
		 version of the Java platform.	To ensure that the applet runs
		 with the latest version, use the oobbjjeecctt tag to load the  Java
		 plugin into the browser. The plugin will then run the applet.

		   <<aapppplleett
		     ccooddee==""yyoouurrCCllaassss..ccllaassss""
		     oobbjjeecctt==""sseerriiaalliizzeeddOObbjjeeccttOOrrJJaavvaaBBeeaann""
		     ccooddeebbaassee==""ccllaassssFFiilleeDDiirreeccttoorryy""
		     wwiiddtthh==""ppiixxeellWWiiddtthh""
		     hheeiigghhtt==""ppiixxeellHHeeiigghhtt""
		   >>
		     <<ppaarraamm nnaammee==""......"" vvaalluuee==""......"">>
		     ......
		     aalltteerrnnaattee--tteexxtt
		   <<//aapppplleett>>

		 Please notice that:

		 +o Either ccooddee or oobbjjeecctt is specified, not both.

		 +o The optional ccooddeebbaassee attribute  supplies  a	 relative  URL
		   that specifies the location of the applet class.

		 +o ppaarraamm tags supply argument values for applet parameters.

       aapppp	 The aapppp tag was a short-lived abbreviation for applet that is
		 no longer supported.  aapppplleettvviieewweerr  translates	 the  tag  and
		 prints out an equivalent tag that is supported.

		   <<aapppp
		     ccllaassss==""ccllaassssFFiilleeNNaammee"" ((wwiitthhoouutt aa ..ccllaassss ssuuffffiixx))
		     ssrrcc==""ccllaassssFFiilleeDDiirreeccttoorryy""
		     wwiiddtthh==""ppiixxeellWWiiddtthh""
		     hheeiigghhtt==""ppiixxeellHHeeiigghhtt""
		   >>
		     <<ppaarraamm nnaammee==""......"" vvaalluuee==""......"">>
		     ......
		   <<//aapppp>>

OOPPTTIIOONNSS
       The following options are supported:

       --ddeebbuugg	 Starts	 the  applet viewer in the Java debugger, which debugs
		 applets in the document.  (See jjddbb(1).)

       --eennccooddiinngg _e_n_c_o_d_i_n_g___n_a_m_e
		 Specifies the input HTML file encoding name.

       --JJ _j_a_v_a_o_p_t_i_o_n
		 Passes the string _j_a_v_a_o_p_t_i_o_n through as a single argument  to
		 jjaavvaa(1)  which	 runs  the  compiler.  The argument should not
		 contain spaces.  Multiple argument words must all begin  with
		 the prefix --JJ, which is stripped.  This is useful for adjust-
		 ing the execution environment or compiler memory usage.










































EEXXAAMMPPLLEESS
       The argument passed to aapppplleettvviieewweerr can be a file or an http url:

	    eexxaammppllee%% aapppplleettvviieewweerr hhttttpp::////jjaavvaa..ssuunn..ccoomm//aapppplleettss//jjddkk//11..22//ddeemmoo//aapppplleettss//AArrccTTeesstt//eexxaammppllee11..hhttmmll
	    eexxaammppllee%% aapppplleettvviieewweerr ffiillee:://////DDeevveellooppeerr//EExxaammpplleess//JJaavvaa//AApppplleettss//AArrccTTeesstt//eexxaammppllee11..hhttmmll


SSEEEE AALLSSOO
       jjaavvaa(1), jjddbb(1)

       For more information, see

       http://java.sun.com/j2se/1.4.1/docs/guide/plugin/devel-
       oper_guide/index.html

       or search jjaavvaa..ssuunn..ccoomm for "Java Plug-In HTML Specification"



				 14 July 2000		       appletviewer(1)
