MFC r306720:
Add history section of pwd(1)
http://minnie.tuhs.org/cgi-bin/utree.pl?file=V5/usr/source/s2/pwd.c

PR: 211787
Approved by: bcr (mentor)
Differential Revision: https://reviews.freebsd.org/D8104

Copy head (r256279) to stable/10 as part of the 10.0-RELEASE cycle.

Approved by: re (implicit)
Sponsored by: The FreeBSD Foundation

Sync program's usage() with manpage's SYNOPSIS.

Add the new standard EXIT STATUS section where appropriate.
Sort standard sections in the (documented) preferred order.

/*- or .\"- or #- to begin license clauses.

Deal with double whitespace.

Remove clause 3 from the UCB licenses.

OK'ed by: imp, core

Rename a local variable in order to avoid collision with standard 'log'
function.

mdoc(7) police: A better version of the same.

Approved by: re (blanket)

Quiet warnings about copyright[].

Document the -L and -P options as being mutually exclusive.

Consistently use FBSDID

Back out part of previous commit: make -P the default again until I'm
convinced it's a good idea.

Make -L the default, allow both -L and -P to be specified (last one used
matters), fall back to -P mode if we can't get the logical directory.

Use `The .Nm utility'

mdoc(7) police: use precise width specifier.

Repo-copied `src/bin/pwd/realpath.1' to `src/bin/realpath/realpath.1',
as part of the move to seperate realpath(1) into its own directory.

o Remove old code from pwd(1); realpath(1) is now in its own directory.
o Fix some unordered includes in pwd(1).
o Connect realpath(1) to the build.

Use the getprogname(3) function instead of directly accessing
`__progname'.

Submitted by: dd

Add -L option (SUSv3) to pwd(1). Fix a bug, where realpath(1) would
complain about paths starting with `-', by not calling getopt(3).

Submitted by: Tim J. Robbins <tim@robbins.dropbear.id.au>
Obtained from: NetBSD (partially)
MFC after: 1 month

o __P has been reoved
o Old-style K&R declarations have been converted to new C89 style
o register has been removed
o prototype for main() has been removed (gcc3 makes it an error)
o int main(int argc, char *argv[]) is the preferred main definition.
o Attempt to not break style(9) conformance for declarations more than
they already are.

Default to WARNS=2. Binary builds that cannot handle this must explicitly
set WARNS=0.

Reviewed by: mike

mdoc(7) police: utilize the new .Ex macro.

mdoc(7) police: removed HISTORY info from the .Os call.

mdoc(7) police: sort SEE ALSO xrefs (sort -b -f +2 -3 +1 -2).

WARNS= -> WARNS?=

Submitted by: Mike Barcroft <mike@q9media.com>

PATH_MAX in preference to MAXPATHLEN.

Silence WARNS=2 and BDECFLAGS on i386 and alpha.

MFC After: 1 week

MAN[1-9] -> MAN.

Move the realpath(1) birth day from FreeBSD 5.0 to FreeBSD 4.3.

Submitted by: "Stephen L. Palmer" <slpalmer@mail.com>
Forgotten by: asmodai

Don't call err() with user data and without a format string

mdoc(7) police: minor fixes.

Let the pwd program double as realpath(1).

This lets you resolve pathnames to their underlying physical path:

critter# realpath /sys/kern/subr_disk.c
/freebsd/src/sys/kern/subr_disk.c

Update the pwd man-page slightly.

mdoc(7) police: use the new features of the Nm macro.

Correct some hard sentence breaks. Only those surrounding the previous
commit and those which cause ugly nroff output have been fixed, since
the purpose of the style guideline which they contravene is to reduce
the sizes of deltas.

Reported by: bde

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

$Id$ -> $FreeBSD$

Various spelling/formatting changes.

Submitted by: Philippe Charnier <charnier@xp11.frmug.org>

Indicate that the thing not found was not /bin/pwd but rather $CWD (or .).

Correct use of .Nm. Add rcsid.

compare return value from getopt against -1 rather than EOF, per the final
posix standard on the topic.

Revert $FreeBSD$ to $Id$

Make the long-awaited change from $Id$ to $FreeBSD$

This will make a number of things easier in the future, as well as (finally!)
avoiding the Id-smashing problem which has plagued developers for so long.

Boy, I'm glad we're not using sup anymore. This update would have been
insane otherwise.

Merge Lite2 mods, cleanup man page, and -Wall cleaning.

Added $Id$

This commit was generated by cvs2svn to compensate for changes in r1556,
which included commits to RCS files with non-trunk default branches.