Yet more doc update backporting

FossilOrigin-Name: 437d4766e451250d467d2b0c470b7c21a7ac2e2c

1 files changed, 15 insertions, 2 deletions

diff --git a/doc/pid.n b/doc/pid.n
index f835b5e..9811cb7 100644
--- a/doc/pid.n
+++ b/doc/pid.n
@@ -5,14 +5,14 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\" 
-'\" RCS: @(#) $Id: pid.n,v 1.3 2000/09/07 14:27:50 poenitz Exp $
+'\" RCS: @(#) $Id: pid.n,v 1.3.18.1 2004/10/27 14:23:57 dkf Exp $
 '\" 
 .so man.macros
 .TH pid n 7.0 Tcl "Tcl Built-In Commands"
 .BS
 '\" Note:  do not modify the .SH NAME line immediately below!
 .SH NAME
-pid \- Retrieve process id(s)
+pid \- Retrieve process identifiers
 .SH SYNOPSIS
 \fBpid \fR?\fIfileId\fR?
 .BE
@@ -29,6 +29,19 @@ that isn't a process pipeline.
 If no \fIfileId\fR argument is given then \fBpid\fR returns the process
 identifier of the current process.
 All process identifiers are returned as decimal strings.
+.SH EXAMPLE
+Print process information about the processes in a pipeline using the
+SysV \fBps\fR program before reading the output of that pipeline:
+.PP
+.CS
+set pipeline [open "| zcat somefile.gz | grep foobar | sort -u"]
+# Print process information
+exec ps -fp [\fBpid\fR $pipeline] >@stdout
+# Print a separator and then the output of the pipeline
+puts [string repeat - 70]
+puts [read $pipeline]
+close $pipeline
+.CE
 
 .SH "SEE ALSO"
 exec(n), open(n)