*BSD News Article 57337


Return to BSD News archive

Path: euryale.cc.adfa.oz.au!newshost.anu.edu.au!harbinger.cc.monash.edu.au!news.cs.su.oz.au!metro!metro!munnari.OZ.AU!spool.mu.edu!howland.reston.ans.net!vixen.cso.uiuc.edu!sdd.hp.com!hamblin.math.byu.edu!park.uvsc.edu!usenet
From: Terry Lambert <terry@lambert.org>
Newsgroups: comp.unix.admin,alt.os.linux,alt.uu.comp.os.linux.questions,comp.os.linux.advocacy,comp.os.linux.misc,comp.os.linux.setup,comp.unix.bsd.freebsd.misc,comp.unix.bsd.netbsd.misc
Subject: Re: a monthly FreeBSD magazine (and other *BSD's too)
Date: 18 Dec 1995 00:26:27 GMT
Organization: Utah Valley State College, Orem, Utah
Lines: 21
Message-ID: <4b2cfj$hua@park.uvsc.edu>
References: <4ajc07$sb7@unix2.glink.net.hk> <4al9tu$f33@ixnews3.ix.netcom.com> <4alnqo$1hi@clarknet.clark.net> <4am5uq$r24@agate.berkeley.edu> <4arhgi$f0c@felix.junction.net> <DJqtos.G70@ibbs.av.org>
NNTP-Posting-Host: hecate.artisoft.com
Xref: euryale.cc.adfa.oz.au comp.unix.admin:36227 alt.os.linux:6563 alt.uu.comp.os.linux.questions:5194 comp.os.linux.advocacy:30909 comp.os.linux.misc:76529 comp.os.linux.setup:33042 comp.unix.bsd.freebsd.misc:10821 comp.unix.bsd.netbsd.misc:1619

js@ibbs.av.org (Jeff Stillinger) wrote:
]
] Ahhh, Michael you seem to have hit the nail on the head.  This
] is the biggest and most costly error that FreeBSD has.  In most
] cases the man pages are written very poorly.  The only thing
] that resembles a book is the FAQ.  It can be a waste of time
] when the FAQ tells you a lot of nothing.  Compiling a kernel
] can be a adventure to say the least.

There is a new user manual in PS format that is (supposedly)
going to a publisher.  It has been posted about several times.

On man pages: What is a well written man page?  On that makes
you _want_ to type the command?


                                        Terry Lambert
                                        terry@cs.weber.edu
---
Any opinions in this posting are my own and not those of my present
or previous employers.