Module Name: src Committed By: uwe Date: Sat Aug 31 21:35:50 UTC 2019
Modified Files: src/share/man/man1: cd.1 Log Message: 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. To generate a diff of this commit: cvs rdiff -u -r1.9 -r1.10 src/share/man/man1/cd.1 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
Modified files: Index: src/share/man/man1/cd.1 diff -u src/share/man/man1/cd.1:1.9 src/share/man/man1/cd.1:1.10 --- src/share/man/man1/cd.1:1.9 Sat Aug 31 17:34:46 2019 +++ src/share/man/man1/cd.1 Sat Aug 31 21:35:50 2019 @@ -1,4 +1,4 @@ -.\" $NetBSD: cd.1,v 1.9 2019/08/31 17:34:46 sevan Exp $ +.\" $NetBSD: cd.1,v 1.10 2019/08/31 21:35:50 uwe Exp $ .\" .\" Copyright (c) 1980, 1990, 1993 .\" The Regents of the University of California. All rights reserved. @@ -40,24 +40,42 @@ .Nd change working directory .Sh SYNOPSIS .Nm cd -.Ar directory +.Op Ar directory .Sh DESCRIPTION -.Ar Directory -is an absolute or relative pathname which becomes the new working -directory. -The interpretation of a relative pathname by cd depends on the +Since +.Nm +affects the current shell execution environment, it is always provided +as a shell regular built-in. +For more information consult the manual page for the shell in use. +.Pp +The +.Ar directory +operand is an absolute or relative pathname which becomes the new +working directory. +The interpretation of a relative pathname by +.Nm +depends on the .Ev CDPATH environment variable (see below). .Sh ENVIRONMENT -The following environment variables affect the execution of cd: -.Bl -tag -width indent +The following environment variables affect the execution of +.Nm : +.Bl -tag -width Ev .It Ev CDPATH +A colon-separated list of pathnames that refer to directories. If the .Ar directory -operand does not begin with a slash (/) character, and the first -component is not dot (.) or dot-dot (..), -.Nm cd -searches for the directory relative to each directory named in the +operand does not begin with a slash +.Pq Ql \&/ +character, and the first +component is not dot +.Pq Ql \&. +or dot-dot +.Pq Ql \&.. , +.Nm +searches for the +.Ar directory +relative to each directory named in the .Ev CDPATH variable, in the order listed. The new working directory is set to the first matching directory found. @@ -75,13 +93,11 @@ environment variable exists and contains becomes the new working directory. .It Ev OLDPWD Set to the previous working directory after a directory change. -Unsupported by +Not supported by .Xr csh 1 . .It Ev PWD Set to the current working directory. .El -.Pp -For more information on environment variables consult manual for shell in use. .Sh EXIT STATUS .Ex -std cd .Sh SEE ALSO