summaryrefslogtreecommitdiffstats
path: root/doc/pwd.n
diff options
context:
space:
mode:
authordkf <donal.k.fellows@manchester.ac.uk>2004-05-28 12:23:50 (GMT)
committerdkf <donal.k.fellows@manchester.ac.uk>2004-05-28 12:23:50 (GMT)
commit0cb68aa767f2457c65b8cbc4d27c29545da80744 (patch)
tree3b4395dea7450721ae8d0c5a74fdb25d861d56d6 /doc/pwd.n
parent335355daaf50f042b321f273165959f0898c8185 (diff)
downloadtcl-0cb68aa767f2457c65b8cbc4d27c29545da80744.zip
tcl-0cb68aa767f2457c65b8cbc4d27c29545da80744.tar.gz
tcl-0cb68aa767f2457c65b8cbc4d27c29545da80744.tar.bz2
Added example
Diffstat (limited to 'doc/pwd.n')
-rw-r--r--doc/pwd.n16
1 files changed, 15 insertions, 1 deletions
diff --git a/doc/pwd.n b/doc/pwd.n
index 22ec376..ac86847 100644
--- a/doc/pwd.n
+++ b/doc/pwd.n
@@ -5,7 +5,7 @@
'\" 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.4 2004/05/28 12:30:04 dkf Exp $
'\"
.so man.macros
.TH pwd n "" Tcl "Tcl Built-In Commands"
@@ -20,6 +20,20 @@ pwd \- Return the current working directory
.SH DESCRIPTION
.PP
Returns the 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)