Skip to main content

RE: [JAVAHELP] Trying static merge

2 replies [Last post]
Anonymous

Per,
We link from helpset to helpset in our documentation and it has caused great pains for installation, development, and authors. As Roger has stated, it is very hard to get linking from Jar to Jar working successfully and is one of the reasons why we do not Jar our JavaHelp files. And since we do not Jar our files, our documentation base is huge. Looking back, I wish we would not have allowed the authors to crosslink helpsets...it has caused great pains for us.

Just my 2 cents though!

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

Per Lundkvist wrote:
> Hmm ok so is it possible to link to a file in another JAR-file if just
> the CLASSPATH etc. is correct, or is it not possible at all?

In theory it is NOT possible. In practice you get lucky when the moon is positioned at the 12 hour and Mars is in perfect alignment with the earth (in otherwords, occassionally).

> My JAR-files when they are in our software are in the same folder, and
> that folder is pointed out as folder where to look for classes in. So
> for links in files in B.jar I have to have links as "../A/a_file.htm"
> (where a_file.htm is in the A.jar-file), correct?

No...you would have to refer to A.jar somehow. The above reference points a directory A which if you jarred A doesn't exist.

In generally it is a really bad practice to refer to a content file outside it's helpset. If it works you're lucky!!

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.

Reply viewing options

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

The helpsets for the Sun ONE Studio products are merged, and we do have
cross references to topics in different helpsets, but that's because the
Netbeans core that these products are built on ensures that the links work
(we do all our linking to JavaHelp topics through an API layer in the core
product). So, it's possible to make it work if your engineers are willing
to put in the time to come up with a solution. The Netbeans code is public,
so your engineers could take a look at it and see at least one way to solve
this problem.

--Paul

At 08:29 AM 11/25/2003, David Cagle wrote:
>Per,
> We link from helpset to helpset in our documentation and it has
> caused great pains for installation, development, and authors. As Roger
> has stated, it is very hard to get linking from Jar to Jar working
> successfully and is one of the reasons why we do not Jar our JavaHelp
> files. And since we do not Jar our files, our documentation base is
> huge. Looking back, I wish we would not have allowed the authors to
> crosslink helpsets...it has caused great pains for us.
>
>Just my 2 cents though!
>
>-----Original Message-----
>From: Roger Brinkley [mailto:Roger.Brinkley@SUN.COM]
>Sent: Tuesday, November 25, 2003 11:19 AM
>To: JAVAHELP-INTEREST@JAVA.SUN.COM
>Subject: Re: [JAVAHELP] Trying static merge
>
>
>Per Lundkvist wrote:
> > Hmm ok so is it possible to link to a file in another JAR-file if just
> > the CLASSPATH etc. is correct, or is it not possible at all?
>
>In theory it is NOT possible. In practice you get lucky when the moon is
>positioned at the 12 hour and Mars is in perfect alignment with the earth
>(in otherwords, occassionally).
>
> > My JAR-files when they are in our software are in the same folder, and
> > that folder is pointed out as folder where to look for classes in. So
> > for links in files in B.jar I have to have links as "../A/a_file.htm"
> > (where a_file.htm is in the A.jar-file), correct?
>
>No...you would have to refer to A.jar somehow. The above reference points
>a directory A which if you jarred A doesn't exist.
>
>In generally it is a really bad practice to refer to a content file
>outside it's helpset. If it works you're lucky!!
>
>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.

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

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.

Per Lundkvist

Ok, thank you!
It is exact the position I'm in right now...

Per

-----Original Message-----
From: Discussion list of JavaHelp
[mailto:JAVAHELP-INTEREST@JAVA.SUN.COM]On Behalf Of David Cagle
Sent: tisdag november 25, 2003 17:30
To: JAVAHELP-INTEREST@JAVA.SUN.COM
Subject: Re: [JAVAHELP] Trying static merge

Per,
We link from helpset to helpset in our documentation and it has caused
great pains for installation, development, and authors. As Roger has
stated, it is very hard to get linking from Jar to Jar working successfully
and is one of the reasons why we do not Jar our JavaHelp files. And since
we do not Jar our files, our documentation base is huge. Looking back, I
wish we would not have allowed the authors to crosslink helpsets...it has
caused great pains for us.

Just my 2 cents though!

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

Per Lundkvist wrote:
> Hmm ok so is it possible to link to a file in another JAR-file if just
> the CLASSPATH etc. is correct, or is it not possible at all?

In theory it is NOT possible. In practice you get lucky when the moon is
positioned at the 12 hour and Mars is in perfect alignment with the earth
(in otherwords, occassionally).

> My JAR-files when they are in our software are in the same folder, and
> that folder is pointed out as folder where to look for classes in. So
> for links in files in B.jar I have to have links as "../A/a_file.htm"
> (where a_file.htm is in the A.jar-file), correct?

No...you would have to refer to A.jar somehow. The above reference points a
directory A which if you jarred A doesn't exist.

In generally it is a really bad practice to refer to a content file outside
it's helpset. If it works you're lucky!!

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.

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

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.