Copy stable/9 to releng/9.3 as part of the 9.3-RELEASE cycle.

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

Copy head to stable/9 as part of 9.0-RELEASE release cycle.

Approved by: re (implicit)

sh: Add kill builtin.

This allows specifying a %job (which is equivalent to the corresponding
process group).

Additionally, it improves reliability of kill from sh in high-load
situations and ensures "kill" finds the correct utility regardless of PATH,
as required by POSIX (unless the undocumented %builtin mechanism is used).

Side effect: fatal errors (any error other than kill(2) failure) now return
exit status 2 instead of 1. (This is consistent with other sh builtins, but
not in NetBSD.)

Code size increases about 1K on i386.

Obtained from: NetBSD

sh: Add printf builtin.

This was removed in 2001 but I think it is appropriate to add it back:
* I do not want to encourage people to write fragile and non-portable echo
commands by making printf much slower than echo.
* Recent versions of Autoconf use it a lot.
* Almost no software still wants to support systems that do not have
printf(1) at all.
* In many other shells printf is already a builtin.

Side effect: printf is now always the builtin version (which behaves
identically to /usr/bin/printf) and cannot be overridden via PATH (except
via the undocumented %builtin mechanism).

Code size increases about 5K on i386. Embedded folks might want to replace
/usr/bin/printf with a hard link to /usr/bin/alias.

Remove Xo/Xc in It, which is not yet supported by mdocml but
can be worked around trivially in this case.

builtin(1): sh has no @ builtin command.

MFC after: 1 week

Make hash, type and ulimit available via execve().

These are specified by POSIX but are not special builtins, and therefore
need to be available via execve() and utilities like time, nohup, xargs.
(Note that hash was moved from the XSI option to the base in the 2008
standard.)

Like most of the POSIX "regular builtin commands", these need to be executed
in a shell environment for full functionality, although they may still be of
some use outside one.

Unlike the POSIX special and regular builtin commands, POSIX does not
require these to be found before a PATH search, although that could be an
oversight.

Like some of the utilities already provided by usr.bin/alias, these may lead
to confusing results when invoked from csh(1).

builtin(1): Add missing escaping for !, . and : in the table.

This caused these commands to look differently (not bold) from the other
commands in the table (bold).

MFC after: 1 week

builtin(1): Mention [ sh builtin.

MFC after: 1 week

Fix markup.

Make the SYNOPSIS section more meaningful.

PR: docs/85066
Submitted by: Gary W. Swearingen
MFC after: 3 days

Add the times builtin.

Added missing builtins; a few other clean-ups.

- The first "alias" "Yes" should be "No**".
- Made "builtin echo command" consistent with csh and sh manpages.
- In group of 3 interactive commands, 2 used .Pa instead of .Ic.
- "Name" section now has "builtin" and "built-in" for better apropos.
- Added these builtins: !, %, ., :, @, {, }, local, return

PR: docs/85065
Approved by: keramida
MFC after: 3 days

Add a missing ** to the 'command' command.

PR: 79877
Submitted by: Kazuaki Oda <ybbkaz@yahoo.co.jp>
Reviewed by: ru
Approved by: re
MFC after: 1 day

Add missing command name.

(The error was visible on stderr.)

Approved by: re

Update list of utilitys which are implemented externally, Xref info.1,
clean up some text, bump doc date.

PR: 47690
Submitted by: Gary W. Swearingen <swear@attbi.com> (original version)

Fixed the misplaced $FreeBSD$.

Mention the new bind(1) sh builtin.

One external utility was ommitted in the previous delta:

alias

The following builtins are now available as external commands as well:

bg
cd
command
fc
fg
getopts
jobs
read
umask
unalias
wait

(null commit to correct the previous log message)

Now that all the printf invocations from within the system startup
scripts *have been replaced with equivalent handmade functions*, we
can safely remove it.

Please steal the technique from src/etc/MAKEDEV when you want to use
printf(1) functionality from within the system rc scripts.

Remove the printf builtin command from sh(1), which command is not
used so often that it's worth keeping it as a builtin.

Now that all the printf invocations from within the system startup
scripts, we can safely remove it.

Urged by: sheldonh :)

No MFC is planned so far because it may break compatibility and
violate POLA.

Add false(1), test(1) and true(1) cross-references.

Pointed out by: sheldonh

Make test(1) a builtin command of our sh(1) for efficiency. The
binary size increase is 3,784 bytes (about 0.6%).

I don't drop the printf builtin while I'm here because some /etc/rc.*
scripts seem to use it before mounting /usr where printf(1) resides.

Reviewed by: arch (sheldonh)
Inspired by: NetBSD, ksh
Clued by: ume (on how the printf builtin is used)

mdoc(7) police: expand plain text xrefs.

Removed whitespace at end-of-line; no content changes. I simply did
cd src/share; find man[1-9] -type f|xargs perl -pi -e 's/[ \t]+$//'

BTW, what editors are the culprits? I'm using vim and it shows
me whitespace at EOL in troff files with a thick blue block...

Reviewed by: Silence from cvs diff -b
MFC after: 7 days

"break", "chdir", "continue", "else", and "while" are sh(1) builtins;
mark them as such.

PR: 26702

Indicate that sh(1) has an 'if' builtin command.

PR: 26193

Prepare for mdoc(7)NG.

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

Update the builtin(1) manpage to reflect changes since the csh(1)
to tcsh(1) upgrade. The following commands were added as builtins:

bindkey
builtins
complete
echotc
filetest
hup
log
ls-F
printenv
sched
settc
setty
telltc
uncomplete
where

The printf builtin was removed.

Remove the bogusly inserted ``cwd'' which isn't a builtin command
to sh, csh nor tcsh.

Fix the header line of the table to use cross-references and
emphasis.

I didn't expect this to be merged to STABLE. It was, so correct the
HISTORY section.

Add missing entry for read(1) to the builtin(1) manual page and
add an MLINKS entry for it. I can't imagine how I missed this one.

Fix the availability table, which incorrectly indicated that sh(1)
does not have a builtin set command.

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