From owner-freebsd-doc  Tue Jul 21 16:10:42 1998
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Received: (from majordom@localhost)
          by hub.freebsd.org (8.8.8/8.8.8) id QAA06702
          for freebsd-doc-outgoing; Tue, 21 Jul 1998 16:10:42 -0700 (PDT)
          (envelope-from owner-freebsd-doc@FreeBSD.ORG)
Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21])
          by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id QAA06682
          for <doc@FreeBSD.ORG>; Tue, 21 Jul 1998 16:10:33 -0700 (PDT)
          (envelope-from gnats@FreeBSD.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.8.8/8.8.5) id QAA26080;
	Tue, 21 Jul 1998 16:10:04 -0700 (PDT)
Received: (from nobody@localhost)
          by hub.freebsd.org (8.8.8/8.8.8) id QAA05996;
          Tue, 21 Jul 1998 16:06:49 -0700 (PDT)
          (envelope-from nobody)
Message-Id: <199807212306.QAA05996@hub.freebsd.org>
Date: Tue, 21 Jul 1998 16:06:49 -0700 (PDT)
From: wolman@cs.washington.edu
To: freebsd-gnats-submit@FreeBSD.ORG
X-Send-Pr-Version: www-1.0
Subject: docs/7359: amd documentation problems
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org


>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