[src/trunk]: src/usr.bin/find Use -compact + explicit .Pp instead of .sp with...

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

details:   https://anonhg.NetBSD.org/src/rev/1131a36b817e
branches:  trunk
changeset: 748172:1131a36b817e
user:      joerg <joerg%NetBSD.org@localhost>
date:      Thu Oct 15 02:26:38 2009 +0000

description:
Use -compact + explicit .Pp instead of .sp with negative line length.

diffstat:

 usr.bin/find/find.1 |  47 +++++++++++++++++++++++++++++++++++++++++++----
 1 files changed, 43 insertions(+), 4 deletions(-)

diffs (289 lines):

diff -r 6d22ce0c750e -r 1131a36b817e usr.bin/find/find.1
--- a/usr.bin/find/find.1       Thu Oct 15 02:18:22 2009 +0000
+++ b/usr.bin/find/find.1       Thu Oct 15 02:26:38 2009 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: find.1,v 1.67 2009/01/04 12:13:56 wiz Exp $
+.\"    $NetBSD: find.1,v 1.68 2009/10/15 02:26:38 joerg Exp $
 .\"
 .\" Copyright (c) 1990, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -179,22 +179,25 @@
 Does not list mount points to other file systems.
 .El
 .Sh PRIMARIES
-.Bl -tag -width Ds
+.Bl -tag -width Ds -compact
 .It Ic -amin Ar n
 True if the difference between the file last access time and the time
 .Nm
 was started, rounded up to the next full minute, is
 .Ar n
 minutes.
+.Pp
 .It Ic -anewer Ar file
 True if the current file has a more recent last access time than
 .Ar file  .
+.Pp
 .It Ic -atime Ar n
 True if the difference between the file last access time and the time
 .Nm
 was started, rounded up to the next full 24-hour period, is
 .Ar n
 24-hour periods.
+.Pp
 .It Ic -cmin Ar n
 True if the difference between the time of last change of file status
 information and the time
@@ -202,9 +205,11 @@
 was started, rounded up to the next full minute, is
 .Ar n
 minutes.
+.Pp
 .It Ic -cnewer Ar file
 True if the current file has a more recent last change time than
 .Ar file  .
+.Pp
 .It Ic -ctime Ar n
 True if the difference between the time of last change of file status
 information and the time
@@ -212,6 +217,7 @@
 was started, rounded up to the next full 24-hour period, is
 .Ar n
 24-hour periods.
+.Pp
 .It Ic -delete
 Delete found files and/or directories.
 Always returns True.
@@ -226,11 +232,11 @@
 Depth-first traversal processing is implied by this option.
 This can also be invoked as
 .Ic -rm .
+.Pp
 .It Ic -empty
 True if the current file or directory is empty.
-.\" The ".sp" below is probably not the right way to get the desired effect.
+.Pp
 .It Ic -exec Ar utility Oo argument ... Oc No ;
-.sp -1l
 .It Ic -exec Ar utility Oo argument ... Oc No {} +
 Execute the specified
 .Ar utility
@@ -274,6 +280,7 @@
 .Ar utility
 does not exceed
 .Dv ARG_MAX .
+.Pp
 .It Ic -execdir Ar utility Oo argument ... Oc No ;
 The
 .Ic -execdir
@@ -291,6 +298,7 @@
 Set aggregation
 .Pq Do \&+ Dc termination
 is not supported.
+.Pp
 .It Ic -exit Op Ar n
 This primary causes
 .Nm
@@ -299,6 +307,7 @@
 If no value is specified, the exit value will be 0, else
 .Ar n .
 Note that other primaries will be evaluated and acted upon before exiting.
+.Pp
 .It Ic -false
 This primary always evaluates to false.
 This can be used following a primary that caused the
@@ -308,6 +317,7 @@
 primary so it can continue to the next expression (using an
 .Cm -or
 operator, for example).
+.Pp
 .It Ic -flags Oo Fl Oc Ns Ar flags
 If
 .Ar flags
@@ -331,8 +341,10 @@
 (See
 .Xr chflags 1
 for more information about file flags.)
+.Pp
 .It Ic -follow
 Follow symbolic links.
+.Pp
 .It Ic -fprint Ar filename
 This primary always evaluates to true.
 This creates
@@ -342,6 +354,7 @@
 It writes the pathname of the current file to this file, followed
 by a newline character.
 The file will be empty if no files are matched.
+.Pp
 .It Ic -fstype Ar type
 True if the file is contained in a file system of type
 .Ar type .
@@ -362,6 +375,7 @@
 .Nm
 is being executed, and the latter matches any file system which is
 mounted read-only.
+.Pp
 .It Ic -group Ar gname
 True if the file belongs to the group
 .Ar gname  .
@@ -370,14 +384,17 @@
 is numeric and there is no such group name, then
 .Ar gname
 is treated as a group id.
+.Pp
 .It Ic -iname Ar pattern
 True if the last component of the pathname being examined
 matches
 .Ar pattern .
 Case insensitive.
+.Pp
 .It Ic -inum Ar n
 True if the file has inode number
 .Ar n  .
+.Pp
 .It Ic -iregex Ar regexp
 True if the path name of the current file matches the case-insensitive
 basic regular expression
@@ -385,13 +402,16 @@
 .Ar regexp .
 This is a match on the whole path, not a search for the regular expression
 within the path.
+.Pp
 .It Ic -links Ar n
 True if the file has
 .Ar n
 links.
+.Pp
 .It Ic -rm
 This is an alias for
 .Ic -delete .
+.Pp
 .It Ic -ls
 This primary always evaluates to true.
 The following information for the current file is written to standard output:
@@ -404,24 +424,29 @@
 .Dq -\*[Gt] .
 The format is identical to that produced by
 .Dq ls -dgils .
+.Pp
 .It Ic -maxdepth Ar n
 True if the current search depth is less than or equal to what is specified in
 .Ar n .
+.Pp
 .It Ic -mindepth Ar n
 True if the current search depth is at least what is specified in
 .Ar n .
+.Pp
 .It Ic -mmin Ar n
 True if the difference between the file last modification time and the time
 .Nm
 was started, rounded up to the next full minute, is
 .Ar n
 minutes.
+.Pp
 .It Ic -mtime Ar n
 True if the difference between the file last modification time and the time
 .Nm
 was started, rounded up to the next full 24-hour period, is
 .Ar n
 24-hour periods.
+.Pp
 .It Ic -ok Ar utility Oo argument ... Oc No ;
 The
 .Ic -ok
@@ -441,6 +466,7 @@
 Set aggregation
 .Pq Do \&+ Dc termination
 is not supported.
+.Pp
 .It Ic -name Ar pattern
 True if the last component of the pathname being examined matches
 .Ar pattern  .
@@ -456,13 +482,17 @@
 These characters may be matched explicitly by escaping them with a
 backslash
 .Pq Dq \e .
+.Pp
 .It Ic -newer Ar file
 True if the current file has a more recent last modification time than
 .Ar file  .
+.Pp
 .It Ic -nouser
 True if the file belongs to an unknown user.
+.Pp
 .It Ic -nogroup
 True if the file belongs to an unknown group.
+.Pp
 .It Ic -path Ar pattern
 True if the pathname being examined matches
 .Ar pattern  .
@@ -483,6 +513,7 @@
 .Pq Dq /
 are treated as normal characters and do not have to be
 matched explicitly.
+.Pp
 .It Ic -perm Oo Fl Oc Ns Ar mode
 The
 .Ar mode
@@ -514,6 +545,7 @@
 the bits in the mode exactly match the file's mode bits.
 Note, the first character of a symbolic mode may not be a dash
 .Pq Dq - .
+.Pp
 .It Ic -print
 This primary always evaluates to true.
 It prints the pathname of the current file to standard output, followed
@@ -530,10 +562,12 @@
 is specified, the given expression shall be effectively replaced by
 .Cm \&( Ns Ar given\& expression Ns Cm \&)
 .Ic -print .
+.Pp
 .It Ic -print0
 This primary always evaluates to true.
 It prints the pathname of the current file to standard output, followed
 by a null character.
+.Pp
 .It Ic -printx
 This primary always evaluates to true.
 It prints the pathname of the current file to standard output,
@@ -542,6 +576,7 @@
 .Nm find
 can safely be used as input to
 .Nm xargs .
+.Pp
 .It Ic -prune
 This primary always evaluates to true.
 It causes
@@ -552,6 +587,7 @@
 primary has no effect if the
 .Fl d
 option was specified.
+.Pp
 .It Ic -regex Ar regexp
 True if the path name of the current file matches the case-sensitive
 basic regular expression
@@ -559,6 +595,7 @@
 .Ar regexp .
 This is a match on the whole path, not a search for the regular expression
 within the path.
+.Pp
 .It Ic -size Ar n Ns Op Cm c
 True if the file's size, rounded up, in 512-byte blocks is
 .Ar n  .
@@ -569,6 +606,7 @@
 then the primary is true if the file's size is
 .Ar n
 bytes.
+.Pp
 .It Ic -type Ar t
 True if the file is of the specified type.
 Possible file types are as follows:
@@ -602,6 +640,7 @@
 is numeric and there is no such user name, then
 .Ar uname
 is treated as a user id (and considered a numeric argument).
+.Pp
 .It Ic -xdev
 This primary always evaluates to true.
 It causes find not to descend past directories that have a different