From owner-freebsd-current Sun Jul 21 14:52:43 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 3E1E137B400 for ; Sun, 21 Jul 2002 14:52:38 -0700 (PDT) Received: from turbine.trit.org (turbine.trit.org [63.198.170.141]) by mx1.FreeBSD.org (Postfix) with ESMTP id B99BE43E42 for ; Sun, 21 Jul 2002 14:52:37 -0700 (PDT) (envelope-from dima@trit.org) Received: from turbine.trit.org (localhost [127.0.0.1]) by turbine.trit.org (Postfix) with ESMTP id 5A6BB3F5F; Sun, 21 Jul 2002 21:52:36 +0000 (UTC) To: Sheldon Hearn Cc: 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: <20020717162827.GA751@starjuice.net>; from sheldonh@starjuice.net on "Wed, 17 Jul 2002 18:28:27 +0200" Date: Sun, 21 Jul 2002 21:52:36 +0000 From: Dima Dorfman Message-Id: <20020721215236.5A6BB3F5F@turbine.trit.org> 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 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. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-current" in the body of the message