Skip to main content

RE: [JAVAHELP] Trying static merge

No replies
Anonymous

Sure, whenever the helpset is switched the JH browser either updates with the new helpset or a new JH browser is opened .

The documentation is stored in a directory called 'doc'. It has the structure of:
doc///
config/
html/*.html
images/*.gif

The config directory is where the .hs, .jhm, TOC, index, and Search directory are located.

Each language directory can contain 1 or more helpsets and the helpsets can reference documentation in another helpset (within the same language directory). I believe they are using relative links now in the html files.... There is no cross-linking between helpsets in the config files (.hs,.jhm,TOC,...) that I know of, only through the content pane.

The calling application sets the classpath to the directory above where 'doc' lives. So if the application is installed in 'C:\Program Files\app', then the 'doc' directory lives in 'app' and 'C:\Program Files\app' is added to the classpath. This main directory, 'app', is where the Jars and other directories necessary for the application live.

The calling application can find the helpsets by using a little helper Java class that builds the path to the helpset file and brings up the JH browser for them. And, it builds the path to the helpset file by using the classpath and the helpset name the developer passes in. Since all of our JavaHelp directories have the structure above, it is pretty easy to build the full path.

As you can see, trying to Jar each helpset, the language directory, or even the whole doc directory is just not feasible without a lot of work.

-----Original Message-----
From: Roger Brinkley [mailto:Roger.Brinkley@SUN.COM]
Sent: Tuesday, November 25, 2003 12:19 PM
To: JAVAHELP-INTEREST@JAVA.SUN.COM
Subject: Re: [JAVAHELP] Trying static merge

David Cagle wrote:
> Roger, Do you have any words of wisdom for people that cross-link
> helpsets that are not merged? Our helpsets are separate entities but
> do reference documentation from each other. Any words of advice
> besides don't do it?

Don't do it is my first reaction, but if you understand the contraints there are ways around it. Give me some additonal details how the non-merged help works. What happens when you switch from one helpset to another. Is there any way that you might have access to the other helpset objects?

Binky

********************************************************************************

You may leave the list at any time by sending message with no subject and "SIGNOFF JAVAHELP-INTEREST" in the body to LISTSERV@JAVA.SUN.COM. Archives are available at http://archives.java.sun.com/archives/javahelp-interest.html.
Submit bug reports at http://java.sun.com/cgi-bin/bugreport.cgi.

********************************************************************************

You may leave the list at any time by sending message with no subject and
"SIGNOFF JAVAHELP-INTEREST" in the body to LISTSERV@JAVA.SUN.COM. Archives
are available at http://archives.java.sun.com/archives/javahelp-interest.html.
Submit bug reports at http://java.sun.com/cgi-bin/bugreport.cgi.