Bug 46637

Summary: hier(7) man page needs to be fixed
Product: Documentation Reporter: Igor Sobrado <sobrado>
Component: Books & ArticlesAssignee: Ceri Davies <ceri>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description Igor Sobrado 2002-12-30 19:00:26 UTC
The FreeBSD 4.6-RELEASE hier(7) man page has some errors.  Improvements
to that man page are possible too.  Other FreeBSD releases are affected
too.

Errors:  I am aware that not all the entries in this man page are
available in every FreeBSD system.  But the next entries are wrong:

  /usr/heimdal - should be /var/heimdal

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:

  /mnt - should be before /modules
  /usr/include/netnatm - should be before /usr/include/netns
  /usr/share/dict/papers - is it in the wrong place?!?
  /usr/X11R6 - should it be at the before /usr/bin?
  /var/preserve - is it in wrong place too?

Fix: 

Only small changes to /usr/share/man/man7/hier.7.gz are required.
It should be easy to change in the CVS tree before releasing the
next major release of FreeBSD.

Thanks a lot for your attention and for maintaining one of the
finest operating systems available today!
How-To-Repeat: 
$ man hier
Comment 1 Ceri Davies freebsd_committer freebsd_triage 2003-01-02 12:53:38 UTC
State Changed
From-To: open->analyzed

The changes sound appropriate, especially the /var/heimdal one. 


Comment 2 Ceri Davies freebsd_committer freebsd_triage 2003-01-02 12:53:38 UTC
Responsible Changed
From-To: freebsd-doc->ceri

I'll take care of this.
Comment 3 Ceri Davies freebsd_committer freebsd_triage 2003-01-10 18:33:00 UTC
State Changed
From-To: analyzed->patched

Fixes committed to HEAD, thanks for your submission.
Comment 4 Ceri Davies freebsd_committer freebsd_triage 2003-01-13 21:44:06 UTC
State Changed
From-To: patched->closed

Changes were MFC'd.