Enhance the explanation of using filesystem-specific mount options

in /etc/fstab.  We do support passing special options on a per
filesystem type basis, like `-u UID -g GID' for mount_msdosfs, but
the syntax of these options in fstab is non-obvious and a lot of
users have asked about it.

PR:		docs/128816
Submitted by:	Roland Smith, rsmith at xs4all dot nl
MFC after:	2 days

1 files changed, 28 insertions, 3 deletions

diff --git a/share/man/man5/fstab.5 b/share/man/man5/fstab.5
index 45802fc..5c7406f 100644
--- a/share/man/man5/fstab.5
+++ b/share/man/man5/fstab.5
@@ -32,7 +32,7 @@
 .\"     @(#)fstab.5	8.1 (Berkeley) 6/5/93
 .\" $FreeBSD$
 .\"
-.Dd February 11, 2008
+.Dd November 23, 2008
 .Dt FSTAB 5
 .Os
 .Sh NAME
@@ -91,8 +91,7 @@ describes the mount options associated with the file system.
 It is formatted as a comma separated list of options.
 It contains at least the type of mount (see
 .Fa fs_type
-below) plus any additional options
-appropriate to the file system type.
+below) plus any additional options appropriate to the file system type.
 See the options flag
 .Pq Fl o
 in the
@@ -100,6 +99,32 @@ in the
 page and the file system specific page, such as
 .Xr mount_nfs 8 ,
 for additional options that may be specified.
+All options that can be given to the file system specific mount commands
+can be used in
+.Nm
+as well.
+They just need to be formatted a bit differently.
+The arguments of the
+.Fl o
+option can be used without the preceding
+.Fl o
+flag.
+Other options need both the file system specific flag and its argument,
+separated by an equal sign.
+For example, mounting an
+.Xr msdosfs 5
+filesystem, the options
+.Bd -literal -offset indent
+-o sync -o noatime -m 644 -M 755 -u foo -g bar
+.Ed
+.Pp
+should be written as
+.Bd -literal -offset indent
+sync,noatime,-m=644,-M=755,-u=foo,-g=bar
+.Ed
+.Pp
+in the option field of
+.Nm .
 .Pp
 If the options ``userquota'' and/or ``groupquota'' are specified,
 the file system is automatically processed by the