Re: documentation formats

[Jan Nieuwenhuizen]

Op woensdag 11-11-2009 om 23:44 uur [tijdzone +0000], schreef Graham
Percival:
> On Wed, Nov 11, 2009 at 06:39:26PM -0500, Kieren MacMillan wrote:

> info is basically "man on steroids".  It might work on OSX; I
> can't remember.  Try
>    info gcc
> and see if you get anything.

This may 'show' an info page, but noone on the planet uses this.
INFO is meant to be used from your editor [in practice I think
this means Emacs -- vim sadly never got round to integrating info].

Info documents can be referenced simply by a few keystrokes and
give context-dependant help while editing code.  Quite indispensable
for me when I'm coding Python, for example.

Unlike the traditional terse, hi-brow style still adhered to most
man page writers today, info pages expect a human to be reading
them and add examples.

Greetings,
Jan.

-- 
Jan Nieuwenhuizen <address@hidden> | GNU LilyPond - The music typesetter
Avatar®: http://AvatarAcademy.nl    | http://lilypond.org