Random minor wording and markup cleanups.

printf(1): misc tweaks

Move the advise about getopt's "--" to where the format is disussed.
Use .Vt for types.

printf(1): move \e description to its lexicographic place

Add %C format conversion and -L option to printf(1)

%C does what everyone always thought %c should do, but doesn't,
and operates rather like the %c conversion in printf(3) (to be
more precise, like %lc). It takes a code point integer value
in the current locale's LC_CTYPE and prints the character designated.

-L (this printf's first, and only, option) makes the floating conversions
use long double instead of double.

In the manual (printf.1) document both of those, and also be more
precise as to when things are affecting bytes, and when they're
manipulating characters (which makes no difference if LC_ALL=C).

branches: 1.37.2;
s/chracter/character/ in documentation.

branches: 1.36.4;

Don't describe "%%: in the format as a format conversion, it isn't,
it is an escaped literal '%' character. None of what applies to
format conversions applies to this.

branches: 1.35.2;
Add quotes around command substitution in the example
so that it works regardless of IFS and buts.
Requested by kre@

Drop redundant quoting in the nested printf example.

Use ASCII single quote.

Try to improve markup to get a nicer PostScript output.

While here edit slightly for consistency: get the octal character
ranges in order, use \num to refer to octal everywhere, etc.

PR standards/53563

POSIX requires that signed numbers (strings preceded by '+' or '-')
be allowed as inputs to all of the integer format conversions, including
those which treat the data as unsigned.

Hence we do not need a variant function whose only difference from its
companion is to reject strings starting with '-' - instead we use
the primary function (getintmax()) for everything and remove getuintmax().

Minor update to the man page to indicate that the arg to all of the
integer conversions (diouxX) must be an integer constant (with an
optional sign) and to make it blatantly clear that %o is octal and
%u is unsigned decimal (for some reason those weren't explicitly stated
unlike d i x and X). Delete "respectively", it is not needed (and does
not really apply).

XXX pullup -8

Add the new formats to the list of format cracters (oops...)

Add support for F a and A formats (which go with the eEfgG formats
already supported.)

Correct a typo (off by one (key)) ...
There is no 'w' format, but there is an 'e'

branches: 1.27.2;
Remove Tn.

Explicitly mention use of -- for format strings beginning with -,
per PR 21970.

branches: 1.25.16; 1.25.22;
Change some standard exit status text to ".Ex -std"
From Eitan Adler in PR bin/47790.

branches: 1.24.6; 1.24.12; 1.24.22;
\\*(Pm -> \*(Pm

Use semantic markup

branches: 1.22.6;
Fix description of %b format. PR 39111 from Paul Goyette.

branches: 1.21.2;
Add a note about the stupid behaviour of "%c" format.

branches: 1.20.32;
Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22365, verified by myself.

Use .Aq instead of \*[Lt]...\*[Gt]; sort SEE ALSO; add some more commas;
new sentence, new line; fix some mdoc nits.

Add missing comma.

Fixes from David Laight:
- ansification
- format of output of jobs command (etc)
- job identiers %+, %- etc
- $? and $(...)
- correct quoting of output of set, export -p and readonly -p
- differentiation between nornal and 'posix special' builtins
- correct behaviour (posix) for errors on builtins and special builtins
- builtin printf and kill
- set -o debug (if compiled with DEBUG)
- cd src obj (as ksh - too useful to do without)
- unset -e name, remove non-readonly variable from export list.
(so I could unset -e PS1 before running the test shell...)

New sentence, new line.

Generate <>& symbolically. I'm avoiding .../dist/... directories for now.

Punctuation nits.

Whitespace cleanup.

Xr printf(9)

For commands and utilities, use EXIT STATUS rather than RETURN VALUES or
DIAGNOSTICS as appropriate (and documented in mdoc(7)).

\e generates an escape character but is not listed in the manpage. Fixed.

remove WARNS?=1, cleanup .Nm usage

"merge" lite-2. our printf is already kinda different...minor changes only.

alternate -> alternative, per PR 2643

RCS ID police

Changed floating point output format to be exactly the same (use same
text and macros) as those in the printf(3) manpage.
This fixes PR #1194, albeit differently.

The descriptions of the o and u formatting options were reversed (PR #785).

Changes required to make printf utility POSIX.2 compliant:
* Escape characters in the string needed to be processed as they were
encountered, otherwise a "\000" octal constant would prematurely
terminate the formatting string.
* Implemented the %b, SysV echo(1) compatibility, formatting directive.

Add RCS indentifiers.

branches: 1.1.1;
Initial revision