Sun Sep 1 14:20:00 2019 UTC ()
Pull up following revision(s) (requested by sevan in ticket #153):

	share/man/man1/cd.1: revision 1.10
	share/man/man1/cd.1: revision 1.9

Direct reader to shell documentation generally, rather than csh(1)
specifically.

Mention variables OLDPWD and PWD.

Move the text that explains that cd(1) is a shell built-in to the very
beginning of the description where it can be seen prominently.

Improve formatting.


(martin)
diff -r1.8 -r1.8.8.1 src/share/man/man1/cd.1
cvs diff -r1.8 -r1.8.8.1 src/share/man/man1/cd.1 (expand / switch to unified diff)

--- src/share/man/man1/cd.1 2017/07/04 06:33:13 1.8
+++ src/share/man/man1/cd.1 2019/09/01 14:20:00 1.8.8.1
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1.\" $NetBSD: cd.1,v 1.8 2017/07/04 06:33:13 wiz Exp $ 1.\" $NetBSD: cd.1,v 1.8.8.1 2019/09/01 14:20:00 martin Exp $
2.\" 2.\"
3.\" Copyright (c) 1980, 1990, 1993 3.\" Copyright (c) 1980, 1990, 1993
4.\" The Regents of the University of California. All rights reserved. 4.\" The Regents of the University of California. All rights reserved.
5.\" 5.\"
6.\" This code is derived from software contributed to Berkeley by 6.\" This code is derived from software contributed to Berkeley by
7.\" the Institute of Electrical and Electronics Engineers, Inc. 7.\" the Institute of Electrical and Electronics Engineers, Inc.
8.\" 8.\"
9.\" Redistribution and use in source and binary forms, with or without 9.\" Redistribution and use in source and binary forms, with or without
10.\" modification, are permitted provided that the following conditions 10.\" modification, are permitted provided that the following conditions
11.\" are met: 11.\" are met:
12.\" 1. Redistributions of source code must retain the above copyright 12.\" 1. Redistributions of source code must retain the above copyright
13.\" notice, this list of conditions and the following disclaimer. 13.\" notice, this list of conditions and the following disclaimer.
14.\" 2. Redistributions in binary form must reproduce the above copyright 14.\" 2. Redistributions in binary form must reproduce the above copyright
@@ -22,72 +22,93 @@ @@ -22,72 +22,93 @@
22.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 22.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 23.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
24.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 24.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
25.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 25.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
26.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 26.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
27.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 27.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
28.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 28.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
29.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 29.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
30.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 30.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
31.\" SUCH DAMAGE. 31.\" SUCH DAMAGE.
32.\" 32.\"
33.\" @(#)cd.1 8.1 (Berkeley) 6/5/93 33.\" @(#)cd.1 8.1 (Berkeley) 6/5/93
34.\" 34.\"
35.Dd June 5, 1993 35.Dd August 31, 2019
36.Dt CD 1 36.Dt CD 1
37.Os 37.Os
38.Sh NAME 38.Sh NAME
39.Nm cd 39.Nm cd
40.Nd change working directory 40.Nd change working directory
41.Sh SYNOPSIS 41.Sh SYNOPSIS
42.Nm cd 42.Nm cd
43.Ar directory 43.Op Ar directory
44.Sh DESCRIPTION 44.Sh DESCRIPTION
45.Ar Directory 45Since
46is an absolute or relative pathname which becomes the new working 46.Nm
47directory. 47affects the current shell execution environment, it is always provided
48The interpretation of a relative pathname by cd depends on the 48as a shell regular built-in.
 49For more information consult the manual page for the shell in use.
 50.Pp
 51The
 52.Ar directory
 53operand is an absolute or relative pathname which becomes the new
 54working directory.
 55The interpretation of a relative pathname by
 56.Nm
 57depends on the
49.Ev CDPATH 58.Ev CDPATH
50environment variable (see below). 59environment variable (see below).
51.Sh ENVIRONMENT 60.Sh ENVIRONMENT
52The following environment variables affect the execution of cd: 61The following environment variables affect the execution of
53.Bl -tag -width indent 62.Nm :
 63.Bl -tag -width Ev
54.It Ev CDPATH 64.It Ev CDPATH
 65A colon-separated list of pathnames that refer to directories.
55If the 66If the
56.Ar directory 67.Ar directory
57operand does not begin with a slash (/) character, and the first 68operand does not begin with a slash
58component is not dot (.) or dot-dot (..), 69.Pq Ql \&/
59.Nm cd 70character, and the first
60searches for the directory relative to each directory named in the 71component is not dot
 72.Pq Ql \&.
 73or dot-dot
 74.Pq Ql \&.. ,
 75.Nm
 76searches for the
 77.Ar directory
 78relative to each directory named in the
61.Ev CDPATH 79.Ev CDPATH
62variable, in the order listed. 80variable, in the order listed.
63The new working directory is set to the first matching directory found. 81The new working directory is set to the first matching directory found.
64An empty string in place of a directory pathname represents the current 82An empty string in place of a directory pathname represents the current
65directory. 83directory.
66If the new working directory was derived from 84If the new working directory was derived from
67.Ev CDPATH , 85.Ev CDPATH ,
68it will be printed to the standard output. 86it will be printed to the standard output.
69.It Ev HOME 87.It Ev HOME
70If 88If
71.Nm cd 89.Nm cd
72is invoked without arguments and the 90is invoked without arguments and the
73.Ev HOME 91.Ev HOME
74environment variable exists and contains a directory name, that directory 92environment variable exists and contains a directory name, that directory
75becomes the new working directory. 93becomes the new working directory.
 94.It Ev OLDPWD
 95Set to the previous working directory after a directory change.
 96Not supported by
 97.Xr csh 1 .
 98.It Ev PWD
 99Set to the current working directory.
76.El 100.El
77.Pp 
78See 
79.Xr csh 1 
80for more information on environment variables. 
81.Sh EXIT STATUS 101.Sh EXIT STATUS
82.Ex -std cd 102.Ex -std cd
83.Sh SEE ALSO 103.Sh SEE ALSO
84.Xr csh 1 , 104.Xr csh 1 ,
 105.Xr ksh 1 ,
85.Xr pwd 1 , 106.Xr pwd 1 ,
86.Xr sh 1 , 107.Xr sh 1 ,
87.Xr chdir 2 108.Xr chdir 2
88.Sh STANDARDS 109.Sh STANDARDS
89The 110The
90.Nm cd 111.Nm cd
91command is expected to be 112command is expected to be
92.St -p1003.2 113.St -p1003.2
93compatible. 114compatible.