From owner-freebsd-doc@FreeBSD.ORG Thu Aug 19 21:01:19 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 6993416A4CE for ; Thu, 19 Aug 2004 21:01:19 +0000 (GMT) Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by mx1.FreeBSD.org (Postfix) with ESMTP id EFA5E43D41 for ; Thu, 19 Aug 2004 21:01:18 +0000 (GMT) (envelope-from trhodes@FreeBSD.org) Received: from localhost.pittgoth.com (acs-24-154-239-170.zoominternet.net [24.154.239.170]) (authenticated bits=0) by pittgoth.com (8.12.10/8.12.10) with ESMTP id i7JL1GVF006669 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Thu, 19 Aug 2004 17:01:17 -0400 (EDT) (envelope-from trhodes@FreeBSD.org) Date: Thu, 19 Aug 2004 17:01:51 -0400 From: Tom Rhodes To: Bill Moran Message-Id: <20040819170151.568a7d9f@localhost.pittgoth.com> In-Reply-To: <20040819150125.4fbae6e2.wmoran@potentialtech.com> References: <41249BC4.7000205@pushitlive.net> <20040819085015.73799dca.wmoran@potentialtech.com> <20040819112808.52f7bdc5@localhost.pittgoth.com> <20040819150125.4fbae6e2.wmoran@potentialtech.com> X-Mailer: Sylpheed-Claws 0.9.12 (GTK+ 1.2.10; i386-portbld-freebsd5.2) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit cc: freebsd-doc@FreeBSD.org Subject: Re: Man Pages Thoughts X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 19 Aug 2004 21:01:19 -0000 On Thu, 19 Aug 2004 15:01:25 -0400 Bill Moran wrote: > > Tom Rhodes wrote: > > > > %pwd > > /usr/src > > %find . -name '*.[1-9]' | xargs grep 'EXAMPLES' | wc -l > > 493 > > %find . -name '*.[1-9]' | wc -l > > 2892 > > > > So basically, you only need to fix 2399 manual pages; > > > > NOTES: > > > > 1: This counts files in contrib; > > Can't do that. Yes we can. Many times we've modified manual pages in contrib or applied a make(1) work around. Just it makes updates to the code in CVS more difficult. :( > > > 2: Some example sections would be dubious (rc.conf, make.conf, etc); > > Agreed. Many daemons don't need example sections, such as ftpd, etc. > > This was why I recommended he point out the particular man page(s) that > he thought needed examples. Well, we could just say "All functions, system calls, etc. require EXAMPLES" but that would be more work than we have time for I think. > > > 3: Personally, I honestly don't have the time for a project > > like this. Sorry. > > Oh, come on. You're not doing anything else important ... I'll tell you > what ... take the time you spend chasing women around and cut it in half. > You'll still be getting way more sex than me, and you'll have a ton of > extra time to work on FreeBSD stuff! Hey, you can't say that. Consider this, last night was the first time I talked to a "new" girl in awhile. Gave her my phone number, but she won't call me and I know it. And now that I think of it, I probably shouldn't be discussing my addictions on this list. Besides, I'd like to see you prove that mathmatically. :P -- Tom Rhodes