From owner-cvs-all Sun Sep 30 10:49:57 2001 Delivered-To: cvs-all@freebsd.org Received: from flood.ping.uio.no (flood.ping.uio.no [129.240.78.31]) by hub.freebsd.org (Postfix) with ESMTP id 40C7237B40A; Sun, 30 Sep 2001 10:49:49 -0700 (PDT) Received: (from des@localhost) by flood.ping.uio.no (8.9.3/8.9.3) id TAA30630; Sun, 30 Sep 2001 19:49:47 +0200 (CEST) (envelope-from des@ofug.org) X-URL: http://www.ofug.org/~des/ X-Disclaimer: The views expressed in this message do not necessarily coincide with those of any organisation or company with which I am or have been affiliated. To: Greg Lehey Cc: Jordan Hubbard , cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: Documenting features (was: cvs commit: src/sys/fs/pseudofs pseudofs.c pseudofs.h pseudofs_vnops.c) References: <20010928200514P.jkh@freebsd.org> <20010929123447M.jkh@freebsd.org> <200109290049.f8T0nT532156@freefall.freebsd.org> <20010928200514P.jkh@freebsd.org> <20010929123447M.jkh@freebsd.org> <20010930111638.D21466@wantadilla.lemis.com> <20010930202000.Q25827@wantadilla.lemis.com> From: Dag-Erling Smorgrav Date: 30 Sep 2001 19:49:46 +0200 In-Reply-To: <20010930202000.Q25827@wantadilla.lemis.com> Message-ID: Lines: 19 User-Agent: Gnus/5.0808 (Gnus v5.8.8) Emacs/20.7 MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.ORG Greg Lehey writes: > On Sunday, 30 September 2001 at 10:43:46 +0200, Dag-Erling Smorgrav wrote: > > Greg Lehey writes: > > > Yes, it is. IRC is not a documentation medium; in fact, it performs > > > very poorly at this function. > > Nor did I claim it was. Read the entire thread again. > No, that's a particularly poor method of documentation as well. Argh. I can see this is heading nowhere, and apologize for being so bull-headed. My comment about IRC was in reaction to Jordan's claim that he knew nothing of pseudofs; I got annoyed at that because pseudofs grew out of an argument I had on IRC early this spring with jkh and jlemon. I think I'll follow Warner's suggestion and write up a token man page that explains what pseudofs does without describing the API. DES -- Dag-Erling Smorgrav - des@ofug.org To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message