From owner-cvs-all Sat Sep 29 18:46:10 2001 Delivered-To: cvs-all@freebsd.org Received: from wantadilla.lemis.com (wantadilla.lemis.com [192.109.197.80]) by hub.freebsd.org (Postfix) with ESMTP id A5A9237B40B; Sat, 29 Sep 2001 18:46:00 -0700 (PDT) Received: by wantadilla.lemis.com (Postfix, from userid 1004) id 9B6DA6A90F; Sun, 30 Sep 2001 11:16:38 +0930 (CST) Date: Sun, 30 Sep 2001 11:16:38 +0930 From: Greg Lehey To: Jordan Hubbard , Dag-Erling Smorgrav Cc: cvs-committers@freebsd.org, cvs-all@freebsd.org Subject: Documenting features (was: cvs commit: src/sys/fs/pseudofs pseudofs.c pseudofs.h pseudofs_vnops.c) Message-ID: <20010930111638.D21466@wantadilla.lemis.com> References: <200109290049.f8T0nT532156@freefall.freebsd.org> <20010928200514P.jkh@freebsd.org> <20010929123447M.jkh@freebsd.org> <200109290049.f8T0nT532156@freefall.freebsd.org> <20010928200514P.jkh@freebsd.org> <20010929123447M.jkh@freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <20010929123447M.jkh@freebsd.org>; from jkh@freebsd.org on Sat, Sep 29, 2001 at 12:34:47PM -0700 Organization: The FreeBSD Project Phone: +61-8-8388-8286 Fax: +61-8-8388-8725 Mobile: +61-418-838-708 WWW-Home-Page: http://www.FreeBSD.org/ X-PGP-Fingerprint: 6B 7B C3 8C 61 CD 54 AF 13 24 52 F8 6D A4 95 EF 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 On Saturday, 29 September 2001 at 12:34:47 -0700, Jordan Hubbard wrote: >> Jordan Hubbard writes: >>> Erm, what's it do? I don't see a man page in there anywhere. :) >> >> You know very well what it does - it's the backend for linprocfs (and >> shortly procfs). I haven't documented it because it's been very >> volatile and WIP - thanks to the sorry state of -CURRENT I haven't >> been able to work on it for the past three months. > > Pardon me, but I do not "know very well what it does" or I wouldn't > have asked! Furthermore, since it's clearly reached the stage of > development where it can be checked in, you should also check in a man > page with it so that we don't have [even more] undocumented things > lying around the tree. This is not too much to ask. On Sunday, 30 September 2001 at 0:10:23 +0200, Dag-Erling Smorgrav wrote: > Jordan Hubbard writes: >> Pardon me, but I do not "know very well what it does" or I wouldn't >> have asked! > > We had a long discussion about pseudofs on IRC this spring, before I > committed the initial version. It's not my fault if you don't > remember any of it. Yes, it is. IRC is not a documentation medium; in fact, it performs very poorly at this function. That's by no means the only reason we have man pages. If you check in code without documentation, it's your own fault if nobody finds out what it does. The (implied) fact that jkh was party to the discussion on IRC has nothing to do with it. Like most people in the project, I wasn't there, and I have neither the foggiest idea what this does, nor the inclination to go and read the code. Greg -- See complete headers for address and phone numbers To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message