From nobody  Tue Jul 21 16:06:49 1998
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
Subject: amd documentation problems
X-Send-Pr-Version: www-1.0

>Number:         7359
>Category:       docs
>Synopsis:       amd documentation problems
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    obrien
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          sw-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Jul 21 16:10:01 PDT 1998
>Closed-Date:    Sun May 2 01:09:49 PDT 1999
>Last-Modified:  Sun May  2 01:12:12 PDT 1999
>Originator:     Alec Wolman
>Release:        3.0CAM-19980712-SNAP
>Organization:
University of Washington
>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.

>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->obrien 
Responsible-Changed-By: obrien 
Responsible-Changed-When: Fri Nov 20 00:04:44 PST 1998 
Responsible-Changed-Why:  
I seem to be Mr. Amd. 
State-Changed-From-To: open->closed 
State-Changed-By: obrien 
State-Changed-When: Sun May 2 01:09:49 PDT 1999 
State-Changed-Why:  
Mention of /usr/share/info/am-utils was added to /usr/share/doc/smm/contents.ascii.gz 
Also the am-utils.info now documents the "resvport" option. 
>Unformatted:
