Return to BSD News archive
Newsgroups: comp.unix.bsd.freebsd.misc Path: sserve!newshost.anu.edu.au!harbinger.cc.monash.edu.au!simtel!daffy!uwvax!uchinews!twpierce From: Tim Pierce <twpierce@midway.uchicago.edu> Subject: Re: Documentation project (was Re: Slight flame from Linux user) X-Nntp-Posting-Host: kimbark.uchicago.edu Message-ID: <DAA2IF.EpA@midway.uchicago.edu> Sender: news@midway.uchicago.edu (News Administrator) Organization: Vinegar Cabal References: <3ql3gd$je2@bell.maths.tcd.ie> <3rnmjc$fde@bell.maths.tcd.ie> <3roj57$l5s@pandora.sdsu.edu> <3rqdbg$q1u@hamilton.maths.tcd.ie> Date: Fri, 16 Jun 1995 18:13:31 GMT Lines: 28 In article <3rqdbg$q1u@hamilton.maths.tcd.ie>, Timothy Murphy <tim@maths.tcd.ie> wrote: >A manual in which each chapter (even each section) >is written by a different author >is most unlikely to be readable. > >By contrast, it doesn't make much difference >if "cat" is written by the same person as the OS, or not. Of course, if the table of contents was written by someone other than the manual's main author, it wouldn't make much difference. But two different people wrote the select and connect system calls and didn't communicate well, they might run into some pretty snaggly problems before long. You can't have it both ways. Out of curiosity, Tim old salt, have you ever read a book authored by more than one person? "The C Programming Language?" "The Unix Programming Environment?" "The Design and Implementation of the 4.3BSD Operating System?" "Webster's Unabridged Dictionary?" -- By sending unsolicited commercially-oriented e-mail to this address, the sender agrees to pay a $100 flat fee to the recipient for proofreading services.