[Info-vax] VMS documentation, was: Re: callable BACKUP example

[Arne Vajhøj]

On 7/16/2021 9:14 PM, Craig A. Berry wrote:
> On 7/16/21 6:28 PM, Arne Vajhøj wrote:
>> On 7/16/2021 1:52 PM, Simon Clubley wrote:
>>> Use extracts from the full examples to explain certain points within the
>>> manuals and then provide the full source code for those examples 
>>> somewhere
>>> outside of the .pdf.
>>
>> Or switch entirely to web and HTML. Then making links to full
>> examples is easy.
> 
> HTML would be a poor source format for anything as large and complex as
> the VMS doc set.  At some point they were talking about XML in the
> DocBook schema and that would make sense.  Then the docs could be easily
> transformed into HTML, PDF, ePub, MarkDown, or whatever.  Embedding
> and/or providing links to examples shouldn't pose any problem.

Most documentation is HTML.

Including some pretty big doc sets.

Arne