[src/trunk]: src/share/man/man9 Use more markup. Add "flag" in a sentence.

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

details:   https://anonhg.NetBSD.org/src/rev/1d93e03a8086
branches:  trunk
changeset: 793658:1d93e03a8086
user:      wiz <wiz%NetBSD.org@localhost>
date:      Sat Feb 22 11:28:18 2014 +0000

description:
Use more markup. Add "flag" in a sentence.

diffstat:

 share/man/man9/vnode.9 |  142 ++++++++++++++++++++++++++----------------------
 1 files changed, 77 insertions(+), 65 deletions(-)

diffs (250 lines):

diff -r 8c4c805077ab -r 1d93e03a8086 share/man/man9/vnode.9
--- a/share/man/man9/vnode.9    Sat Feb 22 11:08:05 2014 +0000
+++ b/share/man/man9/vnode.9    Sat Feb 22 11:28:18 2014 +0000
@@ -1,4 +1,4 @@
-.\"     $NetBSD: vnode.9,v 1.58 2014/02/22 10:08:12 hannken Exp $
+.\"     $NetBSD: vnode.9,v 1.59 2014/02/22 11:28:18 wiz Exp $
 .\"
 .\" Copyright (c) 2001, 2005, 2006 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -189,48 +189,51 @@
 .Em v_uflag .
 Valid flags are:
 .Pp
-.Bl -tag -offset indent -width VONWORKLST -compact
-.It VV_ROOT
+.Bl -tag -offset indent -width ".Dv VI_WRMAPDIRTY" -compact
+.It Dv VV_ROOT
 This vnode is the root of its file system.
-.It VV_SYSTEM
+.It Dv VV_SYSTEM
 This vnode is being used by the kernel; only used to skip quota files in
 .Fn vflush .
-.It VV_ISTTY
+.It Dv VV_ISTTY
 This vnode represents a tty; used when reading dead vnodes.
-.It VV_MAPPED
+.It Dv VV_MAPPED
 This vnode might have user mappings.
-.It VV_MPSAFE
+.It Dv VV_MPSAFE
 This file system is MP safe.
-.It VV_LOCKSWORK
+.It Dv VV_LOCKSWORK
 This vnode's file system supports locking.
-.It VI_TEXT
+.It Dv VI_TEXT
 This vnode is a pure text prototype.
-.It VI_EXECMAP
+.It Dv VI_EXECMAP
 This vnode has executable mappings.
-.It VI_WRMAP
+.It Dv VI_WRMAP
 This vnode might have PROT_WRITE user mappings.
-.It VI_WRMAPDIRTY
-This vnode might have dirty pages due to VWRITEMAP
-.It VI_XLOCK
+.It Dv VI_WRMAPDIRTY
+This vnode might have dirty pages due to
+.Dv VWRITEMAP .
+.It Dv VI_XLOCK
 This vnode is currently locked to change underlying type.
-.It VI_ONWORKLST
+.It Dv VI_ONWORKLST
 This vnode is on syncer work-list.
-.It VI_MARKER
+.It Dv VI_MARKER
 A dummy marker vnode.
-.It VI_LAYER
+.It Dv VI_LAYER
 This vnode is on a layered file system.
-.It VI_LOCKSHARE
+.It Dv VI_LOCKSHARE
 This vnode shares its
 .Em v_interlock
 with other vnodes.
-.It VI_CLEAN
+.It Dv VI_CLEAN
 This vnode has been reclaimed and is no longer attached to a file system.
-.It VU_DIROP
+.It Dv VU_DIROP
 This vnode is involved in a directory operation.
 This flag is used exclusively by LFS.
 .El
 .Pp
-The VI_XLOCK flag is used to prevent multiple processes from entering
+The
+.Dv VI_XLOCK
+flag is used to prevent multiple processes from entering
 the vnode reclamation code.
 It is also used as a flag to indicate that reclamation is in progress.
 Before
@@ -345,23 +348,23 @@
 Valid types are:
 .Pp
 .Bl -tag -offset indent -width VFIFO -compact
-.It VNON
+.It Dv VNON
 The vnode has no type.
-.It VREG
+.It Dv VREG
 The vnode represents a regular file.
-.It VDIR
+.It Dv VDIR
 The vnode represents a directory.
-.It VBLK
+.It Dv VBLK
 The vnode represents a block special device.
-.It VCHR
+.It Dv VCHR
 The vnode represents a character special device.
-.It VLNK
+.It Dv VLNK
 The vnode represents a symbolic link.
-.It VSOCK
+.It Dv VSOCK
 The vnode represents a socket.
-.It VFIFO
+.It Dv VFIFO
 The vnode represents a pipe.
-.It VBAD
+.It Dv VBAD
 The vnode represents a bad file (not currently used).
 .El
 .Pp
@@ -378,59 +381,59 @@
 Valid tag types are:
 .Pp
 .Bl -tag -offset indent -width "VT_FILECORE " -compact
-.It VT_NON
+.It Dv VT_NON
 non file system
-.It VT_UFS
+.It Dv VT_UFS
 universal file system
-.It VT_NFS
+.It Dv VT_NFS
 network file system
-.It VT_MFS
+.It Dv VT_MFS
 memory file system
-.It VT_MSDOSFS
+.It Dv VT_MSDOSFS
 FAT file system
-.It VT_LFS
+.It Dv VT_LFS
 log-structured file system
-.It VT_LOFS
+.It Dv VT_LOFS
 loopback file system
-.It VT_FDESC
+.It Dv VT_FDESC
 file descriptor file system
-.It VT_NULL
+.It Dv VT_NULL
 null file system layer
-.It VT_UMAP
+.It Dv VT_UMAP
 uid/gid remapping file system layer
-.It VT_KERNFS
+.It Dv VT_KERNFS
 kernel interface file system
-.It VT_PROCFS
+.It Dv VT_PROCFS
 process interface file system
-.It VT_AFS
+.It Dv VT_AFS
 AFS file system
-.It VT_ISOFS
+.It Dv VT_ISOFS
 ISO 9660 file system(s)
-.It VT_UNION
+.It Dv VT_UNION
 union file system
-.It VT_ADOSFS
+.It Dv VT_ADOSFS
 Amiga file system
-.It VT_EXT2FS
+.It Dv VT_EXT2FS
 Linux's ext2 file system
-.It VT_CODA
+.It Dv VT_CODA
 Coda file system
-.It VT_FILECORE
+.It Dv VT_FILECORE
 filecore file system
-.It VT_NTFS
+.It Dv VT_NTFS
 Microsoft NT's file system
-.It VT_VFS
+.It Dv VT_VFS
 virtual file system
-.It VT_OVERLAY
+.It Dv VT_OVERLAY
 overlay file system
-.It VT_SMBFS
+.It Dv VT_SMBFS
 SMB file system
-.It VT_PTYFS
+.It Dv VT_PTYFS
 pseudo-terminal device file system
-.It VT_TMPFS
+.It Dv VT_TMPFS
 efficient memory file system
-.It VT_UDF
+.It Dv VT_UDF
 universal disk format file system
-.It VT_SYSVBFS
+.It Dv VT_SYSVBFS
 systemV boot file system
 .El
 .Pp
@@ -531,8 +534,8 @@
 .Xr rwlock 9
 flags used to lock the vnode.
 If the
-.Em VI_XLOCK
-is set in
+.Dv VI_XLOCK
+flag is set in
 .Fa vp Ns 's
 .Em v_flag ,
 vnode
@@ -639,14 +642,21 @@
 .Fa flags
 is a set of flags modifying the operation of
 .Fn vflush .
-If FORCECLOSE is not specified, there should not be any active vnodes and
+If
+.Dv FORCECLOSE
+is not specified, there should not be any active vnodes and
 the error
 .Er EBUSY
 is returned if any are found (this is a user error, not a system error).
-If FORCECLOSE is specified, active vnodes that are found are detached.
-If WRITECLOSE is set, only flush out regular file vnodes open for
-writing.
-SKIPSYSTEM causes any vnodes marked V_SYSTEM to be skipped.
+If
+.Dv FORCECLOSE
+is specified, active vnodes that are found are detached.
+If
+.Dv WRITECLOSE
+is set, only flush out regular file vnodes open for writing.
+SKIPSYSTEM causes any vnodes marked
+.Dv V_SYSTEM
+to be skipped.
 .It Fn vaccess "type" "file_mode" "uid" "gid" "acc_mode" "cred"
 Do access checking by comparing the file's permissions to the caller's
 desired access type
@@ -680,7 +690,9 @@
 .Em bp-\*[Gt]b_vp
 and do a wakeup if requested and
 .Em vp-\*[Gt]vflag
-has VBWAIT set.
+has
+.Dv VBWAIT
+set.
 .It Fn vflushbuf "vp" "sync"
 Flush all dirty buffers to disk for the file with the locked vnode
 .Fa vp .