Skip to main content

[JAVAHELP] Some notes about JavaHelp 2 rc

2 replies [Last post]
Anonymous

Hello,
I know I'm writing about a release candidate version, but there are some
issues which make uncomfortable and
time comsuming the use of JavaHelp2.

A. from jhug.pdf, page 48
-----------------------8<-------------------------
The format of the map file is based on the World Wide Web Consortium
Extended Markup Language (XML).
The following code listing is an example of a short map file:
<?xml version='1.0' encoding='ISO-8859-1' ?>

[...]

------------------------>8------------------------
This doesn't work for almost four reasons:
1. The parser (predefined in JavaHelp 2) doesn't know that XML permits
single quote around attributes.
2. The identifier "-//Sun Microsystems Inc.//DTD JavaHelp Map Version
2.0//EN" is totally missknown to the JavaHelp parser, this parser recognizes
only "-//Sun Microsystems Inc.//DTD JavaHelp Map Version 1.0//EN" as
defined in class
FlatMap.
3. mapID elements cannot be nested (as defined in map_2_0.dtd).
4. there isn't an available DTD from
"http://java.sun.com/products/javahelp/map_2_0.dtd"

B. The "image" element of "presentation" isn't documented. This is really
odd, because this element solves a common problem: "How can I change the
window icon?"

C. The parser, I'm not very fond of it, is _really_ sparing of warning or
error messages.

Best regards,
Paolo Vercesi

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

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.

Reply viewing options

Select your preferred way to display the comments and click "Save settings" to activate your changes.
Roger Brinkley

Paolo Vercesi wrote:
> Hello,
> I know I'm writing about a release candidate version, but there are some
> issues which make uncomfortable and
> time comsuming the use of JavaHelp2.
>
> A. from jhug.pdf, page 48
> -----------------------8<-------------------------
> The format of the map file is based on the World Wide Web Consortium
> Extended Markup Language (XML).
> The following code listing is an example of a short map file:
>
> > PUBLIC "-//Sun Microsystems Inc.//DTD JavaHelp Map Version 2.0//EN"
> "http://java.sun.com/products/javahelp/map_2_0.dtd">
>
>
>
>
>
> [...]
>
> ------------------------>8------------------------
> This doesn't work for almost four reasons:
> 1. The parser (predefined in JavaHelp 2) doesn't know that XML permits
> single quote around attributes.

File a bug.

> 2. The identifier "-//Sun Microsystems Inc.//DTD JavaHelp Map Version
> 2.0//EN" is totally missknown to the JavaHelp parser, this parser recognizes
> only "-//Sun Microsystems Inc.//DTD JavaHelp Map Version 1.0//EN" as
> defined in class
> FlatMap.

Fixed in the final release of V2.0

> 3. mapID elements cannot be nested (as defined in map_2_0.dtd).

Incorrect in the dtd. File a bug.

> 4. there isn't an available DTD from
> "http://java.sun.com/products/javahelp/map_2_0.dtd"

Will be when V2.0 releases. In the meantime use the ones in
javahelp/lib/dtd. They are the same.

> B. The "image" element of "presentation" isn't documented. This is really
> odd, because this element solves a common problem: "How can I change the
> window icon?"

It's in the RC2 JHUG and the V2.0 JavaHelp Specification.

> C. The parser, I'm not very fond of it, is _really_ sparing of warning or
> error messages.

Submit an RFC with specific changes that you'd like to see.

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.

John Cornellier

I'm delivering my helpset as a jar, but I'd like to get more compression. The jar only seems to be half the size of the source, which is almost all ASCII.

Is there a switch to increase the compression factor? My HAT is Helen.

Thanks and have a good weekend,
John Cornellier

/usrk0/cornelli/ir > du -k *
53 ir_doc/JavaHelpSearch
24 ir_doc/.xvpics
285 ir_doc
128 ir_doc.jar
13305 src/os
605 src/img
142502 src

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

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.