Date: Fri, 25 Aug 2000 10:00:05 -0700 (PDT) From: bmah@cisco.com (Bruce A. Mah) To: freebsd-doc@freebsd.org Subject: Re: docs/20814: mount opt "intr" for nfs mounts undocumented in fstab.5 Message-ID: <200008251700.KAA78761@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
The following reply was made to PR docs/20814; it has been noted by GNATS. From: bmah@cisco.com (Bruce A. Mah) To: Sheldon Hearn <sheldonh@uunet.co.za> Cc: bmah@freebsd.org, freebsd-gnats-submit@freebsd.org Subject: Re: docs/20814: mount opt "intr" for nfs mounts undocumented in fstab.5 Date: Fri, 25 Aug 2000 09:53:37 -0700 If memory serves me right, Sheldon Hearn wrote: > If you agree with me so far, then you may want to take a stab at fixing > the mount_nfs(8) manual page. I've taken a two minute look, and no > elegant solution sprang to mind. :-) I was about to write up some changes, but then I found PR docs/735, which addressed this very same issue (and in fact, is what led to the "deprecated" options being listed in mount_nfs in the first place). After reading this (and the mount(8) manpage) very carefully, I've come to realize that actually specifying "intr" in fstab is in fact *wrong*. Instead, one should use the "dashed" option, e.g.: server:/remote/fs /local/fs nfs ro,-i 0 0 As I read the PR and manpage, the only reason we support "intr" is for compatability with other versions of mount_nfs(8) (e.g. Solaris's mount_nfs(8) uses this option syntax). Using the "dashed" style options is preferred, presumably because it's easy to tell at a glance which options apply to all VFS types and which ones apply to only a particular type of filesystem. So I've changed my stance on this. In my opinion, only a small clarifying change is needed to the mount(8) manpage...to specifically tell people to look in filesystem-specific manpages to see the options for a given filesystem. I suggest the patch below, with the caveat that I can't quite figure out how to get the .Xr macro to Do What I Want(TM) (i.e. I want part of a manpage cross-reference in emphasized text). Do you know how to do this? Index: mount.8 =================================================================== RCS file: /home/ncvs/src/sbin/mount/mount.8,v retrieving revision 1.32 diff -c -r1.32 mount.8 *** mount.8 2000/04/30 22:08:13 1.32 --- mount.8 2000/08/25 16:46:49 *************** *** 228,233 **** --- 228,243 ---- .Bd -literal -offset indent /sbin/mount_mfs -o nosuid -N -s 4000 /dev/dk0b /tmp .Ed + .Pp + Options that pertain to a given filesystem type are described + in the + .Xr mount_ Ns Em XXX 8 + manual page, where + .Em XXX + is replaced by the type name. + For example, the options specific to NFS filesystems are described in the + .Xr mount_nfs 8 + manual page. .It Fl p Print mount information in fstab format. Implies also the *************** *** 321,330 **** Verbose mode. .It Fl w The file system object is to be read and write. - .Pp - The options specific to NFS filesystems are described in the - .Xr mount_nfs 8 - manual page. .Sh DIAGNOSTICS Various, most of them are self-explanatory. .Pp --- 331,336 ---- Thanks, Bruce. 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?200008251700.KAA78761>