Skip site navigation (1)Skip section navigation (2)
Date:      Mon, 30 Dec 2002 19:05:39 +0100
From:      Igor Sobrado <sobrado@acm.org>
To:        FreeBSD-gnats-submit@FreeBSD.org
Subject:   docs/46637: hier(7) man page needs to be fixed
Message-ID:  <200212301805.gBUI5dT03876@string1.ciencias.uniovi.es>

next in thread | raw e-mail | index | archive | help

>Number:         46637
>Category:       docs
>Synopsis:       hier(7) man page needs to be fixed
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Dec 30 11:00:26 PST 2002
>Closed-Date:
>Last-Modified:
>Originator:     Igor Sobrado
>Release:        FreeBSD 4.6-RELEASE i386
>Organization:
University of Oviedo
>Environment:
System: FreeBSD localhost 4.6-RELEASE FreeBSD 4.6-RELEASE #0: Thu Oct 17 22:32:58 CEST 2002 root@:/usr/src/sys/compile/HP-OB4100 i386


>Description:

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?

>How-To-Repeat:

$ man hier

>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!
>Release-Note:
>Audit-Trail:
>Unformatted:
 SEND-PR: -*- send-pr -*-
 SEND-PR: Lines starting with `SEND-PR' will be removed automatically, as
 SEND-PR: will all comments (text enclosed in `<' and `>').
 SEND-PR:
 SEND-PR: Please consult the following URL if you are not sure how to
 SEND-PR: fill out a problem report:
 SEND-PR: http://www.freebsd.org/doc/en/articles/problem-reports/article.html
 SEND-PR:
 SEND-PR: Note that the Synopsis field is mandatory.
 SEND-PR:
 SEND-PR: Please note that (unless you state otherwise) if your report 
 SEND-PR: includes a patch then it will be taken under the same license as 
 SEND-PR: the one on the file(s) you want to change.
 SEND-PR:
 SEND-PR: BE ADVISED THAT FREEBSD PROBLEM REPORTS ARE PUBLIC INFORMATION AND
 SEND-PR: WILL BE PUBLISHED AS-IS ON THE PROJECT'S MAILING LISTS AND WEB SITES.
 SEND-PR: DO NOT SUBMIT ANY INFORMATION YOU DO NOT WANT MADE PUBLIC.
 SEND-PR:
 SEND-PR: For sensitive security issues, consider contacting the FreeBSD
 SEND-PR: security officer team (security-officer@freebsd.org) directly.
 SEND-PR:
 SEND-PR: Choose from the following categories:
 SEND-PR:
 SEND-PR: advocacy  alpha     bin       conf      docs      gnu       
 SEND-PR: i386      ia64      kern      misc      ports     powerpc   
 SEND-PR: sparc64   standards www       
 SEND-PR:
 To: FreeBSD-gnats-submit@freebsd.org
 From: Igor Sobrado <sobrado@acm.org>
 Reply-To: Igor Sobrado <sobrado@acm.org>
 Cc: 
 X-send-pr-version: 3.113
 X-GNATS-Notify: 
 
 

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200212301805.gBUI5dT03876>