[Info-vax] VMS Help, man pages and info, was: Re: Long uptime cut short by Hurricane Sandy

[Simon Clubley]

On 2013-02-05, hb <end.of at inter.net> wrote:
> On 02/05/2013 09:46 PM, Simon Clubley wrote:
>> Also, you can search through all the man pages in one go to find matching
>> keywords. You cannot do that with VMS help.
> man uses a pager and the pager offers the search. Try 'man -P cat man' 
> to use cat as the pager.
>
> On VMS try "$ pipe help/out=sys$output help * |type /page=save 
> sys$input". Unfortunately type is not a pager with a search capability.
>

I am talking about using "man -k" to search the man pages.

>> The info manuals I read the most are the binutils linker manual (try
>> finding the GNU ld linker script syntax and usage documentation on the
>> ld man page :-)), the gcc manual and the make manual.
> Which seems just a matter of who spent more time on writing man pages or 
> the info manual.
>

Actually, the GNU documentation system is very elegant here.

If you use the GNU documentation toolchain, you write the manual once
and get it output in multiple formats, including info, HTML and pdf.

Simon.

-- 
Simon Clubley, clubley at remove_me.eisner.decus.org-Earth.UFP
Microsoft: Bringing you 1980s technology to a 21st century world