From owner-freebsd-questions@FreeBSD.ORG Sun Apr 15 04:15:25 2007 Return-Path: X-Original-To: freebsd-questions@freebsd.org Delivered-To: freebsd-questions@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 7ED4316A40F for ; Sun, 15 Apr 2007 04:15:25 +0000 (UTC) (envelope-from keramida@ceid.upatras.gr) Received: from igloo.linux.gr (igloo.linux.gr [62.1.205.36]) by mx1.freebsd.org (Postfix) with ESMTP id F1CCA13C44B for ; Sun, 15 Apr 2007 04:15:24 +0000 (UTC) (envelope-from keramida@ceid.upatras.gr) Received: from kobe.laptop (dialup15.ach.sch.gr [81.186.70.15]) (authenticated bits=128) by igloo.linux.gr (8.13.8/8.13.8/Debian-3) with ESMTP id l3F4EOWo003882 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Sun, 15 Apr 2007 07:14:38 +0300 Received: from kobe.laptop (kobe.laptop [127.0.0.1]) by kobe.laptop (8.14.1/8.14.1) with ESMTP id l3F4ELmK004028; Sun, 15 Apr 2007 07:14:22 +0300 (EEST) (envelope-from keramida@ceid.upatras.gr) Received: (from keramida@localhost) by kobe.laptop (8.14.1/8.14.1/Submit) id l3F4EGB7004027; Sun, 15 Apr 2007 07:14:16 +0300 (EEST) (envelope-from keramida@ceid.upatras.gr) Date: Sun, 15 Apr 2007 07:14:16 +0300 From: Giorgos Keramidas To: Garrett Cooper Message-ID: <20070415041416.GD3571@kobe.laptop> References: <1176551927.6799.9.camel@FreeBSD.localhost> <462122E2.20207@u.washington.edu> <20070414192420.GH302@demeter.hydra> <46212CD6.9020702@u.washington.edu> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <46212CD6.9020702@u.washington.edu> X-Hellug-MailScanner: Found to be clean X-Hellug-MailScanner-SpamCheck: not spam, SpamAssassin (not cached, score=-3.685, required 5, autolearn=not spam, ALL_TRUSTED -1.80, AWL 0.51, BAYES_00 -2.60, DNS_FROM_RFC_ABUSE 0.20) X-Hellug-MailScanner-From: keramida@ceid.upatras.gr X-Spam-Status: No Cc: Chad Perrin , freebsd-questions@freebsd.org Subject: Re: I like Ubuntu X-BeenThere: freebsd-questions@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: User questions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 15 Apr 2007 04:15:25 -0000 On 2007-04-14 12:34, Garrett Cooper wrote: >Chad Perrin wrote: >>On Sat, Apr 14, 2007 at 11:52:18AM -0700, Garrett Cooper wrote: >>>Also, it's Linux-based so documentation in terms of manpages are >>>most likely non-existent, like with Gentoo Linux. >> >> That's by no means universal among Linux distributions. Debian actually >> provides better manpage coverage than FreeBSD, for instance. > > But some of the manpages are out of date, like for the coreutils > (I think mv/cp was one of them?). I like the comment in there about > Stallman liking infopages but Debian-ites having to create a manpage :). > I personally hate infopages, but that's me. One of the most important reasons why I like FreeBSD is the quality of the documentation. I find it rather appaling that running "man mv" on Debian shows a warning in the SEE ALSO section: % SEE ALSO % The full documentation for mv is maintained as a Texinfo % manual. If the info and mv programs are properly installed % at your site, the command % % info mv % % should give you access to the complete manual. What is amusing is that exactly the same warning is displayed when one runs 'info mv' :P The full documentation of mv(1) *is* available as an Info page, but it is not where the manpage points the user. By lurking at the FreeBSD cvs-commit lists, while I was a BSD newbie, I noticed source changes being rolled back because their documentation was not ready yet. I saw BSD people demanding than manpages are updated after a source commit, and dozens of merges from HEAD to one of the STABLE branches which treated manpages as first class citizens of the source tree, and not some entertaining but always out-of-date pariah. - Giorgos