From owner-freebsd-doc Wed Jun 23 22:53:59 1999 Delivered-To: freebsd-doc@freebsd.org Received: from mpp.pro-ns.net (mpp.pro-ns.net [208.200.182.72]) by hub.freebsd.org (Postfix) with ESMTP id DCD0B14CA8; Wed, 23 Jun 1999 22:53:50 -0700 (PDT) (envelope-from mpp@mpp.pro-ns.net) Received: (from mpp@localhost) by mpp.pro-ns.net (8.9.3/8.9.3) id AAA14021; Thu, 24 Jun 1999 00:53:42 -0500 (CDT) (envelope-from mpp) From: Mike Pritchard Message-Id: <199906240553.AAA14021@mpp.pro-ns.net> Subject: Re: Survey: online documentation 15% incorrect In-Reply-To: <19990623133428.22679.qmail@nwcst323.netaddress.usa.net> from Jesus Monroy at "Jun 23, 1999 06:34:28 am" To: jesus.monroy@usa.net (Jesus Monroy) Date: Thu, 24 Jun 1999 00:53:42 -0500 (CDT) Cc: doc@FreeBSD.ORG, advocacy@FreeBSD.ORG X-Mailer: ELM [version 2.4ME+ PL54 (25)] MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org > Document: Documentation errors in FreeBSD > Run Date: 6/17/99 > Description: The following is a listing of incomplete, ambigous or > failed references for FreeBSD using whatit(1) and man(1). > This survey was conducted using FreeBSD 3.1. > > A complete Listing can be found at: > http://www.geocities.com/SiliconValley/Hub/8031/psuedo-indicators/fbsdutils.html > > Score: > directory no reference ambigous reference other total available > /bin 0 1 1 2 32 > /sbin 8 5 0 13 82 > /usr/bin 42 33 0 75 394 > /usr/sbin 8 7 2 17 183 > ---- ---- > total total 107 691 > > Final Score 107.0/691.0 = 0.1548 (15.5%) I took a look through this list and by my count only about 55 of the references are bogus or incorrect or ambiguous. A number of them in your list are producing exactly what they should be. Some others have been fixed in -current already. There are a handful of man pages with links to other man pages that do not show the links in the NAME/SYSNOPSIS section. I'm going to go fix the easy ones right now. A number of man pages/commands are links for historical names for commands, which have been replaced by new/GNU replacements and the man pages reflect the updated versions, not the historical name for the command. These should probably be fixed, too. 'man cc' is a good example. You get what you need - the gcc man page. I've never been sure what we should do with these. One interesting problem your survery points out is that whatis/makewhatis get confused about inetd.conf and inetd. It lists them both as section 5 man pages, when only inetd is section 8. This is because the inetd Makefile MLINKS inetd.8 to inetd.conf.5. There are probably a few other commands that might be doing this. I'll have to look at this closer. Then there are the commands without manual pages, which is just plain wrong. -- Mike Pritchard mpp@FreeBSD.ORG or mpp@mpp.pro-ns.net To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message