path: root/bin/pwd
diff options
authorSheldon Hearn <sheldonh@FreeBSD.org>1999-09-08 15:40:46 +0000
committerSheldon Hearn <sheldonh@FreeBSD.org>1999-09-08 15:40:46 +0000
commitc644db6aa2307baa08e3b3e7143b20cf12d7aaa1 (patch)
tree450c1984c59205f991b47c9161042ddd5e9ae260 /bin/pwd
parent518dee7dbbc81ff945a452d9710e98c4e2d600e4 (diff)
Improve shell documentation:
* Consistently misspell built-in as builtin. * Add a builtin(1) manpage and create builtin(1) MLINKS for all shell builtin commands for which no standalone utility exists. These MLINKS replace those that were created for csh(1). * Add appropriate xrefs for builtin(1) to the csh(1) and sh(1) manpages, as well as to the manpages of standalone utilities which are supported as shell builtin commands in at least one of the shells. In such manpages, explain that similar functionality may be provided as a shell builtin command. * Improve sh(1)'s description of the cd builtin command. Csh(1) already describes it adequately. Replace the cd(1) manpage with a builtin(1) MLINKS link. * Clean up some mdoc problems: use Xr instead of literal "foo(n)"; use Ic instead of Xr for shell builtin commands. * Undo English contractions. Reviewed by: mpp, rgrimes
Notes: svn path=/head/; revision=51090
Diffstat (limited to 'bin/pwd')
1 files changed, 13 insertions, 3 deletions
diff --git a/bin/pwd/pwd.1 b/bin/pwd/pwd.1
index 27150e66ca6f..4eaed1d069ce 100644
--- a/bin/pwd/pwd.1
+++ b/bin/pwd/pwd.1
@@ -47,6 +47,13 @@
.Nm Pwd
writes the absolute pathname of the current working directory to
the standard output.
+Some shells may provide a builtin
+command which is similar or identical to this utility. Consult
+.Xr builtin 1
+manual page.
@@ -58,14 +65,17 @@ utility is expected to be
.St -p1003.2
+.Xr builtin 1 ,
.Xr cd 1 ,
.Xr csh 1 ,
-.Xr getcwd 3
+.Xr getcwd 3 ,
+.Xr sh 1
.Xr csh 1
the command
.Ic dirs
-is always faster (although it can give a different answer in the rare case
+is always faster because it is built into that shell. However,
+it can give a different answer in the rare case
that the current directory or a containing directory was moved after
-the shell descended into it).
+the shell descended into it.