Path: utzoo!censor!geac!torsqnt!news-server.csri.toronto.edu!clyde.concordia.ca!thunder.mcrcim.mcgill.edu!snorkelwacker.mit.edu!tut.cis.ohio-state.edu!cs.utexas.edu!uunet!auspex!guy
From: guy@auspex.auspex.com (Guy Harris)
Newsgroups: comp.unix.misc
Subject: Re: UNIX Documentation (was: '386 Unix Wars)
Keywords: unix, documentation, manual, research, index
Message-ID: <5064@auspex.auspex.com>
Date: 5 Jan 91 22:39:01 GMT
References: <1990Dec20.175625.17487@eci386.uucp> <357@metran.UUCP> <1990Dec28.004756.6019@eci386.uucp>
Organization: Auspex Systems, Santa Clara
Lines: 21

>Mind you, if you did discover that a terminal was a device, and that
>devices could be controlled with ioctl(2), you would have immediately
>been referred to termio(7) with a fair degree of certainty that you
>were headed in the right direction.

Now, if they'd only put "termio(7)" somewhere other than the f*cking
*ADMINISTRATOR'S* manual, like in the damn *PROGRAMMER'S* manual, since
the people who usually write code that uses the "termio(s)" functions
are PROGRAMMERS....

...and then, while they're at it, think about merging all the little
fragments of manual page stuck, in the S5R4 manuals, at the end of stuff
like the STREAMS Programmer's Guide and the Network Interfaces
Programmer's Guide back into the main Programmer's Reference Manual (and
maybe even do some *manual pages* for pseudo-tty stuff other than the
library routines, rather than just the "STREAMS-based Terminal
Subsystem" section of the STREAMS Programmer's Guide).

Yes, it may be nice to have an index that tells you where that stuff is.
It's even *nicer* to have it in reasonably-obvious places so you don't
have to *check* the index....