From owner-freebsd-current Sun Jul 21 14:58:11 2002 Delivered-To: freebsd-current@freebsd.org Received: from mx1.FreeBSD.org (mx1.FreeBSD.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 3A8A437B400 for ; Sun, 21 Jul 2002 14:58:10 -0700 (PDT) Received: from critter.freebsd.dk (port757.uc1-esp.isdn-lan.cybercity.dk [212.242.98.245]) by mx1.FreeBSD.org (Postfix) with ESMTP id DBE6A43E42 for ; Sun, 21 Jul 2002 14:58:07 -0700 (PDT) (envelope-from phk@critter.freebsd.dk) Received: from critter.freebsd.dk (localhost [127.0.0.1]) by critter.freebsd.dk (8.12.3/8.12.2) with ESMTP id g6LLtaNK023562; Sun, 21 Jul 2002 23:55:42 +0200 (CEST) (envelope-from phk@critter.freebsd.dk) To: Dima Dorfman Cc: Sheldon Hearn , current@FreeBSD.ORG Subject: Re: DEVFS rule subsystem (was: cvs commit: src/sbin Makefile src/sbin/devfs Makefile devfs.8 devfs.c extern.h rule.c src/sys/conf files src/sys/fs/devfs devfs.h devfs_devs.c devfs_rule.c devfs_vfsops.c devfs_vnops.c ) In-Reply-To: Your message of "Sun, 21 Jul 2002 21:52:36 -0000." <20020721215236.5A6BB3F5F@turbine.trit.org> Date: Sun, 21 Jul 2002 23:55:36 +0200 Message-ID: <23560.1027288536@critter.freebsd.dk> From: Poul-Henning Kamp Sender: owner-freebsd-current@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.ORG In message <20020721215236.5A6BB3F5F@turbine.trit.org>, Dima Dorfman writes: >Sheldon Hearn wrote: >> On (2002/07/17 01:52), Dima Dorfman wrote: >> >> > The devfs(8) manual page is a pretty good reference of the existing >> > features and semantics, but it lacks polish needed to be able to serve >> > as an introduction. >> >> Actually, I think it's brilliant. >> >> The only nits are the weird sections, which made it hard for me to find >> my way around. For example, the examples are all in an Examples >> subsection of the non-standard RULE SUBSYSTEM section, so I didn't see >> that there were examples when I first looked for them. >> >> I'd suggest the attached patch, to make it easier for manpage die-hards >> to navigate. > >The reason everything is written under subsections is that /sbin/devfs >is not, in theory, limited to just rule manipulation. I don't really >like how I did it, either, but if I write everything under "standard" >sections like you suggest, adding non-rule stuff to devfs(8) will be a >much bigger pain. Well, given that we currently don't even have any ideas for what other functions devfs(8) might perform, I think we should make the manpage conform to normal layout until these features present themselves. -- Poul-Henning Kamp | UNIX since Zilog Zeus 3.20 phk@FreeBSD.ORG | TCP/IP since RFC 956 FreeBSD committer | BSD since 4.3-tahoe Never attribute to malice what can adequately be explained by incompetence. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-current" in the body of the message