[src/trunk]: src/sbin/mount_ntfs Rework the manpage to be a bit more pleasing...

[jdolecek <jdolecek%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/6144e49f11ad
branches:  trunk
changeset: 479675:6144e49f11ad
user:      jdolecek <jdolecek%NetBSD.org@localhost>
date:      Fri Dec 17 14:43:07 1999 +0000

description:
Rework the manpage to be a bit more pleasing to read

BUGS section is gone, the facts are stated in the paragraph about
support for writing.
also note that NetBSD 1.5 is the first release supporting NTFS

diffstat:

 sbin/mount_ntfs/mount_ntfs.8 |  42 +++++++++++++++++++++---------------------
 1 files changed, 21 insertions(+), 21 deletions(-)

diffs (82 lines):

diff -r f23ded0b6547 -r 6144e49f11ad sbin/mount_ntfs/mount_ntfs.8
--- a/sbin/mount_ntfs/mount_ntfs.8      Fri Dec 17 14:37:15 1999 +0000
+++ b/sbin/mount_ntfs/mount_ntfs.8      Fri Dec 17 14:43:07 1999 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: mount_ntfs.8,v 1.5 1999/09/12 18:47:11 kleink Exp $
+.\" $NetBSD: mount_ntfs.8,v 1.6 1999/12/17 14:43:07 jdolecek Exp $
 .\"
 .\" Copyright (c) 1993,1994 Christopher G. Demetriou
 .\" Copyright (c) 1999 Semen Ustimenko
@@ -83,7 +83,8 @@
 in the file system.
 .El
 .Sh FEATURES
-NTFS file attributes are accessed in following way:
+.Ss NTFS file attributes
+NTFS file attributes can be accessed in following way:
 .Bd -literal -offset indent
 foo[[:ATTRTYPE]:ATTRNAME]
 .Ed
@@ -93,12 +94,8 @@
 volume. Default is $DATA.
 .Sq ATTRNAME
 is an attribute name. Default is none.
-.Sh EXAMPLES
-To mount an ntfs volume located in 
-.Pa /dev/wd1s1 :
-.Bd -literal -offset indent
-# mount_ntfs /dev/wd1s1 /mnt
-.Ed
+.Pp
+.Sy Examples:
 .Pp
 To get volume name (in Unicode):
 .Bd -literal -offset indent
@@ -110,31 +107,34 @@
 # cat /mnt/foodir:\\$INDEX_ROOT:\\$I30
 .Ed
 .Pp
-.Sh WRITING
-There is limited writing ability. Limitations: file must be nonresident
-and must not contain any holes (uninitialized areas), compressed
-files are not supported either.
+.Ss Limited support for writing
+There is limited writing ability. Limitations: file must be nonresident,
+must not contain any holes (uninitialized areas) and can't be compressed.
+.Pp
+.Sy Warning:
+while read-only mode appears to be very stable and there are
+no known problems, the read-write mode
+has not been very well tested yet and it may well be possible
+that an attempt to write into file residing on NTFS could
+damage the filesystem. Don't experiment with read-write mode unless
+you are ready to recover the trashed contents any time.
 .Sh SEE ALSO
 .Xr mount 2 ,
 .Xr unmount 2 ,
 .Xr fstab 5 ,
 .Xr mount 8
-.Sh BUGS
-Note that NTFS support is still very experimental on NetBSD and
-should be used with extreme caution. Do not mount NTFS volumes read-write
-unless you are ready to recreate trashed contents.
 .Sh HISTORY
-The
-.Nm
-first appeared in
+Support for NTFS first appeared in
 .Fx 3.0 .
+It has been ported to NetBSD and first appeared here in
+.Nx 1.5 .
 .Sh AUTHOR
 NTFS kernel implementation,
 .Nm
-and manual were written by
+and this manual were originally written by
 .An Semen Ustimenko Aq semenu%FreeBSD.org@localhost .
 
-NetBSD port by
+NetBSD port was done by
 .An Christos Zoulas Aq christos%NetBSD.org@localhost
 and
 .An Jaromir Dolecek Aq jdolecek%NetBSD.org@localhost .