Yet more doc update backporting

1 files changed, 17 insertions, 3 deletions

diff --git a/doc/pwd.n b/doc/pwd.n
index 22ec376..4f3dcd6 100644
--- a/doc/pwd.n
+++ b/doc/pwd.n
@@ -5,21 +5,35 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\" 
-'\" RCS: @(#) $Id: pwd.n,v 1.3 2000/09/07 14:27:50 poenitz Exp $
+'\" RCS: @(#) $Id: pwd.n,v 1.3.18.1 2004/10/27 14:23:57 dkf Exp $
 '\" 
 .so man.macros
 .TH pwd n "" Tcl "Tcl Built-In Commands"
 .BS
 '\" Note:  do not modify the .SH NAME line immediately below!
 .SH NAME
-pwd \- Return the current working directory
+pwd \- Return the absolute path of the current working directory
 .SH SYNOPSIS
 \fBpwd\fR
 .BE
 
 .SH DESCRIPTION
 .PP
-Returns the path name of the current working directory.
+Returns the absolute path name of the current working directory.
+.SH EXAMPLE
+Sometimes it is useful to change to a known directory when running
+some external command using \fBexec\fR, but it is important to keep
+the application usually running in the directory that it was started
+in (unless the user specifies otherwise) since that minimises user
+confusion. The way to do this is to save the current directory while
+the external command is being run:
+.CS
+set tarFile [file normalize somefile.tar]
+set savedDir [\fBpwd\fR]
+cd /tmp
+exec tar -xf $tarFile
+cd $savedDir
+.CE
 
 .SH "SEE ALSO"
 file(n), cd(n), glob(n), filename(n)