How to refer to .TOC files within .TOC files?

QNX Newsgroups (Archives) qdn.public.qnxrtp.devtools
1

I have a large helpviewer documentation set whose nested tables of contents
work under QNX4, and used to work with older versions of QNX6. They no
longer function in 6.1 and 6.2Beta, as we are using TOC entries that point
at other .toc files. I notice that there is no example of this usage in any
QNX documentation, though it is documented in the helpviewer docs. Is this
style of .toc usage gone, or just broken? For an example of what I’m
talking about, install the Cogent Documentation from
http://developers.cogentrts.com/repository. The top level table of contents
appears, but will not expand. No amount of fiddling with paths seems to
make it work. Any suggestions?

Thanks,
Andrew

2

Andrew Thomas <andrew@cogent.ca> wrote:
: Anybody?


: “Andrew Thomas” <andrew@cogent.ca> wrote in message
: news:ac0opd$fdv$1@inn.qnx.com…
:> I have a large helpviewer documentation set whose nested tables of
: contents
:> work under QNX4, and used to work with older versions of QNX6. They no
:> longer function in 6.1 and 6.2Beta, as we are using TOC entries that point
:> at other .toc files. I notice that there is no example of this usage in
: any
:> QNX documentation, though it is documented in the helpviewer docs. Is
: this
:> style of .toc usage gone, or just broken? For an example of what I’m
:> talking about, install the Cogent Documentation from
:> http://developers.cogentrts.com/repository. The top level table of
: contents
:> appears, but will not expand. No amount of fiddling with paths seems to
:> make it work. Any suggestions?
:>

I haven’t installed your example, but here’s one thing to check: the
helpviewer uses a file called toc_index to speed up searches. This
file lists all the .toc files in the directory. For example, in
/usr/help/product/photon_2.0_en, the toc_index file is:

lib_ref.toc
multimedia.toc
prog_guide.toc
technotes.toc
wid_build.toc
widget_ref.toc

You can create the file by going to the top-level directory and typing:

ls *.toc > toc_index

Does that fix it?

Steve Reid stever@qnx.com
TechPubs (Technical Publications)
QNX Software Systems

3

Anybody?


“Andrew Thomas” <andrew@cogent.ca> wrote in message
news:ac0opd$fdv$1@inn.qnx.com…

I have a large helpviewer documentation set whose nested tables of
contents
work under QNX4, and used to work with older versions of QNX6. They no
longer function in 6.1 and 6.2Beta, as we are using TOC entries that point
at other .toc files. I notice that there is no example of this usage in
any
QNX documentation, though it is documented in the helpviewer docs. Is
this
style of .toc usage gone, or just broken? For an example of what I’m
talking about, install the Cogent Documentation from
http://developers.cogentrts.com/repository> . The top level table of
contents
appears, but will not expand. No amount of fiddling with paths seems to
make it work. Any suggestions?

Thanks,
Andrew

4

I haven’t installed your example, but here’s one thing to check: the
helpviewer uses a file called toc_index to speed up searches. This
file lists all the .toc files in the directory. For example, in
/usr/help/product/photon_2.0_en, the toc_index file is:

Hi Steve,
No, this does not help. The problem is quite a bit more fundamental
than that. We have .toc files that refer directly to other .toc files in
subdirectories, just as the documentation suggests. These work perfectly
in QNX4, but do not work at all in QNX6 (see previous message). One
question is: is the documentation in Helpviewer for Helpviewer now
obsolete with respect to how .toc files are formed? QSSL’s documentation
never refers to a .toc file from a .toc file.
The second question is: what is the correct way (please give details) of
making a .toc file hierarchy? What “magic” is expected - like the presence
of the toc_index, and the mysterious link between a .html file reference
in a .toc file and all of the .toc files in the subdirectory in which it
resides?

Thanks,
Andrew