man 3 switch

[Patrick O'Callaghan]

On Sat, 2009-11-14 at 12:16 -0600, Frank Cox wrote:
> On Sat, 14 Nov 2009 11:43:53 -0600
> Chris Adams wrote:
> 
> > Would you expect to see individual man pages for "if", "?:", "void",
> > etc.?
> 
> Actually yes, I would.  Those are fundamental parts of the C language and
> should have the same man documentation as the library functions.

The C Language is not documented in the man pages. It has *never* been
documented in the man pages in any version of Unix or Unix-related
systems that I'm aware of in over 35 years of use. Section 3 states
clearly that it documents "C Library Functions". Library functions are
not part of the language. Moreover, IMHO documenting language keywords
via man pages as they are traditionally understood would be next to
useless. A language requires a reference manual, tutorials and examples.
It does not require a man page on "if".

poc