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 <current@FreeBSD.ORG>; 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 <current@FreeBSD.ORG>; 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 <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 )
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 <phk@critter.freebsd.dk>
Sender: owner-freebsd-current@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-current.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20freebsd-current>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20freebsd-current>
X-Loop: FreeBSD.ORG
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