Omni Systems, Inc.   Mif2Go User's Guide, Version 55


11 Generating JavaHelp or Oracle Help > 11.6 Creating and viewing a Java Archive (JAR) file > 11.6.2 Viewing a JAR file

11.6.2 Viewing a JAR file

To view a JavaHelp JAR file (for example, myproj.jar):

1. Open a Command Prompt window.

2. Navigate to the directory where java.exe is located (see §11.3.5 Establishing a JavaHelp environment).

3. Execute the following command (which must be all on one line):

java -jar path\to\hsviewer.jar -helpset path\to\myproj.jar

You can include navigation and execution commands in a .bat file for convenience. For example:

cd C:\Program Files\Java\j2re1.4.2_03\bin

java -jar G:\jh20\demos\bin\hsviewer.jar -helpset g:\jh\myproj.jar

JAR files might have broken links

If your document includes cross references or hypertext links that contain file names that do not match the case of the target file name, the links will not work when you view the JAR file. You can correct this problem either of the following ways:

On Windows you can get around the case mismatch problem by viewing the .hs file instead of the .jar file.

Viewing an Oracle Help JAR file is problematic

Although creating a JAR file for an Oracle Help project appears to work correctly, at Omni Systems we have not succeeded in viewing the resulting JAR file on Windows. On the other hand, Oracle Help .hs files can be viewed successfully on Windows.

See also:

§11.3.6 Establishing an Oracle Help environment.