From owner-freebsd-bugs  Sun May  4 00:50:08 1997
Return-Path: <owner-bugs>
Received: (from root@localhost)
          by hub.freebsd.org (8.8.5/8.8.5) id AAA14202
          for bugs-outgoing; Sun, 4 May 1997 00:50:08 -0700 (PDT)
Received: (from gnats@localhost)
          by hub.freebsd.org (8.8.5/8.8.5) id AAA14182;
          Sun, 4 May 1997 00:50:06 -0700 (PDT)
Resent-Date: Sun, 4 May 1997 00:50:06 -0700 (PDT)
Resent-Message-Id: <199705040750.AAA14182@hub.freebsd.org>
Resent-From: gnats (GNATS Management)
Resent-To: freebsd-bugs
Resent-Reply-To: FreeBSD-gnats@FreeBSD.ORG, k-horik@yk.rim.or.jp
Received: from mail.yk.rim.or.jp (root@mail.yk.rim.or.jp [202.247.130.37])
          by hub.freebsd.org (8.8.5/8.8.5) with ESMTP id AAA14110
          for <FreeBSD-gnats-submit@freebsd.org>; Sun, 4 May 1997 00:49:50 -0700 (PDT)
Received: from localhost (ppp308.yk.rim.or.jp [202.247.165.8]) by mail.yk.rim.or.jp (8.8.5/3.4Wbeta6-rim1.1) with ESMTP id QAA17795; Sun, 4 May 1997 16:49:48 +0900 (JST)
Message-Id: <199705040749.QAA17795@mail.yk.rim.or.jp>
Date: Sun, 04 May 1997 16:49:12 +0900
From: k-horik@yk.rim.or.jp
Reply-To: k-horik@yk.rim.or.jp
To: FreeBSD-gnats-submit@FreeBSD.ORG
X-Send-Pr-Version: 3.2
Subject: docs/3490: mount.8 manpage refinement abount Nm and Xr macro
Sender: owner-bugs@FreeBSD.ORG
X-Loop: FreeBSD.org
Precedence: bulk


>Number:         3490
>Category:       docs
>Synopsis:       mount.8 manpage refinement about Nm and Xr macro
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-bugs
>State:          open
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun May  4 00:50:05 PDT 1997
>Last-Modified:
>Originator:     Kazuo Horikawa
>Organization:
<Organization of PR author (multiple lines)>
>Release:        FreeBSD 2.2.1-RELEASE i386
>Environment:

.\"     @(#)mount.8     8.7 (Berkeley) 3/27/94
.\"     $Id: mount.8,v 1.11.2.1 1996/11/10 12:13:27 phk Exp $

>Description:

	I think that the command name should be with Nm macro.
	I think that Xr macro with section# is better than Xr macro
	without section#.

>How-To-Repeat:

	<Code/input/activities to reproduce the problem (multiple lines)>

>Fix:
	
--- -	Sun May  4 16:24:12 1997
+++ mount.8	Thu May  1 22:42:42 1997
@@ -132,7 +132,7 @@
 Do not allow set-user-identifier or set-group-identifier bits to take effect.
 Note: this option is worthless if a public available suid or sgid
 wrapper like
-.Xr suidperl
+.Xr suidperl 1
 is installed on your system.
 .It rdonly
 The same as
@@ -163,7 +163,9 @@
 .Dq \&-
 (dash).
 Options that take a value are specified using the syntax -option=value.
-For example, the mount command:
+For example, the 
+.Nm mount
+command:
 .Bd -literal -offset indent
 mount -t mfs -o nosuid,-N,-s=4000 /dev/dk0b /tmp
 .Ed
@@ -217,7 +219,8 @@
 .Tn MFS .
 .Pp
 If the type is not one of the internally known types,
-mount will attempt to execute a program in
+.Nm mount
+will attempt to execute a program in
 .Pa /sbin/mount_ Ns Em XXX
 where
 .Em XXX
@@ -255,7 +258,7 @@
 flag is also specified.
 The set of options is determined by first extracting the options
 for the file system from the
-.Xr fstab
+.Xr fstab 5
 table,
 then applying any options specified by the
 .Fl o
>Audit-Trail:
>Unformatted: