Subject: misc/19609: hier(7) man page has some errors
To: None <firstname.lastname@example.org>
From: None <email@example.com>
Date: 12/30/2002 09:23:02
>Synopsis: hier(7) man page has some errors
>Arrival-Date: Mon Dec 30 09:24:01 PST 2002
>Originator: Igor Sobrado
University of Oviedo
NetBSD ns1.localnet 1.6 NetBSD 1.6 (GENERIC) #0: Sun Sep 8 19:43:40 UTC 2002
The NetBSD 1.6 hier(7) man page has some errors. Some improvements
to that man page are possible too.
Errors: I am aware that not all entries in this man page are
available in every system. But the next entries are wrong:
/usr/lkm - the loadable kernel modules directory should exist,
the interface and other lkm-related entries are described.
Improvements: I have observed that most entries are in alphabetical
order. It is nice, as simplifies looking for the description of a
file, directory, or filesystem. It makes the general layout of this
page similar to the default layout of the filesystem hierarchy
as shown by ls(1). But some entries are NOT in alphabetical order:
/dev/fd - must be placed after /dev/drum
/dev/null - must be placed after /dev/mem
/etc/master.passwd, /etc/passwd, /etc/pwd.db, /etc/spwd.db - are in
the wrong place too, a description of each file should be nice
too (the only way to know the differences between pwd.db and
spwd.db is reading the pwd_mkdb(8) man page).
/etc/rc.* - same about those entries
/root/.rhosts - perhaps it is in the wrong place (except if we
want to group the start-up files together.)
/usr/include/natm - is it in the wrong place too?
/usr/local/libdata - is in the wrong place?
/usr/pkg/sbin - is it in the wrong place?
/usr/pkg/libdata - is it in the wrong place?
/usr/obj - is it in wrong place?
/usr/share/dict/* - are in the wrong order?
/usr/src and its subdirectories should follow the same
layout as, for example, /usr/local and its subdirectories.
/usr/src/distrib - is it in the wrong place?
/usr/src/ntfs - is in the wrong order?
$ man hier
A simple change to /usr/share/man/man7/hier.7, followed by catman(8).