From owner-freebsd-doc Mon Jan 1 17:10:13 2001 From owner-freebsd-doc@FreeBSD.ORG Mon Jan 1 17:10:09 2001 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21]) by hub.freebsd.org (Postfix) with ESMTP id 1D2DB37B402 for ; Mon, 1 Jan 2001 17:10:09 -0800 (PST) Received: (from gnats@localhost) by freefall.freebsd.org (8.11.1/8.11.1) id f021A9l60437; Mon, 1 Jan 2001 17:10:09 -0800 (PST) (envelope-from gnats) Resent-Date: Mon, 1 Jan 2001 17:10:09 -0800 (PST) Resent-Message-Id: <200101020110.f021A9l60437@freefall.freebsd.org> Resent-From: gnats-admin@FreeBSD.org (GNATS Management) Resent-To: freebsd-doc@freebsd.org Resent-Reply-To: gnats-admin@FreeBSD.org, rdm@cfcl.com Received: from cfcl.com (unknown [24.221.169.54]) by hub.freebsd.org (Postfix) with ESMTP id 8131237B400 for ; Mon, 1 Jan 2001 17:03:03 -0800 (PST) Received: (from rdm@localhost) by cfcl.com (8.9.3/8.9.3) id RAA26884; Mon, 1 Jan 2001 17:02:56 -0800 (PST) (envelope-from rdm) Message-Id: <200101020102.RAA26884@cfcl.com> Date: Mon, 1 Jan 2001 17:02:56 -0800 (PST) From: Rich Morin Reply-To: rdm@cfcl.com To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.2 Subject: docs/24010: assorted problems with hier(7) man page Resent-Sender: gnats@FreeBSD.org Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 24010 >Category: docs >Synopsis: assorted problems with hier(7) man page >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Mon Jan 01 17:10:01 PST 2001 >Closed-Date: >Last-Modified: >Originator: Rich Morin >Release: FreeBSD 4.1-RELEASE i386 >Organization: Canta Forda Computer Laboratory >Environment: FreeBSD cfcl.com 4.1-RELEASE FreeBSD 4.1-RELEASE #0: Fri Jul 28 14:30:31 GMT 2000 jkh@ref4.freebsd.org:/usr/src/sys/compile/GENERIC i386 >Description: This PR contains a variety of problems that are related to the hier(7) manual page. Once these problems are fixed, it might be nice to spruce up the page's format a bit... There are no listings for /usr/include/dev/{ppbus,ntfs,nwfs}. "msdosfs/ Chatacter set conversion tables" --- "msdosfs/ Character set conversion tables" There are no listings for /usr/libdata/{doscmd,doscmd/fonts, ldscripts} and no information in the /usr/libdata/gcc entry. "stallion/ holding the download firmware images" --- "stallion/ download images for Stallion firmware; see stlload(8)" There is no real information in the libdata/tcl entry. There are no listings for /usr/libexec/{lpr/ru,sendmail}. The entry for /usr/local is a bit garbled and incomplete. How about: local/ local executables, libraries, etc. Also used as the default destination for the FreeBSD ports framework. local/ should use the general layout sketched out by hier(7) for /usr. Exceptions are the man directory (directly under local/, rather than under local/share/), ports documentation (in share/doc//), and /usr/local/etc (mimics /etc). In /usr, the "ports" entry should be "ports/" (it's a directory). /usr/share/fonts has questions marks for its description; the actual directory is empty. Wazzup? /usr/share/locale is described as being for "internationalization files"; isn't it actually used for "localization files"? /usr/share/misc/termcap is described, but does not seem to exist. There is no listing for /usr/tmp. The listings in /usr/share/dict are not sorted alphabetically. Also, neither /usr/share/dict/{papers,special} seem to exist. The entry for /usr/share/doc has several problems. It lists "FAQ", rather than "faq" and totally fails to list a number of entries. "syscons/ console staff; see syscons(4)" --- "syscons/ console stuff; see syscons(4)" "src/ BSD and/or local source files" --- "src/ BSD, third-party, and/or local source files" Also, the /usr/src/{crypto,secure} entries should be "crypto/" and "secure/" (they are directories). There is no entry for /usr/src/CVS. The entry for /usr/src/contrib should read "src for file from contributed software" --- "src for files from contributed software" "tools used for maintaince and testing of FreeBSD" --- "tools used for maintenance and testing of FreeBSD" "architecture independant files" --- "architecture-independent files" The entry for /var/crash should read "default drectory to store kernel crash dumps; ..." --- "default directory to store kernel crash dumps; ..." There is no text in the description line for /var/cron. The entry for /var/cron/log is in error; this file is now in /var/log. There are entries for /var/quotas and /var/spool/secretmail, but no such directories exist. >How-To-Repeat: man hier >Fix: Edit the hier(7) man page. >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message