Date: Tue, 21 Jul 1998 16:06:49 -0700 (PDT) From: wolman@cs.washington.edu To: freebsd-gnats-submit@FreeBSD.ORG Subject: docs/7359: amd documentation problems Message-ID: <199807212306.QAA05996@hub.freebsd.org>
next in thread | raw e-mail | index | archive | help
>Number: 7359
>Category: docs
>Synopsis: amd documentation problems
>Confidential: no
>Severity: non-critical
>Priority: medium
>Responsible: freebsd-doc
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: sw-bug
>Submitter-Id: current-users
>Arrival-Date: Tue Jul 21 16:10:01 PDT 1998
>Last-Modified:
>Originator: Alec Wolman
>Organization:
University of Washington
>Release: 3.0CAM-19980712-SNAP
>Environment:
FreeBSD laver.cs.washington.edu 3.0CAM-19980712-SNAP FreeBSD 3.0CAM-19980712-SNAP #0: Fri Jul 17 22:55:05 PDT 1998
wolman@laver.cs.washington.edu:/usr/src/sys/compile/LAVER i386
>Description:
The amd documentation is somewhat of a mess:
- the /usr/share/doc/smm directory has a file contents.ascii.gz which
claims that there ought to be a 13.amd directory with the AMD
manual in it. But it isn't there.
- the man page for amd refers you to a document called
"Amd - The 4.4 BSD Automounter" but it doesn't tell you where to
find it. I finally found it in the /usr/share/info directory.
- neither the man page, nor the amd manual in /usr/share/info makes
any mention of the "resvport" option. I spent a long time trying
to figure out why amd mount-maps which worked fine on other
platforms were not working properly on FreeBSD. Finally, someone
mentioned to me that the "resvport" option was needed for FreeBSD
clients but I never could have figured that out on my own.
>How-To-Repeat:
see above.
>Fix:
Perhaps the "CAVEATS" portion of the amd manual page could mention
the "resvport" option to save people from the trouble I went through.
Also, update the manual page to include the location of the amd manual
in /usr/share/info. Finally, remove mention of the amd documentation
in /usr/share/doc/smm/contents.ascii.gz or put a pointer in 13.amd
pointing people at the /usr/share/info directory.
>Audit-Trail:
>Unformatted:
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?199807212306.QAA05996>