`Sm' no longer produces a linebreak when used in `Bd'.

Cleaned up library manuals: removed old escapes, added EXAMPLES, stripped
out some superfluous stuff.

Revert merging of {mdoc,man}.h -> mandoc.h.

While I'm add it, properly document all structures in these files.

style cleanup, no functional change:
* make the initial maxvis/mmax calculation easier to understand
* where real, non-indexing casts happen, make them explicit
* avoid a few lint warnings that can easily be fixed
* remove one needless LINTED comment
"I like this" kristaps@

Unify mdoc and man enums and structs into mandoc.h.  This is part of the
slow process of logically splitting formatting frontend and parser backend
without pollution.

* need a space before .No even if it starts with a closing delimiter
* slightly simplify .Pf *_IGNDELIM code, and share part of it with .No
* do not let opening delimiters fall out of the front of .Ns (from kristaps@)
This fixes a few spacing issues in csh(1) and ksh(1).
OK kristaps@

Fix small regression where `Op' had an extra space between the "[" and the SPAN.

Merge from OpenBSD right after 1.10.6; now back to full sync.
* mdoc.c: blank lines outside literal mode are more similar to .sp than .Pp
* backslashes do not terminate macros; partial revert of mdoc.c 1.164;
  the intention of that commit is fully achieved in roff.c
* mdoc_term.c: no need to list the same prototype twice
* mdoc_validate.c: drop .Pp before .sp just like .Pp before .Pp
* fix off-by-one found by jsg@ with parfait, OpenBSD term_ps.c 1.12
ok kristaps@

Added TODO for more `Pp' warnings.

A minor issue with \& between .Pp found while merging 1.10.6.

Prepping for version.

Consider both `Lp' and `Pp' when stripping prior paragraph marks.

Suppress whitespace following Pp, Lp, sp, and the other newline-emitting
macros within an unfilled or literal `Bd'.

Remove finished TODO.

Ignore double-`Pp' and `Pp' before `Bd' and `Bl' (unless -compact is
specified).

Added MIPS64.  From a patch by Jason McIntyre.

sync to OpenBSD:
new sentence, new line;
from jmc@

If an explicit scope is still open at the end of an input file,
report an ERROR:  We can still render the page by just closing
the open scope, but it is likely that information will be missing
or document structure mangled.
Before, man(7) only reported a WARNING (which is dangerous because
we cannot be sure rendering is correct) and mdoc(7) ran into FATAL
(which is too drastic, there is no reason not to show what we have).
"looks good" kristaps@

sync to OpenBSD:
note that IMPLEMENTATION NOTES is not used in OpenBSD
add missing comma in "sections 1, 6, & 8 only" below EXIT STATUS
below SEE ALSO, add an .Xr to man(1), and from man(7) to mdoc(7)

Consolidated all -T[x]html punctuation macros into one function.

Linted function arguments.

Big clean-up consolidating all punctuation opening/closing functions into
a single one.  This makes code auditing easier and cuts down on
bytesize.

I also removed some NOSPACE clauses that were handled implicitly by the
punctuation itself, e.g., a NOSPACE prior to printing ')', which in
term.c has its leading whitespace automatically suppressed.

Remove fixed TODO and add a new one.

A `%T' invoked outside of `Rs' should not produce trailing punctuation.
This from a TODO entry.  Also stripped the superfluous NOSPACE, which is
handled in term_word() or print_text() anyway.

Add `Rs' vertical-space in -T[x]html "SEE ALSO" section.  Remove
corresponding TODO entry.

Also have the "." after an `Rs' block trigger inter-sentence spacing.

Removed TODO that was fixed by parsing escapes in offset strings.

When the HEAD of an .Nm block in the SYNOPSIS might be wider
than the column containing it, the TERMP_HANG flag is required,
but avoid the flag when we know that the HEAD is shorter,
because in that case, the flag might ruin the alignment.

Problem originally reported by jmc@, who also spotted a regression
in an earlier version of this patch.

"feel free to commit" kristaps@

Count trailing escaped blanks correctly;
those ruined the alignment of columns.
Tested by jmc@, and kristaps@ agrees with the direction.

enclosures sometimes cause bogus end-of-sentence

Allow string lengths to account for escapes.  Now all calls to calculate
column width in -Tascii, -Tpdf, and -Tps will account for "more real"
string lengths.

Example:

.Bl -tag -width \s[+123424]foo
.It bar
baz
.El

The size escape will be correctly tossed.

.Bl -tag -width \(aqbar
.It \(aqbar
baz
.El

The \(aq will be correctly handled.

Remove last pod2man escapes.  These render ok, although \*(-- renders as
O- because the underlying macro depends on \(*W, which a prior pod2man
preamble `tr' macro rewrites as "-".  This is an error in groff as this
tramples on the real \(*W, or Greek omega.

Prevent .Lp from looping endlessly on punctuation.
Same fix as the previous one.

Prevent `Pp' from looping endlessly on punctuation.  Bug reported by
Marc Espie.

Found nit in -T[x]html.

Churny commit to quiet lint.  No functional changes.

Properly handle -mdoc %A in all outputs.  This has two-author entires
separated by only "and" while two or more are with ", and" for the last
author.

Also remove relevant TODO and add regression tests.

Removed 'br\} comment from TODO.  This was fixed a few weeks ago.

Fix premature return from sub-conditional roff statements.  This fix
fully accomodates for the pod2man standard preamble!

Clarified EXIT STATUS sections.  Discussed among schwarze@, Thomas, and
Jason.  Patch by Jason.

Remove the pod2man table entries.  They can now be properly read and
assigned within the pod2man preamble.

Allow `.xx\}' where xx is a macro (e.g., `.br\}') to close scope.  This is
experimental and hasn't been rigorously tested.  It's only implemented in
-mdoc for the time being.  This is absolutely required for pod2man.  It
does, however, make the pod2man preamble be processed in full.

Remove overstrike `\o'.  This isn't the best solution because we really
should be printing the contents, but for the time being, this is good
enough.

Made -mdoc `Pp', `Lp', and `br' not FATAL when having arguments.

Move mdoc/man template "The next is for" into the section itself.  Added
OpenBSD compatibility notes.  Based on a patch by Jason McIntyre.

"sys/param.h is for kernel interface programs.
sys/types.h is the file you want to include."

From a downstream fix by deraadt@.

Fixed HISTORY to note mdoc's rewrite in groff-1.17, not groff-1.20.

Handle nested, recursive mathematical subexpressions.  This is
definitely not general, but it's good enough for pod2man definitions
(after I clean up the roff, which will be addressed in later fixes).

Strip out `\k' escape.

Stripping out of `\w' groff escape.  Yet another for pod2man...

Have the `ds' processor strip out `\\' as stipulated in groff.7.  I only
care because pod2man uses this construct.

Strip out the `\z' escape.  This is the first recursive sequence,
getting mandoc ready to handle pod2man's complex escapes.

Add a short HISTORY section to mdoc.7.  Facts provided by schwarze@'s
detective-work in the UNIX archives.

Sort COMPATIBILITY in mdoc(7) (from schwarze@).

Update escape COMPATIBILITY in mdoc(7) and man(7) (ok schwarze@).

Backout previous.
As Kristaps found out, i was wrong: .Bl -column phrases do not ignore
spacing rules for trailing punctuation in general.  In particular,
- the rightmost column of a column list is unaffected
- columns terminated by the .Ta macro instead of a tab are unaffected
- columns ending in a blank are unaffected
Spacing rules for trailing punctuation are only ignored when the tab
follows the punctuation immediately, without a blank in between,
because then the combination of punctuation and tab is treated by roff
as a word, and the punctuation is not recognized as isolated.
The reason this doesn't work in mandoc is that in the special case
of .Bl -column (not in general!), mandoc treats tabs as word delimiters.
We either need to solve this differently, or call it a bug in roff.

Centralize handling of literal tabs in term_flushln() in one place,
making the code simpler and easier to understand.
No functional change.

When a column contains trailing spaces, calculate the padding
to the start of the next column correctly.
Fixing a problem found by jmc@ in sysctl(3), reminded by kettenis@.

.Bl -column phrases ignore spacing rules for trailing punctuation
and render it just like normal text.
Minimal fix of a formatting bug in operator(7) reported by ray@.

fix previous: when bailing out due to -Wstop,
skip output functions, but not *_endparse;
problem reported by kristaps@

Fixed Makefile auto-generation of manuals not to use -fstrict and [old] -Werror.

Implement a simple, consistent user interface for error handling.
We now have sufficient practical experience to know what we want,
so this is intended to be final:
- provide -Wlevel (warning, error or fatal) to select what you care about
- provide -Wstop to stop after parsing a file with warnings you care about
- provide consistent exit status codes for those warnings you care about
- fully document what warnings, errors and fatal errors mean
- remove all other cruft from the user interface, less is more:
- remove all -f knobs along with the whole -f option
- remove the old -Werror because calling warnings "fatal" is silly
- always finish parsing each file, unless fatal errors prevent that
This commit also includes a couple of related simplifications behind
the scenes regarding error handling.
Feedback and OK  kristaps@;  Joerg Sonnenberger (NetBSD) and
Sascha Wildner (DragonFly BSD) agree with the general direction.

Updated hypermail link to summary.html.

Added mail archive periodically generated by hypermail.

Migrate `Xr groff 1' -> GNU troff.  I no longer assume that groff is
installed on the host system.

Remove references to \s in mandoc.1: we no longer document these and just
flat-out ignore them.

Add joerg@'s note that br\} needs work in libroff.

Remove \*(C+ from the pre-predefined strings.  It is always `ds'-defined
when being used in manuals.  Since we now support `ds', it's no longer
necessary to account for it.  From a bug report originally by Thomas
Jeunet.

Add \v and \h to ignored escapes.  These are in the category of \s.
Also made sign-less \s-style escapes be ok (this is technically against
what's in the groff.7 manual, but seems pretty widespread).  Noted by
Thomas Jeunet as uglifying the gcc.1 manual.

OpenBSD src/sbin was used as a tool to hunt bugs in mandoc.

OpenBSD src/bin was used as a tool to hunt bugs in mandoc.

Note first that TODO file should be up to date.

Note also that the PDF file should be reduced in case I somehow forget.

Correctly make quotes around `Lk' link-name argument.  Noted by Aldis
Berzoja.  Also note COMPATIBILITY of groff misformatting `Lk'.

Correctly print `Lk' arguments in -Tascii.  Issue raised by Aldis Berzoja.
Behaviour ok'd by schwarze@.

simplify the code copying the macro name, and sync the
accompagnying comment between man_pmacro() and mdoc_pmacro();
ok'd by kristaps@ together with main.c rev. 1.102

Make sure we really throw away non-ASCII characters.
For example, on OpenBSD without locale settings,
isgraph(3) returns true for some eight-bit characters.
ok kristaps@

Clean out the isgraph() checks in mdoc.c and man.c.  These code paths
were never taken since main.c begin skipping over unrecognisable
characters, so they were noops.

"Groff allows the initial macro on a line to be delimited by a space of
by a tab; so allow the tab in mandoc, too."  Original problem noted by
schwarze@.  Sync with OpenBSD.

Add TODO noted by Alex Kozlov.

Remove mandoc.1 compatibility notes that are no longer relevant.

same as mdoc_term.c rev. 1.180:
preserve blank lines at the end of .Bd -literal
patch from kristaps@, who asked me to commit this

merge from OpenBSD mdoc_term.c rev. 1.100:
preserve blank lines in .Bd -literal,
both in the middle and at the end of the display
ok kristaps@

Removed cross-reference to groff(1) in favour of simply mentioning GNU
troff.  This removes the last groff(1) `Xr'.

Added serial comma.

Put "remarks" for `%C' into COMPATIBILITY.

`In' comes before `Vt' in function example of SYNOPSIS.

Clarify that predefined strings aren't groff-isms, they're troff-isms.

tweaks from jmc@:
* correct a few obvious mistakes
* adopt some of jmc@'s recent changes to man(7)
* cut down just a little on the awful tendency
  to stick a hyphen between two words.

merge from OpenBSD:
- HISTORY is interesting even when there are STANDARDS
- more precise instructions what to put into AUTHORS
- add the version argument to the mdoc(7) .Os macro

IMPORTANT FIX: add missing braces around alloc failure conditional in
fuction-isation of PS_GROWBUF.  Obviously the original commit was never
actually tested, as -Tps and -Tpdf errored out immediately.

Turn the non-trivial PS_GROWBUF macro into a function. Don't use MAX, it
doesn't exist in the default namespace on Solaris.

Sync to OpenBSD: add missing Copyright years.
I checked that substantial changes were committed
to these files during these years.

Don't crash for the following test case as reported by Jordan Gordeev:
.Bl -tag
.It
foo
...

Use 0 for MAP_FILE if it doesn't exist. From Hans Rosenfeld.

Add PDF files to www.  We also show text and ps, just to show off.

Get version bits in: 1.10.5.

No-op to shut up lint.

Fix `ds' handling.  This was stripping characters from "val", when the
syntax of `ds' is such that ALL text following the first
non-space/non-double-quote is part of the value.  This also fixes the
warning of *(string++) = NULL report by kristaps@ and joerg@.

Nit-picking style of www page.

Fill in more version notes.

Update TODO to note that %A needs "and" before final author and that
joerg@ has some tbl(1) patches lying around that need merging.

Removed boot_config.8 breakage, which was fixed by the last commit of
`Bd -literal' and `Bd -unfilled' unbreakage.

Fix how `Bd -unfilled' and `Bd -literal' break lines.  This unbreaks
displays to work as old groff shows them; however, new groff still does
some fancy shit.