[Info-vax] Legacy HP Documentation

[Stephen Hoffman]

On 2019-01-03 18:25:45 +0000, Simon Clubley said:

> On 2019-01-03, Stephen Hoffman <seaohveh at hoffmanlabs.invalid> wrote:
>> 
>> The doc has had these issues forever, and was only originally intended 
>> for OpenVMS and Windows, though macOS will also work.
> 
> It's a pity however this allowed the documentation authors to be so 
> sloppy when they created the documentation.

This particular limitation has been known for many years, and it may 
well be (is?) documented.  Details such as the filename casing are not 
details that DEC DOCUMENT particularly concerned itself with.  Old 
tools give old results, unless they're maintained and upgraded.  
DOCUMENT has also had a habit of tipping over, and the HTML generation 
and templating and other details are very limited.  VSI won't be 
upgrading DOCUMENT per their comments, and the planned migration to 
newer docbook-based tooling obviously provides some opportunities for 
enhancements.  Eventually.

> Until now, I've just used the individual PDFs which I downloaded a 
> while back. Given how big a pain the VMS PDF manuals can be, I thought 
> I would give the ODL a try instead and promptly ran into this problem.

The DOCUMENT PDFs on macOS work, and Spotlight automatically indexes 
the contents for easier searching.  Other than the scanned documents, 
though I don't recall any of those in the main documentation set.  
Those are a hassle to search, absent OCR, and what's been OCRed cau be 
ug1y t0 worb with.

But then the whole of the OpenVMS doc design is straight out of the 
last millennium, not to mention the very large gaps in the existing 
content.

-- 
Pure Personal Opinion | HoffmanLabs LLC