path: root/patches/procps-3.2.8/0047-pgrep.1.patch

From c55f0fd0d7758cc170ef72fce0d4a66d3200906f Mon Sep 17 00:00:00 2001
From: http://ftp.de.debian.org/debian/pool/main/p/procps/procps_3.2.8-8.debian.tar.gz <info@debian.org>
Date: Fri, 19 Mar 2010 21:58:46 +0100
Subject: [PATCH 47/70] pgrep.1

Uses .BR for see also section #437678
---
 pgrep.1 |   98 +++++++++++++++++++++++++++++++++++++-------------------------
 1 files changed, 58 insertions(+), 40 deletions(-)

diff --git a/pgrep.1 b/pgrep.1
index 9152799..257a6ce 100644
--- a/pgrep.1
+++ b/pgrep.1
@@ -2,35 +2,39 @@
 .\" Licensed under version 2 of the GNU General Public License.
 .\" Copyright 2000 Kjetil Torgrim Homme
 .\"
-.TH PGREP 1 "June 25, 2000" "Linux" "Linux User's Manual"
+.TH PGREP 1 "October 5, 2007" "Linux" "Linux User's Manual"
 .SH NAME
 pgrep, pkill \- look up or signal processes based on name and other attributes
 
 .SH SYNOPSIS
-pgrep [\-cflvx] [\-d \fIdelimiter\fP] [\-n|\-o] [\-P \fIppid\fP,...] [\-g \fIpgrp\fP,...]
-.br
-	[\-s \fIsid\fP,...] [\-u \fIeuid\fP,...] [\-U \fIuid\fP,...] [\-G \fIgid\fP,...]
-.br
-	[\-t \fIterm\fP,...] [\fIpattern\fP]
-
-pkill [\-\fIsignal\fP] [\-fvx] [\-n|\-o] [\-P \fIppid\fP,...] [\-g \fIpgrp\fP,...]
-.br
-	[\-s \fIsid\fP,...] [\-u \fIeuid\fP,...] [\-U \fIuid\fP,...] [\-G \fIgid\fP,...]
-.br
-	[\-t \fIterm\fP,...] [\fIpattern\fP]
+.na
+\fBpgrep\fR [\fB\-cflvx\fR] [\fB\-d\ \fIdelimiter\fR] [\fB\-n\fR|\fB\-o\fR] \
+[\fB\-P\ \fIppid\fR,...] [\fB\-g\ \fIpgrp\fR,...] [\fB\-s\ \fIsid\fR,...] \
+[\fB\-u\ \fIeuid\fR,...] [\fB\-U\ \fIuid\fR,...] [\fB\-G\ \fIgid\fR,...] \
+[\fB\-t\ \fIterm\fR,...] [\fIpattern\fR]
+
+.HP
+\fBpkill\fR [\fB\-\fIsignal\fR] [\fB\-fvx\fR] [\fB\-n\fR|\fB\-o\fR] \
+[\fB\-P\ \fIppid\fR,...] [\fB\-g\ \fIpgrp\fR,...] [\fB\-s\ \fIsid\fR,...] \
+[\fB\-u\ \fIeuid\fR,...] [\fB\-U\ \fIuid\fR,...] [\fB\-G\ \fIgid\fR,...] \
+[\fB\-t\ \fIterm\fR,...] [\fIpattern\fR]
 
 .SH DESCRIPTION
 \fBpgrep\fP looks through the currently running processes and lists the
 process IDs which matches the selection criteria to stdout.  All
 the criteria have to match.  For example,
 
-pgrep -u root sshd
+.IP
+$ pgrep \-u root sshd
 
+.PP
 will only list the processes called \fBsshd\fP AND owned by \fBroot\fP.
 On the other hand,
 
-pgrep -u root,daemon
+.IP
+$ pgrep \-u root,daemon
 
+.PP
 will list the processes owned by \fBroot\fP OR \fBdaemon\fP.
 
 \fBpkill\fP will send the specified signal (by default \fBSIGTERM\fP)
@@ -38,18 +42,18 @@ to each process instead of listing them on stdout.
 
 .SH OPTIONS
 .TP
-\-c
+\fB\-c\fR
 Suppress normal output; instead print a count of matching processes.
 .TP
-\-d \fIdelimiter\fP
+\fB\-d \fIdelimiter\fP
 Sets the string used to delimit each process ID in the output (by
 default a newline).  (\fBpgrep\fP only.)
 .TP
-\-f
+\fB\-f\fR
 The \fIpattern\fP is normally only matched against the process name.
-When \-f is set, the full command line is used.
+When \fB\-f\fR is set, the full command line is used.
 .TP
-\-g \fIpgrp\fP,...
+\fB\-g \fIpgrp\fP,...
 Only match processes in the process group IDs listed.  Process group 0
 is translated into \fBpgrep\fP's or \fBpkill\fP's own process group.
 .TP
@@ -57,40 +61,40 @@ is translated into \fBpgrep\fP's or \fBpkill\fP's own process group.
 Only match processes whose real group ID is listed.  Either the
 numerical or symbolical value may be used.
 .TP
-\-l
+\fB\-l\fR
 List the process name as well as the process ID. (\fBpgrep\fP only.)
 .TP
-\-n
+\fB\-n\fR
 Select only the newest (most recently started) of the matching
 processes.
 .TP
-\-o
+\fB\-o\fR
 Select only the oldest (least recently started) of the matching
 processes.
 .TP
-\-P \fIppid\fP,...
+\fB\-P \fIppid\fP,...
 Only match processes whose parent process ID is listed.
 .TP
-\-s \fIsid\fP,...
+\fB\-s \fIsid\fP,...
 Only match processes whose process session ID is listed.  Session ID 0
 is translated into \fBpgrep\fP's or \fBpkill\fP's own session ID.
 .TP
-\-t \fIterm\fP,...
+\fB\-t \fIterm\fP,...
 Only match processes whose controlling terminal is listed.  The
 terminal name should be specified without the "/dev/" prefix.
 .TP
-\-u \fIeuid\fP,...
+\fB\-u \fIeuid\fP,...
 Only match processes whose effective user ID is listed.  Either the
 numerical or symbolical value may be used.
 .TP
-\-U \fIuid\fP,...
+\fB\-U \fIuid\fP,...
 Only match processes whose real user ID is listed.  Either the
 numerical or symbolical value may be used.
 .TP
-\-v
+\fB\-v\fR
 Negates the matching.
 .TP
-\-x
+\fB\-x\fR
 Only match processes whose name (or command line if \-f is specified)
 \fBexactly\fP match the \fIpattern\fP.
 .TP
@@ -107,32 +111,40 @@ process names or command lines.
 .SH EXAMPLES
 Example 1: Find the process ID of the \fBnamed\fP daemon:
 
-unix$ pgrep \-u root named
+.IP
+$ pgrep \-u root named
 
+.PP
 Example 2: Make \fBsyslog\fP reread its configuration file:
 
-unix$ pkill \-HUP syslogd
+.IP
+$ pkill \-HUP syslogd
 
+.PP
 Example 3: Give detailed information on all \fBxterm\fP processes:
 
-unix$ ps \-fp $(pgrep \-d, \-x xterm)
+.IP
+$ ps \-fp $(pgrep \-d, \-x xterm)
 
+.PP
 Example 4: Make all \fBnetscape\fP processes run nicer:
 
-unix$ renice +4 `pgrep netscape`
+.IP
+$ renice +4 `pgrep netscape`
 
 .SH "EXIT STATUS"
+.PD 0
 .TP
-.I "0"
+.I 0
 One or more processes matched the criteria.
 .TP
-.I "1"
+.I 1
 No processes matched.
 .TP
-.I "2"
+.I 2
 Syntax error in the command line.
 .TP
-.I "3"
+.I 3
 Fatal error: out of memory etc.
 
 .SH NOTES
@@ -144,13 +156,19 @@ The running \fBpgrep\fP or \fBpkill\fP process will never report
 itself as a match.
 
 .SH BUGS
-The options \-n and \-o and \-v can not be combined.  Let me know if
-you need to do this.
+The options \fB\-n\fP and \fB\-o\fP and \fB\-v\fP can not be combined.
+Let me know if you need to do this.
 
 Defunct processes are reported.
 
 .SH "SEE ALSO"
-ps(1) regex(7) signal(7) killall(1) skill(1) kill(1) kill(2)
+.BR ps (1),
+.BR regex (7),
+.BR signal (7),
+.BR killall (1),
+.BR skill (1),
+.BR kill (1),
+.BR kill (2)
 
 .SH STANDARDS
 \fBpkill\fP and \fBpgrep\fP were introduced in Sun's Solaris 7.  This
-- 
1.7.0