Joined: 07 Feb 2009 Posts: 1060 Location: Oostende, Belgium
It might be useful to add a little description of what each example is doing to the TOC, now it's just a long list of "Example n", adding e.g. used keywords to each and adding index entries for them would make it a bit faster to find the example that you need.
In my case I needed a SEQNUM example and the first one is in Example 12 of OUTFIL. If the TOC had mentioned it, something like "Example 12 (SEQNUM)", or if there had been an index entry
it would have sped up the search...
There is by the way also an issue with INDEX entries pointing to the wrong page, try the very first O entry, "OCCUR operator (ICETOOL) 643" on DFSORT Application Programming Guide. For what it's worth, this seems to be a very common issue with many IBM manuals...
If I use the PDF and "view sidepane" to look at the "Index (which is extended table-of-contents really) I can navigate to the examples in each section, then when I click on the example number, it takes me straight to the example in the normal viewing area.
Joined: 29 Oct 2010 Posts: 187 Location: Toronto, ON, Canada
If you have the PDF version of the manual then there is a page near the beginning on How to send your comments to IBM. It gives a link to a web page. I used this recently to send comments to IBM about the size of the chapter on OUTFIL (it is over 170 pages long). They replied back.