Author: joel (doc committer) Date: Thu Mar 29 16:02:40 2012 New Revision: 233665 URL: http://svn.freebsd.org/changeset/base/233665
Log: mandoc complains loudly when <TAB>s are misused in columnated lists. Fix this syntax violation and while I'm here also convert <TAB> to Ta and adjust quotation marks in order to prevent this problem in the future. Modified: head/bin/ps/ps.1 head/lib/libc/posix1e/acl_add_flag_np.3 head/lib/libc/posix1e/acl_add_perm.3 head/lib/libc/posix1e/acl_set_entry_type_np.3 head/lib/libc/posix1e/acl_set_tag_type.3 head/lib/libc/posix1e/acl_to_text.3 head/lib/libc/sys/ktrace.2 head/lib/libutil/login.conf.5 head/usr.bin/rctl/rctl.8 Modified: head/bin/ps/ps.1 ============================================================================== --- head/bin/ps/ps.1 Thu Mar 29 15:47:29 2012 (r233664) +++ head/bin/ps/ps.1 Thu Mar 29 16:02:40 2012 (r233665) @@ -292,37 +292,37 @@ The flags associated with the process as the include file .In sys/proc.h : .Bl -column P_SINGLE_BOUNDARY 0x40000000 -.It Dv "P_ADVLOCK" Ta No "0x00001 Process may hold a POSIX advisory lock" -.It Dv "P_CONTROLT" Ta No "0x00002 Has a controlling terminal" -.It Dv "P_KTHREAD" Ta No "0x00004 Kernel thread" -.It Dv "P_FOLLOWFORK" Ta No "0x00008 Attach debugger to new children" -.It Dv "P_PPWAIT" Ta No "0x00010 Parent is waiting for child to exec/exit" -.It Dv "P_PROFIL" Ta No "0x00020 Has started profiling" -.It Dv "P_STOPPROF" Ta No "0x00040 Has thread in requesting to stop prof" -.It Dv "P_HADTHREADS" Ta No "0x00080 Has had threads (no cleanup shortcuts)" -.It Dv "P_SUGID" Ta No "0x00100 Had set id privileges since last exec" -.It Dv "P_SYSTEM" Ta No "0x00200 System proc: no sigs, stats or swapping" -.It Dv "P_SINGLE_EXIT" Ta No "0x00400 Threads suspending should exit, not wait" -.It Dv "P_TRACED" Ta No "0x00800 Debugged process being traced" -.It Dv "P_WAITED" Ta No "0x01000 Someone is waiting for us" -.It Dv "P_WEXIT" Ta No "0x02000 Working on exiting" -.It Dv "P_EXEC" Ta No "0x04000 Process called exec" -.It Dv "P_WKILLED" Ta No "0x08000 Killed, shall go to kernel/user boundary ASAP" -.It Dv "P_CONTINUED" Ta No "0x10000 Proc has continued from a stopped state" -.It Dv "P_STOPPED_SIG" Ta No "0x20000 Stopped due to SIGSTOP/SIGTSTP" -.It Dv "P_STOPPED_TRACE" Ta No "0x40000 Stopped because of tracing" -.It Dv "P_STOPPED_SINGLE" Ta No "0x80000 Only one thread can continue" -.It Dv "P_PROTECTED" Ta No "0x100000 Do not kill on memory overcommit" -.It Dv "P_SIGEVENT" Ta No "0x200000 Process pending signals changed" -.It Dv "P_SINGLE_BOUNDARY" Ta No "0x400000 Threads should suspend at user boundary" -.It Dv "P_HWPMC" Ta No "0x800000 Process is using HWPMCs" -.It Dv "P_JAILED" Ta No "0x1000000 Process is in jail" -.It Dv "P_ORPHAN" Ta No "0x2000000 Orphaned by original parent, reparented to debugger" -.It Dv "P_INEXEC" Ta No "0x4000000 Process is in execve()" -.It Dv "P_STATCHILD" Ta No "0x8000000 Child process stopped or exited" -.It Dv "P_INMEM" Ta No "0x10000000 Loaded into memory" -.It Dv "P_SWAPPINGOUT" Ta No "0x20000000 Process is being swapped out" -.It Dv "P_SWAPPINGIN" Ta No "0x40000000 Process is being swapped in" +.It Dv "P_ADVLOCK" Ta No "0x00001" Ta "Process may hold a POSIX advisory lock" +.It Dv "P_CONTROLT" Ta No "0x00002" Ta "Has a controlling terminal" +.It Dv "P_KTHREAD" Ta No "0x00004" Ta "Kernel thread" +.It Dv "P_FOLLOWFORK" Ta No "0x00008" Ta "Attach debugger to new children" +.It Dv "P_PPWAIT" Ta No "0x00010" Ta "Parent is waiting for child to exec/exit" +.It Dv "P_PROFIL" Ta No "0x00020" Ta "Has started profiling" +.It Dv "P_STOPPROF" Ta No "0x00040" Ta "Has thread in requesting to stop prof" +.It Dv "P_HADTHREADS" Ta No "0x00080" Ta "Has had threads (no cleanup shortcuts)" +.It Dv "P_SUGID" Ta No "0x00100" Ta "Had set id privileges since last exec" +.It Dv "P_SYSTEM" Ta No "0x00200" Ta "System proc: no sigs, stats or swapping" +.It Dv "P_SINGLE_EXIT" Ta No "0x00400" Ta "Threads suspending should exit, not wait" +.It Dv "P_TRACED" Ta No "0x00800" Ta "Debugged process being traced" +.It Dv "P_WAITED" Ta No "0x01000" Ta "Someone is waiting for us" +.It Dv "P_WEXIT" Ta No "0x02000" Ta "Working on exiting" +.It Dv "P_EXEC" Ta No "0x04000" Ta "Process called exec" +.It Dv "P_WKILLED" Ta No "0x08000" Ta "Killed, shall go to kernel/user boundary ASAP" +.It Dv "P_CONTINUED" Ta No "0x10000" Ta "Proc has continued from a stopped state" +.It Dv "P_STOPPED_SIG" Ta No "0x20000" Ta "Stopped due to SIGSTOP/SIGTSTP" +.It Dv "P_STOPPED_TRACE" Ta No "0x40000" Ta "Stopped because of tracing" +.It Dv "P_STOPPED_SINGLE" Ta No "0x80000" Ta "Only one thread can continue" +.It Dv "P_PROTECTED" Ta No "0x100000" Ta "Do not kill on memory overcommit" +.It Dv "P_SIGEVENT" Ta No "0x200000" Ta "Process pending signals changed" +.It Dv "P_SINGLE_BOUNDARY" Ta No "0x400000" Ta "Threads should suspend at user boundary" +.It Dv "P_HWPMC" Ta No "0x800000" Ta "Process is using HWPMCs" +.It Dv "P_JAILED" Ta No "0x1000000" Ta "Process is in jail" +.It Dv "P_ORPHAN" Ta No "0x2000000" Ta "Orphaned by original parent, reparented to debugger" +.It Dv "P_INEXEC" Ta No "0x4000000" Ta "Process is in execve()" +.It Dv "P_STATCHILD" Ta No "0x8000000" Ta "Child process stopped or exited" +.It Dv "P_INMEM" Ta No "0x10000000" Ta "Loaded into memory" +.It Dv "P_SWAPPINGOUT" Ta No "0x20000000" Ta "Process is being swapped out" +.It Dv "P_SWAPPINGIN" Ta No "0x40000000" Ta "Process is being swapped in" .El .It Cm label The MAC label of the process. Modified: head/lib/libc/posix1e/acl_add_flag_np.3 ============================================================================== --- head/lib/libc/posix1e/acl_add_flag_np.3 Thu Mar 29 15:47:29 2012 (r233664) +++ head/lib/libc/posix1e/acl_add_flag_np.3 Thu Mar 29 16:02:40 2012 (r233665) @@ -52,10 +52,10 @@ that already exist in the flagset. .Pp Valid values are: .Bl -column -offset 3n "ACL_ENTRY_NO_PROPAGATE_INHERIT" -.It ACL_ENTRY_FILE_INHERIT Will be inherited by files. -.It ACL_ENTRY_DIRECTORY_INHERIT Will be inherited by directories. -.It ACL_ENTRY_NO_PROPAGATE_INHERIT Will not propagate. -.It ACL_ENTRY_INHERIT_ONLY Inherit-only. +.It ACL_ENTRY_FILE_INHERIT Ta "Will be inherited by files." +.It ACL_ENTRY_DIRECTORY_INHERIT Ta "Will be inherited by directories." +.It ACL_ENTRY_NO_PROPAGATE_INHERIT Ta "Will not propagate." +.It ACL_ENTRY_INHERIT_ONLY Ta "Inherit-only." .El .Sh RETURN VALUES .Rv -std acl_add_flag_np Modified: head/lib/libc/posix1e/acl_add_perm.3 ============================================================================== --- head/lib/libc/posix1e/acl_add_perm.3 Thu Mar 29 15:47:29 2012 (r233664) +++ head/lib/libc/posix1e/acl_add_perm.3 Thu Mar 29 16:02:40 2012 (r233665) @@ -59,22 +59,22 @@ For POSIX.1e ACLs, valid values are: .Pp For NFSv4 ACLs, valid values are: .Bl -column -offset 3n "ACL_WRITE_NAMED_ATTRS" -.It ACL_READ_DATA Read permission -.It ACL_LIST_DIRECTORY Same as ACL_READ_DATA -.It ACL_WRITE_DATA Write permission, or permission to create files -.It ACL_ADD_FILE Same as ACL_READ_DATA -.It ACL_APPEND_DATA Permission to create directories. Ignored for files -.It ACL_ADD_SUBDIRECTORY Same as ACL_APPEND_DATA -.It ACL_READ_NAMED_ATTRS Ignored -.It ACL_WRITE_NAMED_ATTRS Ignored -.It ACL_EXECUTE Execute permission -.It ACL_DELETE_CHILD Permission to delete files and subdirectories -.It ACL_READ_ATTRIBUTES Permission to read basic attributes -.It ACL_WRITE_ATTRIBUTES Permission to change basic attributes -.It ACL_DELETE Permission to delete the object this ACL is placed on -.It ACL_READ_ACL Permission to read ACL -.It ACL_WRITE_ACL Permission to change the ACL and file mode -.It ACL_SYNCHRONIZE Ignored +.It ACL_READ_DATA Ta "Read permission" +.It ACL_LIST_DIRECTORY Ta "Same as ACL_READ_DATA" +.It ACL_WRITE_DATA Ta "Write permission, or permission to create files" +.It ACL_ADD_FILE Ta "Same as ACL_READ_DATA" +.It ACL_APPEND_DATA Ta "Permission to create directories. Ignored for files" +.It ACL_ADD_SUBDIRECTORY Ta "Same as ACL_APPEND_DATA" +.It ACL_READ_NAMED_ATTRS Ta "Ignored" +.It ACL_WRITE_NAMED_ATTRS Ta "Ignored" +.It ACL_EXECUTE Ta "Execute permission" +.It ACL_DELETE_CHILD Ta "Permission to delete files and subdirectories" +.It ACL_READ_ATTRIBUTES Ta "Permission to read basic attributes" +.It ACL_WRITE_ATTRIBUTES Ta "Permission to change basic attributes" +.It ACL_DELETE Ta "Permission to delete the object this ACL is placed on" +.It ACL_READ_ACL Ta "Permission to read ACL" +.It ACL_WRITE_ACL Ta "Permission to change the ACL and file mode" +.It ACL_SYNCHRONIZE Ta "Ignored" .El .Pp Calling Modified: head/lib/libc/posix1e/acl_set_entry_type_np.3 ============================================================================== --- head/lib/libc/posix1e/acl_set_entry_type_np.3 Thu Mar 29 15:47:29 2012 (r233664) +++ head/lib/libc/posix1e/acl_set_entry_type_np.3 Thu Mar 29 16:02:40 2012 (r233665) @@ -49,8 +49,8 @@ to the value referred to by .Pp Valid values are: .Bl -column -offset 3n "ACL_ENTRY_TYPE_ALLOW" -.It ACL_ENTRY_TYPE_ALLOW "allow" type entry -.It ACL_ENTRY_TYPE_DENY "deny" type entry +.It ACL_ENTRY_TYPE_ALLOW Ta "allow" type entry +.It ACL_ENTRY_TYPE_DENY Ta "deny" type entry .El .Pp This call brands the ACL as NFSv4. Modified: head/lib/libc/posix1e/acl_set_tag_type.3 ============================================================================== --- head/lib/libc/posix1e/acl_set_tag_type.3 Thu Mar 29 15:47:29 2012 (r233664) +++ head/lib/libc/posix1e/acl_set_tag_type.3 Thu Mar 29 16:02:40 2012 (r233665) @@ -49,14 +49,14 @@ to the value of .Pp Valid values are: .Bl -column -offset 3n "ACL_OTHER_OBJ" -.It ACL_USER_OBJ Permissions apply to file owner -.It ACL_USER Permissions apply to additional user specified by qualifier -.It ACL_GROUP_OBJ Permissions apply to file group -.It ACL_GROUP Permissions apply to additional group specified by qualifier -.It ACL_MASK Permissions specify mask -.It ACL_OTHER Permissions apply to "other" -.It ACL_OTHER_OBJ Same as ACL_OTHER -.It ACL_EVERYONE Permissions apply to "everyone@" +.It ACL_USER_OBJ Ta "Permissions apply to file owner" +.It ACL_USER Ta "Permissions apply to additional user specified by qualifier" +.It ACL_GROUP_OBJ Ta "Permissions apply to file group" +.It ACL_GROUP Ta "Permissions apply to additional group specified by qualifier" +.It ACL_MASK Ta "Permissions specify mask" +.It ACL_OTHER Ta Permissions apply to "other" +.It ACL_OTHER_OBJ Ta "Same as ACL_OTHER" +.It ACL_EVERYONE Ta Permissions apply to "everyone@" .El .Pp Calling Modified: head/lib/libc/posix1e/acl_to_text.3 ============================================================================== --- head/lib/libc/posix1e/acl_to_text.3 Thu Mar 29 15:47:29 2012 (r233664) +++ head/lib/libc/posix1e/acl_to_text.3 Thu Mar 29 16:02:40 2012 (r233665) @@ -67,9 +67,9 @@ The flags specified are formed by .Em or Ns 'ing the following values .Bl -column -offset 3n "ACL_TEXT_NUMERIC_IDS" -.It ACL_TEXT_VERBOSE Format ACL using verbose form -.It ACL_TEXT_NUMERIC_IDS Do not resolve IDs into user or group names -.It ACL_TEXT_APPEND_ID In addition to user and group names, append numeric IDs +.It ACL_TEXT_VERBOSE Ta "Format ACL using verbose form" +.It ACL_TEXT_NUMERIC_IDS Ta "Do not resolve IDs into user or group names" +.It ACL_TEXT_APPEND_ID Ta "In addition to user and group names, append numeric IDs" .El .Pp This function allocates any memory necessary to contain the string and Modified: head/lib/libc/sys/ktrace.2 ============================================================================== --- head/lib/libc/sys/ktrace.2 Thu Mar 29 15:47:29 2012 (r233664) +++ head/lib/libc/sys/ktrace.2 Thu Mar 29 16:02:40 2012 (r233665) @@ -67,12 +67,12 @@ The argument specifies the requested ktrace operation. The defined operations are: .Bl -column KTRFLAG_DESCENDXXX -offset indent -.It "KTROP_SET Enable trace points specified in" +.It KTROP_SET Ta "Enable trace points specified in" .Fa trpoints . -.It "KTROP_CLEAR Disable trace points specified in" +.It KTROP_CLEAR Ta "Disable trace points specified in" .Fa trpoints . -.It "KTROP_CLEARFILE Stop all tracing." -.It "KTRFLAG_DESCEND The tracing change should apply to the" +.It KTROP_CLEARFILE Ta "Stop all tracing." +.It KTRFLAG_DESCEND Ta "The tracing change should apply to the" specified process and all its current children. .El .Pp @@ -81,20 +81,20 @@ The argument specifies the trace points of interest. The defined trace points are: .Bl -column KTRFAC_PROCCTORXXX -offset indent -.It "KTRFAC_SYSCALL Trace system calls." -.It "KTRFAC_SYSRET Trace return values from system calls." -.It "KTRFAC_NAMEI Trace name lookup operations." -.It "KTRFAC_GENIO Trace all I/O (note that this option can" +.It KTRFAC_SYSCALL Ta "Trace system calls." +.It KTRFAC_SYSRET Ta "Trace return values from system calls." +.It KTRFAC_NAMEI Ta "Trace name lookup operations." +.It KTRFAC_GENIO Ta "Trace all I/O (note that this option can" generate much output). -.It "KTRFAC_PSIG Trace posted signals." -.It "KTRFAC_CSW Trace context switch points." -.It "KTRFAC_USER Trace application-specific events." -.It "KTRFAC_STRUCT Trace certain data structures." -.It "KTRFAC_SYSCTL Trace sysctls." -.It "KTRFAC_PROCCTOR Trace process construction." -.It "KTRFAC_PROCDTOR Trace process destruction." -.It "KTRFAC_CAPFAIL Trace capability failures." -.It "KTRFAC_INHERIT Inherit tracing to future children." +.It KTRFAC_PSIG Ta "Trace posted signals." +.It KTRFAC_CSW Ta "Trace context switch points." +.It KTRFAC_USER Ta "Trace application-specific events." +.It KTRFAC_STRUCT Ta "Trace certain data structures." +.It KTRFAC_SYSCTL Ta "Trace sysctls." +.It KTRFAC_PROCCTOR Ta "Trace process construction." +.It KTRFAC_PROCDTOR Ta "Trace process destruction." +.It KTRFAC_CAPFAIL Ta "Trace capability failures." +.It KTRFAC_INHERIT Ta "Inherit tracing to future children." .El .Pp Each tracing event outputs a record composed of a generic header Modified: head/lib/libutil/login.conf.5 ============================================================================== --- head/lib/libutil/login.conf.5 Thu Mar 29 15:47:29 2012 (r233664) +++ head/lib/libutil/login.conf.5 Thu Mar 29 16:02:40 2012 (r233665) @@ -224,7 +224,7 @@ directory of the user. See .Xr ftpd 8 for details. -.It "label string Default MAC policy; see" +.It "label string Default MAC policy; see" .Xr maclabel 7 . .It "lang string Set $LANG environment variable to the specified value. .It "manpath path Default search path for manpages. Modified: head/usr.bin/rctl/rctl.8 ============================================================================== --- head/usr.bin/rctl/rctl.8 Thu Mar 29 15:47:29 2012 (r233664) +++ head/usr.bin/rctl/rctl.8 Thu Mar 29 16:02:40 2012 (r233665) @@ -121,33 +121,33 @@ A filter that matches all defined rules "::maxproc". .Sh RESOURCES .Bl -column -offset 3n "pseudoterminals" -.It "cputime CPU time, in seconds" -.It "datasize data size, in bytes" -.It "stacksize stack size, in bytes" -.It "coredumpsize core dump size, in bytes" -.It "memoryuse resident set size, in bytes" -.It "memorylocked locked memory, in bytes" -.It "maxproc number of processes" -.It "openfiles file descriptor table size" -.It "vmemoryuse address space limit, in bytes" -.It "pseudoterminals number of PTYs" -.It "swapuse swap usage, in bytes" -.It "nthr number of threads" -.It "msgqqueued number of queued SysV messages" -.It "msgqsize SysV message queue size, in bytes" -.It "nmsgq number of SysV message queues" -.It "nsem number of SysV semaphores" -.It "nsemop number of SysV semaphores modified in a single semop(2) call" -.It "nshm number of SysV shared memory segments" -.It "shmsize SysV shared memory size, in bytes" -.It "wallclock wallclock time, in seconds" +.It cputime Ta "CPU time, in seconds" +.It datasize Ta "data size, in bytes" +.It stacksize Ta "stack size, in bytes" +.It coredumpsize Ta "core dump size, in bytes" +.It memoryuse Ta "resident set size, in bytes" +.It memorylocked Ta "locked memory, in bytes" +.It maxproc Ta "number of processes" +.It openfiles Ta "file descriptor table size" +.It vmemoryuse Ta "address space limit, in bytes" +.It pseudoterminals Ta "number of PTYs" +.It swapuse Ta "swap usage, in bytes" +.It nthr Ta "number of threads" +.It msgqqueued Ta "number of queued SysV messages" +.It msgqsize Ta "SysV message queue size, in bytes" +.It nmsgq Ta "number of SysV message queues" +.It nsem Ta "number of SysV semaphores" +.It nsemop Ta "number of SysV semaphores modified in a single semop(2) call" +.It nshm Ta "number of SysV shared memory segments" +.It shmsize Ta "SysV shared memory size, in bytes" +.It wallclock Ta "wallclock time, in seconds" .El .Pp .Sh ACTIONS .Bl -column -offset 3n "pseudoterminals" -.It "deny deny the allocation; not supported for cpu and wallclock" -.It "log log a warning to the console" -.It "devctl send notification to" +.It deny Ta "deny the allocation; not supported for cpu and wallclock" +.It log Ta "log a warning to the console" +.It devctl Ta "send notification to" .Xr devd 8 .It "sig* e.g. sigterm; send a signal to the offending process" .El _______________________________________________ svn-src-all@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
