Skip to main content

[JAVAHELP] Encoding of the .hs file

3 replies [Last post]
Anonymous

Can the encoding of the .hs file be anything other than ISO-8859-1? Is
ISO-8859-1 commonly referred to as "PC encoding" or does PC encoding
describe a lot of other encoding values as well?

Here is the question that I received:
Is it a Sun requirement that the javahelp .hs file be in PC encoding?

Finally, if we do change the encoding for the .hs file, are the other
control files (.jhm, .xml) alright to change too or do they have
restricitons?

Thanks for the help!

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

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.
David Cagle

Thank you Stephan and Binky, the replies were very helpful!

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

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.

Roger Brinkley

David Cagle wrote:

> Can the encoding of the .hs file be anything other than ISO-8859-1? Is
> ISO-8859-1 commonly referred to as "PC encoding" or does PC encoding
> describe a lot of other encoding values as well?

Yes it can be somthing other than ISO-8859-1. I think what they mean by
PC encoding is the various Microsoft encodings. The list of supported
encodings is at

http://java.sun.com/j2se/1.3/docs/guide/intl/encoding.doc.html

> Here is the question that I received:
> Is it a Sun requirement that the javahelp .hs file be in PC encoding?

No it is not a requirement from the JavaHelp specification in JSR-97
that the helpset file be in PC encoding.

> Finally, if we do change the encoding for the .hs file, are the other
> control files (.jhm, .xml) alright to change too or do they have
> restricitons?

Same as the helpset file. See the internationalization section in JHUG
for more details.

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.

Stephan Schlecht

David,

The .hs is a XML file. Therefore every valid XML encoding is allowed,
e.g. to use UTF-8 the first line of the xml file should look like:

There are different "PC encodings", e.g. Windows-Latin-1 is one of them.
ISO-8859-1 is an internationally standardized encoding. Most of the
characters are the same, but there are some differences to Windows-Latin-1
(e.g. the ISO 8859-1 encoding has no characters defined between the
positions 128 - 159).

In the context of creating XML or HTML files, I guess the ISO-8859-1
encoding is meant. To be sure, ask what is meant with a "PC encoding".

Therefore the answers to your questions:
>Is it a Sun requirement that the javahelp .hs file be in PC encoding?
No.

>Finally, if we do change the encoding for the .hs file, are the other
>control files (.jhm, .xml) alright to change too or do they have
>restricitons?

Actually the files can have different encodings in different XML or
HTML files in JavaHelp without any problems.

Hope this helps,

Stephan
--
Software 7 GmbH
*** Helen 1.5, the JavaHelp Authoring Tool ***
http://www.software7.biz

At 16:15 20.10.2004, David Cagle wrote:
>Can the encoding of the .hs file be anything other than ISO-8859-1? Is
>ISO-8859-1 commonly referred to as "PC encoding" or does PC encoding
>describe a lot of other encoding values as well?
>
>Here is the question that I received:
>Is it a Sun requirement that the javahelp .hs file be in PC encoding?
>
>Finally, if we do change the encoding for the .hs file, are the other
>control files (.jhm, .xml) alright to change too or do they have
>restricitons?

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

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.