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.

`Ad' is supposed to underline.  Found whilst trolling through manuals.

Make `Sm' start no-spacing after the first output word.  Fix in both
-T[x]html and -T{pdf,ps,ascii}.  Reported by Jason McIntyre.

Clean up some tight spots in mandoc's default mode: pessimistically
pre-allocate the output buffer for words and in-line the buffera()
function, which was only called in one place anyway.

Remove asciisz from chars.in.  It frees up a nice chunk of memory and at
the overhead of running strlen() for ASCII strings (yes, I benchmarked
this running mandoc_char(7) as input again and again with
hundredth-second penalties... on my slow-ass alpha).

Note that `Dd' can be empty.  This found following a thread on discuss@
started by Sascha Wildner, 07/25/2010 06:30 AM.

Merge schwarze@'s pass over mdoc.7.  Fixed small new-sentence-new-line
nit noted by Jason McIntyre.

"your diff looks ok" (Jason McIntyre)

Fix chars.in fall-through to ASCII mode.  This bug only affected
-T[x]html.

Note -Tpdf in www.

Merge Jason McIntyre's corrections to man.7.

"urgle": Jason McIntyre.  "This is all ok" schwarze@.

Avoid running the "width" termp callback for each whitespace.

Fully-working -Tpdf: xref table is now generated.  This works for both
single and multiple-manual mode (e.g., mandoc -Tpdf foo.1 bar.1).

Make PDF sections contiguous.

Ensure that isalnum is called with unsigned char argument.

list two additional issues

Initial PDF shim over PS.  This produces working PDF output with -Tpdf.
It's currently missing the xref table, so you'll get a warning in most
PDF viewers).  It also produces lots of redundant output, which will go
away once I get a better handle on the PDF spec.  The code doesn't
really touch any existing functionality; it's a bunch of conditionals
atop the -Tps (term_ps.c) implementation.  I'm checking it in now to
have it exist and be auditable.  It needs clean-up, polish, and general
care (and xref!).

Collapse `nf', `fi', `Vb', and `Ve' into one function as in man_html.c.

Enable literal contexts (Vb/nf) in -T[x]html -man.  This requires that a
new struct pass down in the call-tree (as also in man_term.c).

Also add a line-break for `in', which isn't otherwise supported (yet).

Now -Thtml -man cvs.1 for GNU's cvs.1 isn't as ugly.

Add support for `Sm' in -T[x]html -mdoc.

Fix broken compilation, hopefully before anybody notices.

Added `in' macro support for -man -Tascii.  This is not yet supported in
-Thtml (I'm surprised to note that neither is LITERAL mode).

Start putting in release notes.  A record is good because this release
will have lots of small, incremental improvements.

Accept "\s0" (i.e., properly ignore it).  Found in the wild (e.g., gfdl.7).

Bring `sp', `Sp', and `br' behaviour for -man in line with how -mdoc's
is handled: correctly.  This removes superfluous line breaks in many
-man manuals.

Have `nf' and `fi' flush lines.  This is necessary or the LITERAL will
be meaningless when invoked within a non-flushing context.  This based
on a formatting bug report submitted by Jonathon Gray (jsg@) via
Christian Weisgerber (naddy@).

In the SYNOPSIS, .Nm at the beginning of an input line starts
an .Nm block, and gets special handling (new line, indentation).
But .Nm in the middle of a line is just a normal in-line element,
so make sure it does NOT get the special handling.
Partly fixes the test(1) SYNOPSIS; indentation after "[" is still
excessive, which is an unrelated and more difficult issue.
Reminded of the problem by jmc@;
OK kristaps@.

Accomodate for groff's crappy behaviour wherein an unrecognised
single-character escape (and ONLY this type of escape) will map back
into itself:

       "If a backslash is followed by a character that does not
constitute a defined escape sequence the backslash is silently
        ignored and the  character maps to itself."

(From groff.7.)

Found by Jason McIntyre.

Clarified mailing list purposes.

Tidy up the www page.

Nit-picking assign in decl.

Lint-fixes (NetBSD).

Finally make mdoc argv CPP-defines into a proper enum.

The "wx" value is quite small, so use a u_short instead of a size_t.

Strip non-graphable input characters from input.  The manuals
specifically say that this is not allowed, and were it allowed, output
would be inconsistent across output media (-Tps will puke,
non-your-charset terminals will puke, etc.).

With this done, simplify check_text() to only check escapes and for
tabs.  Add in a new tab warning, too.

Use floating-point -Tps "moveto" arguments to smooth out column and row
misalignments.

sync to OpenBSD:
* briefly mention the HISTORY of the man(7) language
* update the copyright notice
* improve the wording in a few places
* fix a couple of typos
including two suggestions from J.C. Roberts
feedback and ok jmc@, ok sobrado@ and kristaps@

All macros in mdoc.7 are now documented.

Finished document -mdoc macros.  Note `br' and `sp' remain.

Noted in arch.in and st.in that mdoc.7 must be updated if entries are
added.

Added documentation for several more macros.  Only a few remaining!

Applied "new-sentence, new-line" here and there.

Refer to "whitespace", not "white-space".

Remove long-commented-out CAVEATS, all of which have been addressed or
at least discussed to some extent or another.

Remove some FIXMEs: `Ms' accepts arbitrary text, so it can't/shouldn't
be converted into a symbol.

The `Pp' issue has also been fixed.