summaryrefslogtreecommitdiffstats
path: root/bin/pwd
diff options
context:
space:
mode:
authorsheldonh <sheldonh@FreeBSD.org>1999-09-08 15:40:46 +0000
committersheldonh <sheldonh@FreeBSD.org>1999-09-08 15:40:46 +0000
commit4000b20086a217a75f246e176f2d220b6e8eeffa (patch)
tree60b6258ec72b0294c12843bbe00547545be80b8d /bin/pwd
parentbca542bac3fb5d5874b9ed3bbf6243272a8492c0 (diff)
downloadFreeBSD-src-4000b20086a217a75f246e176f2d220b6e8eeffa.zip
FreeBSD-src-4000b20086a217a75f246e176f2d220b6e8eeffa.tar.gz
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
Diffstat (limited to 'bin/pwd')
-rw-r--r--bin/pwd/pwd.116
1 files changed, 13 insertions, 3 deletions
diff --git a/bin/pwd/pwd.1 b/bin/pwd/pwd.1
index 27150e6..4eaed1d 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.
+.Pp
+Some shells may provide a builtin
+.Nm
+command which is similar or identical to this utility. Consult
+the
+.Xr builtin 1
+manual page.
.Sh DIAGNOSTICS
The
.Nm
@@ -58,14 +65,17 @@ utility is expected to be
.St -p1003.2
compatible.
.Sh SEE ALSO
+.Xr builtin 1 ,
.Xr cd 1 ,
.Xr csh 1 ,
-.Xr getcwd 3
+.Xr getcwd 3 ,
+.Xr sh 1
.Sh BUGS
In
.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.
OpenPOWER on IntegriCloud