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

[Arne Vajhøj]

On 7/16/2021 1:52 PM, Simon Clubley wrote:
> On 2021-07-15, Arne Vajhøj <arne at vajhoej.dk> wrote:
>> A complete example makes it easy to copy paste and show some of the
>> extra stuff that need to be done in final code.
>>
>> But a complete example also tend to be much bigger and taking
>> much more time to read than a snippet that only show the the
>> specific stuff the example need to illustrate.
>>
> 
> Each VMS .pdf manual that contains extracts from source code examples
> should also come with a .zip file at the same location as the .pdf manual
> which contains the full versions of those examples. A .zip archive is
> preferable to placing the code in sys$examples: because it keeps the
> manual and the source code together.
> 
> 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.

Arne