Skip to main content

RE: [JAVAHELP] problems by update content

No replies
Anonymous

Greetings

Well I spoke to soon. While I do not know of any changes made to the
system, I now get the Java message "Helpset not found" Whenever I try to
open a .hs file. The "Set HelpSet..." dialog opens, but even when I
navigate to a HS file, the "Helpset not found" message repeats.

The JAR opens correctly using the same hsviewer.bat, however. What is
going on here?

Israel Dalven
Documentation
CellGlide Ltd.
israeld@cellglide.com
tel. +972 (9) 8858580
cel. +972 (55) 290587

CellGlide is the leading provider of Telco-grade mobile traffic shaping
solutions that enable operators to deliver predictable, reliable, and
billable data services over mobile data networks. Using the CellGlide
GPRS Mobile Traffic Shaper, operators reap immediate ROI benefits by
employing service differentiation, mobile SLAs, rich media streaming,
and other 3G-like services using available 2.5 network infrastructure.

-----Original Message-----
From: Israel Dalven
Sent: Thursday, 11 March, 2004 11:35
To: 'Discussion list of JavaHelp'
Subject: RE: [JAVAHELP] problems by update content

Thanks, I followed the instructions in the User Guide and - well - it
worked!
(My only problem was that I had forgotten how to make a BAT file. Long
gone are the old DOS days.)

Israel Dalven
Documentation
CellGlide Ltd.
israeld@cellglide.com
tel. 09 8858580
cel. 055 290587

CellGlide is the leading provider of Telco-grade mobile traffic shaping
solutions that enable operators to deliver predictable, reliable, and
billable data services over mobile data networks. Using the CellGlide
GPRS Mobile Traffic Shaper, operators reap immediate ROI benefits by
employing service differentiation, mobile SLAs, rich media streaming,
and other 3G-like services using available 2.5 network infrastructure.

-----Original Message-----
From: Paul Fussell [mailto:Paul.Fussell@SUN.COM]
Sent: Wednesday, 10 March, 2004 19:38
To: JAVAHELP-INTEREST@JAVA.SUN.COM
Subject: Re: [JAVAHELP] problems by update content

At 07:59 AM 3/10/2004, Israel Dalven wrote:

How exactly does one run an un-jarred help set in the JH viewer?

Israel Dalven
Documentation
CellGlide Ltd.
israeld@cellglide.com
tel. 09 8858580
cel. 055 290587

This information is in the Javahelp User's Guide:

A helpset viewer is provided with the JavaHelp release to enable you to
view your helpsets. To use it, you need to have both JavaHelp and the
Java 2 Standard Edition (J2SE) installed.

* You can get the latest version of J2SE from
http://java.sun.com/j2se/corejava/index.jsp.

* You can get JavaHelp at http://java.sun.com/products/javahelp/.
It comes as a zipped file that you unzip into a directory. There is no
installation program.

If you are on a Windows system, you can set things up so the JavaHelp
viewer will launch whenever you double-click a .hs (helpset ) file in
the File Explorer. See Displaying
a
Helpset in Windows by Clicking the .hs File for directions.

Running the Viewer from the Command Line

If the path to the java executable file is in your PATH variable, you
can enter the following command in your operating system's command-line
shell to run the helpset viewer (where JavaHelp_home is the JavaHelp
system installation directory):

java -jar JavaHelp_home/demos/bin/hsviewer.jar
1065fd.jpg On a Windows system, you can configure a shortcut to run the
viewer. For example, if your J2SE installation is in C:\j2sdk1.4.1 and
your JavaHelp system installation is in C:\JavaHelp, you can configure
the shortcut as follows:

1. If necessary, create a shortcut on your desktop.

1. Open the file Explorer and navigate to a folder containing an
executable file (for example, c:\j2sdk1.4.1\bin\java.exe).

2. Right-click the file and choose Create Shortcut.

3. Drag the newly created shortcut to your desktop.

2. Right-click the shortcut and choose Properties.

3. In the Shortcut dialog, type the following command in the Target
field:

4. c:\j2sdk1.4.1\bin\java -jar
c://JavaHelp//demos//bin//hsviewer.jar

5. Save the shortcut.

6. You can then double-click the shortcut to open the viewer in the
Java virtual machine.

All helpsets are displayed in the JavaHelp system help viewer-the same
viewer used to provide help in applications.
1065fd.jpg 106675.jpg If you want the viewer to find the default
helpset, add its path to the CLASSPATH system variable.
106675.jpg For the purpose of running the examples, the JRE you use
to run hsviewer does not have to be the same version as the JRE on which
your application is deployed. For example, you can use J2SE 1.4.1 to run
the demo programs (including hsviewer) even if your application is
deployed on J2SE 1.3.1.
106675.jpg For a list of limitations, bugs, and idiosyncrasies that
pertain to the JavaHelp system HTML viewer, see Limitations
and Bugs.
106675.jpg The viewer toolbar does not include a reload button. The
easiest way to reload a file after you change it is to click the
viewer's "previous" and "next" buttons.

Displaying a Helpset with hsviewer.jar

To display a specific helpset, start the helpset viewer hsviewer.jar as
described above. When the viewer opens, either click the Browse button
to navigate to a helpset or, in the URL field, type the full path to the
helpset file. When the helpset has loaded, click Display to view the
helpset in the viewer.

Alternatively, you can specify the helpset by using a command-line
switch with hsviewer.jar. You can do this on the command line itself, in
a batch file, in a script file, in a JAR file, or in a shortcut. The
command-line syntax of the hsviewer.jar command-line interface is:

java -jar hsviewer.jar [-helpset hs_name]

-helpset Specifies the helpset name:
hs_name The full path to a helpset file. For example (on a Windows
system):

C:\> java -jar c:\JavaHelp\demos\bin\hsviewer.jar

-helpset

c:\JavaHelp\demos\hs\newmerge\MergeHelp.hs

Displaying a Helpset in Windows by Clicking the .hs File

In Windows, you can open a file in a program by double-clicking the file
in the Explorer. For example, if you double-click an HTML file, it opens
in your default web browser. This technique works because Windows can
associate a file extension (like .html) with a program that displays the
file. You can use this technique to open a helpset file in the helpset
viewer (hsviewer.jar). Here is how to do it.

1. Create a batch file that runs hsviewer.jar and accepts a
command-line parameter.

2. For example, if the JavaHelp system is installed in c:\JavaHelp
and java.exe is in your PATH, you would put the following line in the
file:

java -jar c://JavaHelp//demos//bin//hsviewer.jar -helpset %1
3. Save the file as hsviewer.bat.

4. Open Windows Explorer, navigate to a directory containing a
helpset (.hs) file, and double-click the file.

5. Windows displays the Open With dialog, which enables you to
associate the helpset file with a program that opens the file.

6. Click the Other button, navigate to the directory where you
saved the hsviewer.bat file, and choose that file as the one that will
open .hs files.

7. Click OK in the Open With dialog.

8. The helpset opens in the helpset viewer.

9. In the future, when you double-click a helpset file in the
Explorer, it will open in the helpset viewer.

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

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.
[att1.html]