Subject: misc/19609: hier(7) man page has some errors
To: None <>
From: None <>
List: netbsd-bugs
Date: 12/30/2002 09:23:02
>Number:         19609
>Category:       misc
>Synopsis:       hier(7) man page has some errors
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    misc-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Mon Dec 30 09:24:01 PST 2002
>Originator:     Igor Sobrado
>Release:        1.6
University of Oviedo
NetBSD ns1.localnet 1.6 NetBSD 1.6 (GENERIC) #0: Sun Sep  8 19:43:40 UTC 2002 i386

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).