Date: Sun, 21 Jul 2002 23:55:36 +0200 From: Poul-Henning Kamp <phk@critter.freebsd.dk> To: Dima Dorfman <dima@trit.org> Cc: Sheldon Hearn <sheldonh@starjuice.net>, 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 ) Message-ID: <23560.1027288536@critter.freebsd.dk> In-Reply-To: Your message of "Sun, 21 Jul 2002 21:52:36 -0000." <20020721215236.5A6BB3F5F@turbine.trit.org>
next in thread | previous in thread | raw e-mail | index | archive | help
In message <20020721215236.5A6BB3F5F@turbine.trit.org>, Dima Dorfman writes: >Sheldon Hearn <sheldonh@starjuice.net> 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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?23560.1027288536>