Sorry about the missing pages in the User Manual.
After examining the PDF doc I created again, I realized what went wrong.
When I converted the User Manual using Acrobat's auto HTML-to_PDF
conversions, I told Acrobat to limit the conversion to only two
hyperlink-levels deep. I didn't want Acrobat to follow hyperlinks that
were outside of the User Manual. It turns out that the User manual has
hyperlinks up to four four levels deep. This is why the extra pages were
missing from the manual.
A more effective approach is to tell Acrobat to limit the conversions to
only pages on the single User Manual path: file:///d:/program files/j
software/j601c-release/system/extras/help/user/
but allow the conversion to go in as many levels deep as it needs, which
should include all of the User Manual pages. This works much better, as
it converts all of the HTML pages in the User Manual path. Howeve, this
it makes for a much larger bookmark list, which doesn't necessarily get
put in in the most appropriate sequential tree structure. Also, this
conversion will not include hyperlinks to other docs outside the User
Manual path. The Hyperlinks will be there, but unless you have the same
path structure as I do, those links won't work.
I re-converted the user manual with the deeper link limit, and
re-published it on my site http://elliscave.com/APL_J/reference/
(There is an underscore between APL & J). The new version is labeled
with an 'a' in the name. Keep in mind that only links to User Manual
pages will be included in the PDF doc. Links to docs outside of the user
manual (such as the navigation links at the top of each page) will not
operate.
All of this points up a basic issue with making a print version of a
hyperlinked document. The various sub-chapters in a HTML document are
not necessarily in sequential order with their parent topics.In the
hypertext document, the parent chapter just links to the appropriate
subchapter wherever it needs to, no matter where the sub-chapter is
actually located in the HTML document.
However, when the doc prints, the sub-chapters are often out of
sequence, since there is no incentive to put them in any particular
order. Hyperlinks can jump anywhere in the doc. For that matter, some
sub-chapters may be referenced from several parent chapters, so there
isn't a specific "right' presentation sequence. The only issue the
hypertext document writer has is to is to make sure that the text is all
there somewhere, and that the links are all right. With the printed
version, One just has to know how to jump around to the right sections
to read it. One could probably re-sequence the "bookmarks' TOC in the
PDF doc, to better represent a reasonable reading order, rather than the
HTML doc sequence, with some extra work.
There may be similar problems with the other J documentation on the
site, since I did all the conversions with a 2-deep hyperlink limit. If
anyone spots more problems with the docs, let me know...
Skip Cave
<<<>>>
Philip A. Viton wrote:
It looks to me as if there's something missing, at least with the PDF
version of the User Manual. Go to the Regex section; you see the toc
for that section. Click on one of the topics (eg, Patterns). The link
is to an HTML file Not a part of the pdf document), presumably on
Skip's computer: your browser will probably give you a Document Not
Found error here.
------------------------
Philip A. Viton
City Planning, Ohio State University
275 West Woodruff Avenue, Columbus OH 43210
[EMAIL PROTECTED]
----------------------------------------------------------------------
For information about J forums see http://www.jsoftware.com/forums.htm
----------------------------------------------------------------------
For information about J forums see http://www.jsoftware.com/forums.htm
