Skip to main content

Trying static merge

8 replies [Last post]
Anonymous

I try to do a static merge just to test how it looks, but it doesn't work?!

I have tried to put the -line i these 3 different ways:

1.)

2.)

3.)

But nothing works....
The Master HelpSet is placed in a folder beside the subhelpset like:

c:\folder\masterfolder\

And the subhelpset is like:
c:\folder\example\

Hmm please help me here...

Per

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

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.
Per Lundkvist

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?

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?

Thank you for all your answers to me, I really appreciate it!

Per

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

Per Lundkvist wrote:
> I try to do a static merge just to test how it looks, but it doesn't
work?!
>
> I have tried to put the -line i these 3 different ways:
>
> 1.)
>
>
> 2.)
>
>
> 3.)
>
>
> But nothing works....
> The Master HelpSet is placed in a folder beside the subhelpset like:
>
> c:\folder\masterfolder\
>
> And the subhelpset is like:
> c:\folder\example\
>
>
> Hmm please help me here...
>

The file specification has to be relative to the helpset file. Note that
MS delimiters are not recognized. It's a URL so you have to the use
the URL/Unix delimiter.

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.

Roger Brinkley

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.

Per Lundkvist

Grmpf...ups!
That is not good for me, I'm in trouble!
I thought that was the whole point with JavaHelp and merging JAR-files with
eachother.
What is the point of merging JAR:s if they can not link to eachother.
They merge the TOC, Index and search but they can't link to eachother...

In my case we have modules in our software. If a module is installed we just
merge the module-documentation JAR-file into the master-documentation
JAR-file.
And in the module-documentation there are several links to the
masterdocumentation that now will not work...
So I have to skip JavaHelp now and start doing a HTML-documentation or...

I'm worried ;-)
Anyway thank you guys for the answers.

Per

-----Original Message-----
From: Discussion list of JavaHelp
[mailto:JAVAHELP-INTEREST@JAVA.SUN.COM]On Behalf Of Roger Brinkley
Sent: tisdag november 25, 2003 17:19
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.

Roger Brinkley

Per Lundkvist wrote:
> Grmpf...ups!
> That is not good for me, I'm in trouble!
> I thought that was the whole point with JavaHelp and merging JAR-files with
> eachother.
> What is the point of merging JAR:s if they can not link to eachother.
> They merge the TOC, Index and search but they can't link to eachother...
>
> In my case we have modules in our software. If a module is installed we just
> merge the module-documentation JAR-file into the master-documentation
> JAR-file.
> And in the module-documentation there are several links to the
> masterdocumentation that now will not work...

It's a constraint and it's been there since the age of time. Module help
should be self contained. There are good reasons for this. The only
place where cross reference occurs, or should occur, is in the content
viewer. What should the help system do if the reference your trying to
make doesn't exist or is configured incorrectly (referenced
differently)? As you have found out there are two many installation
variables that make cross referencing impossible and for some
applications these variables are uncontrollable.

However, there is a workaround, which as been discussed more than once
in the archives. The proper and only way to accurately reference a
document in another helpset is through a map.ID. That's what is used in
context-sensitive help within the application. If you're going to go
across helpset boundaries this is thee (it may as well be divine) only
way to assure access to a content file in another helpset. Since the map
files are linked at the master helpset level it is possible to access a
content file through the mapID.

The trick is doing this in the content viewer because you can't use a
URL to do it. The only way I know of doing this is to write a
light-weight component that transform the text with underlines, turns
blue, or whatever when the file existed and is normal text when it
doesn't. This is very similar to the code that currently exists for
secondary and popup windows lightweight component. In fact this code
optionally already handles mapIDs. Copying that code and parring it down
should be be pretty simple.

So there is a workaround and all you have to do is use it.

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.

Per Lundkvist

Ok, I was a little worried that my work was unusable now, but I think I can
do a little work around here for us that also mught be better.
I simply change my Output folders in WWP where to put the generated JavaHelp
files. So then I can have they all gathered in the same JAR instead of 4
different...

Thank you for the explanation, now I know and understand how it works I
think.
Anyway, JavaHelp is very powerful and useful for us.

Per L.

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

Per Lundkvist wrote:
> Grmpf...ups!
> That is not good for me, I'm in trouble!
> I thought that was the whole point with JavaHelp and merging JAR-files
with
> eachother.
> What is the point of merging JAR:s if they can not link to eachother.
> They merge the TOC, Index and search but they can't link to eachother...
>
> In my case we have modules in our software. If a module is installed we
just
> merge the module-documentation JAR-file into the master-documentation
> JAR-file.
> And in the module-documentation there are several links to the
> masterdocumentation that now will not work...

It's a constraint and it's been there since the age of time. Module help
should be self contained. There are good reasons for this. The only
place where cross reference occurs, or should occur, is in the content
viewer. What should the help system do if the reference your trying to
make doesn't exist or is configured incorrectly (referenced
differently)? As you have found out there are two many installation
variables that make cross referencing impossible and for some
applications these variables are uncontrollable.

However, there is a workaround, which as been discussed more than once
in the archives. The proper and only way to accurately reference a
document in another helpset is through a map.ID. That's what is used in
context-sensitive help within the application. If you're going to go
across helpset boundaries this is thee (it may as well be divine) only
way to assure access to a content file in another helpset. Since the map
files are linked at the master helpset level it is possible to access a
content file through the mapID.

The trick is doing this in the content viewer because you can't use a
URL to do it. The only way I know of doing this is to write a
light-weight component that transform the text with underlines, turns
blue, or whatever when the file existed and is normal text when it
doesn't. This is very similar to the code that currently exists for
secondary and popup windows lightweight component. In fact this code
optionally already handles mapIDs. Copying that code and parring it down
should be be pretty simple.

So there is a workaround and all you have to do is use it.

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.

Roger Brinkley

Per Lundkvist wrote:
> I try to do a static merge just to test how it looks, but it doesn't work?!
>
> I have tried to put the -line i these 3 different ways:
>
> 1.)
>
>
> 2.)
>
>
> 3.)
>
>
> But nothing works....
> The Master HelpSet is placed in a folder beside the subhelpset like:
>
> c:\folder\masterfolder\
>
> And the subhelpset is like:
> c:\folder\example\
>
>
> Hmm please help me here...
>

The file specification has to be relative to the helpset file. Note that
MS delimiters are not recognized. It's a URL so you have to the use
the URL/Unix delimiter.

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.

Per Lundkvist

"The file specification has to be relative to the helpset file. Note that
MS delimiters are not recognized. It's a URL so you have to the use
the URL/Unix delimiter."
=> Well ok I have tried all sorts of syntax now, the latest was:

and that didn't work either so I'm lost.

Per

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

Per Lundkvist wrote:
> I try to do a static merge just to test how it looks, but it doesn't
work?!
>
> I have tried to put the -line i these 3 different ways:
>
> 1.)
>
>
> 2.)
>
>
> 3.)
>
>
> But nothing works....
> The Master HelpSet is placed in a folder beside the subhelpset like:
>
> c:\folder\masterfolder\
>
> And the subhelpset is like:
> c:\folder\example\
>
>
> Hmm please help me here...
>

The file specification has to be relative to the helpset file. Note that
MS delimiters are not recognized. It's a URL so you have to the use
the URL/Unix delimiter.

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.

Roger Brinkley

Per Lundkvist wrote:
> "The file specification has to be relative to the helpset file. Note that
> MS delimiters are not recognized. It's a URL so you have to the use
> the URL/Unix delimiter."
> => Well ok I have tried all sorts of syntax now, the latest was:
>
>
>
> and that didn't work either so I'm lost.
>

All depends on what your classpath is. If the Classpath contains the
parent of directory of example as the last directory then it might work.
In general it has to be relative to the helpset file and general not
above or equal to the helpset file (though that occassionally works).

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.