These notes comprise other information collected during the course of development of the JavaHelp/JWS launch examples. They might be of interest or use to other developers.
A quick overview of the dependencies of the various demo/help archives supplied with JavaHelp - taken from the manifest files. The ** denotes runtime arguments.
hsviewer jh apiviewer ** -helpset api jh ./hsviewer classviewer jsjar/apidoc object ** -helpset Object.hs jh ./hsviewer hsjar/object UserGuide ** -helpset jhug.hs jh ./hsviewer doc/jhug/ idedemo * Localised jh classviewer hsjar/idehelp hsjar/idehelp_de hsjar/idehelp_en hsjar/idehelp_ja hsjar/apidoc jhsearch command line jhall jhindexer command line jhall
Note that jhall.jar only seems to be used by the command line based tools. Since JWS is unsuited to running CLI based tools, there is no reason to supply it as a component for JWS launch.
The following properties are regarded as being 'safe' and are thereby usable even in sandboxed applications. The indented options are related to more specific things than are needed in our launch.
The
locationByPlatform property is quite handy for HelpSets launched using
HelpSetter. Normally HelpSets might be displayed within a
HelpViewer that is directly controllable by the application, so the app. can
set the window size and location most appropriate to the location of the
app. or the app. component that called it to screen. For that reason, many
HelpSets do not bother to specify window location. By invoking the
locationByPlatform
property, and opening the HelpViewer as the initial window, we can
get it to open 'wherever is logical for the next window'.
sun.java2d.noddraw, javaws.cfg.jauthenticator, http.agent, http.keepAlive, sun.awt.noerasebackground, sun.java2d.opengl, sun.java2d.d3d, java.awt.syncLWRequests, awt.useSystemAAFontSettings, sun.java2d.dpiaware, java.awt.Window.locationByPlatform, // only property used in these examples sun.awt.erasebackgroundonresize, swing.useSystemFontSettings, swing.noxp, swing.boldMetal, javax.swing.defaultlf, swing.metalTheme,
These pages represent a project aimed at getting JWS hosting of JavaHelp, at the JavaHelp home site. They are made in the form they might eventually appear at the JavaHelp site, and as such, sometimes give false or misleading information.
Note to JavaHelp content developers:
Remove this message from src/conf/fragments/html.page.bottom.htmlf
before generating the build for the JavaHelp site proper!
JavaHelp ® TM of
Sun Microsystems, Inc.
JWS deployment/web pages brought to you by
Andrew Thompson of
PSCode.org.