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.

Fix spurrious newline emitted by `Pp' when specified before or after
`Sh'/`Ss'.  Reported by Jason McIntyre.

Changed Unicode codepoint of left-arrow right-arrow to be the regular
ASCII symbols.

Note discarding of \m, \M, and \s in COMPATIBILITY sections.

Remove \s TODO: these are intelligently ignored along with \m and \M.

Removed \s documentation, as we (1) never supported it, and (2) never
will.

Also whack the dot-separator from the embedded man.7 manual.

Double-up DECO_RESERVED switch branch for colours.

Properly discard \m colour escapes.  Noted by J.C. Roberts.

Throw out a2roffdeco() in out.c for a readable version.  The prior one
was completely unmaintainable.  The new one is both readable and quite
similar to mandoc_special(), which in future versions will easily allow
throwing-away of unsupported escapes (such as \m).  It's also a fair bit
smaller.

DECO_SIZE has been removed: this crap, like colours, will not be
supported.

mandoc_special() also has #if 0'd switch branches for ALL groff.7
escapes and some lint fixes.

Make "\ " produce non-breaking space.

Noted by Theo de Raadt.  Ok schwarze@.

Text ending in a full stop, exclamation mark or question mark
should not flag the end of a sentence if:

1) The punctuation is followed by closing delimiters
and not preceded by alphanumeric characters, like in
"There is no full stop (.) in this sentence"

or

2) The punctuation is a child of a macro
and not preceded by alphanumeric characters, like in
"There is no full stop
.Pq \&.
in this sentence"

"looks fine" to kristaps@; tested by jmc@ and sobrado@

fixed .Sm spacing, but there are four new issues

Clean up mandoc_special() (in order later to catch \m).  It also flags
several syntactic errors that weren't caught before.

Also un-puke chars.c on zero-length \[].

Avoid letter-by-letter encoding by using strcspn() in term_word().

By letting strncmp() do its job and not helping it with a prior length
check, we can remove the hard-coded length of all escape patterns.  This
frees up a nice chunk of memory.

Change chars.in HTML encoding to be a Unicode codepoint (int), which is
later formatted in html.c.

Removed completed TODO.

Fixed dquote to be \*q.

Fix which escapes are used to format \".

After .Sm on, spacing ought to restart right away, before the next token,
and not with a delay, after the next token.  But be careful not to cause
leading white space at the beginning of a line or column.
In OpenBSD, improves chmod(1), ksh(1), tar(1), ps(1) and probably many more.
ok kristaps@ and tested by jmc@ and sobrado@

document .Sm; prodded by kristaps@

correct lots of copyright notices;
ok kristaps@

Pre-tag checkin of release bits and shortlist.

remove three issues fixed near the end of the c2k10 hackathon

Re-constitution of `ds' symbol processing.  First, push the
roff_getstr() family of functions into roff.c with the "first_string"
directly in struct roff.  Second, pre-process each line for reserved
words in libroff, splicing and re-running a line if it has one (this
allows defined symbols to be macros).  Remove term.c's invocation of the
roff_getstrn() function.  Removed function documentation in roff.3 and
added roff.7 `ds' documentation.

Revert Makefile to using mandoc.c instead of libmandoc.c.  Remove
newborn libmandoc.c.

While here, remove superfluous dep of libman on mandoc.c.

Resurrect mandoc.c after bogus removal (was: libmandoc.c).

Give -T[x]html `Bk -words' capability.

Brought function arguments and style in ine with term_word() in term.c
to make sharing of TERMP_KEEP easier.

Clarified `Bk' operation in mdoc.7.

Documented `En', `Es', `Hf', `Ic', `Lp', `Nd', `No', `Oc', `Oo', `Op',
`Pa', `Pc', `Po', `Pq', `Pp', and `Va'.

Proper `Bk -words' support: only suppress breaks within a line, but
allow end-of-line to break.  This fixes the bad behaviour found when
macros within `Bk' never break.

"Excellent" schwarze@

Move register information into mandoc.h, which is where it should have
been in the first place (mandoc.h contains system-wide declarations).

Renamed mandoc.c to libmandoc.c.  This is in the efforts of getting a
cleaner namespace for functions across the entire system (mandoc.h:
getting parsed-string values, or declarations necessary for the AST
data), and compiler functions (libmandoc.h: back-end functions and
declarations).

Manual clean-ups.  Add syntax message for `Bd', `Bk', and `Bl'.
Document `Eo' and `Ec'.  Add context-end notes `Ec' and `Fc'.

Remove caching TODO: this has been committed.

Suppress duplicate "Page: 1 1" -Tps printing and instead relay on
PS_NEWPAGE to do the job for us.  Noted by Dillo.

Assert my copyright, making it explicit that i'm granting the same license
on those parts of the code and text that i have written as Kristaps is.
"fine with me" kristaps@

Cache column sizes and char pointer into mdoc_bl.  Finally get rid of
the loops here and there to track down the MDOC_Column arguments.

gv(1) doesn't remember the last set font when displaying new pages, so
print it out for each new page.  This also prevents superfluous
printings of the font before the %%Page: comment has been displayed.

Set line-height to be 1.4em.  Removed check for minimum margins that are no
longer important.

Suppress printing blank eof pages in -Tps.  Delay printing of Page:
until actual text is ready to be displayed.

Suppress printing of newlines/space at start of new -Tps page.

Also renamed "psstate" -> "flags" (was wrongly implying some sort of
state machine).

Backed out margin calculations in favour of much simpler rule of thumb:
margins are 1/9 the length/width.

Auto-margins.  Documented in mandoc.1.  Also bumped line-height and made
sure header and footer accomodate for said line-height.

Allow empty `Fo' to get by without an assertion.

Note to myself on what I need to do regarding inter-library functions.

Rudimentary implementation of user-defined strings;
no time for more refinement right now.
In particular, fixes terminfo(3) and mdoc.samples(7).
ok kristaps@, who will add the HTML frontend bits

The roff escape function "\s" is definitely not urgent,
but it is used in the tree and we should not forget.

Not only for -tag lists, but for -hang, -ohang, -inset, -diag,
and -item list as well, empty bodies are OK, they do not even
warrant a warning, much less the error they were throwing.
According to kristaps, joerg@ also brought this up some time ago.
ok kristaps@ jmc@

Cached `An' arguments in struct mdoc_an.  Note that this isn't a
pointer like the other data members, as there's no need to copy it around.

Fix: was checking HEAD for arguments.

Add documentation for Bf/Ef.

Stash `Bf' parameters into struct mdoc_bf.

Lint fixes.

Lint tweak.

Added TODO to sanitise `Nm' blocks such that HEAD optionally contains
only a TEXT element consisting of the name.

Implemented -Thtml bits for handling `Nm' blocks.

Remove my own dumb FIXME and mark a static function defn as static.

Make struct_bl and struct_bd into pointers.  This removes the need to do
copying on internals after modification.  Even more importantly, if an
ENDBODY token is provided, it would have been impossible for post-change
copying of the data to take place in the BLOCK.  This allows it to
happen by dint of pointers.

Also did some bikeshedding in mdoc_term.c: checking against enum type
and explicitly casting to the "post" function to void.  This is for my
own readability.

In the mdoc(7) parser, inspect roff registers early such that all parts
of the parser can use the resulting cues.  In particular, this allows
to use .nr nS to force SYNOPSIS-style .Nm indentation outside the
SYNOPSIS as needed by ifconfig(8).

To actually make this useable, .Pp must rewind .Nm, or the rest of the
section would end up indented.  Implement a quick hack for now,
a generic solution can be designed later.

ok kristaps@ and tested by sobrado@

Prevent validator from puking on ENDBODY `Bl' nodes.

Correct handling of trailing punctuation in MDOC_DELIM blk_full HEADs.
The bug was uncovered by SYNOPSIS .Nm as this happened to be the first
block with this particular combination of properties.
Found the hard way by kristaps@ in NetBSD gcc-contrib(1),
fix by me.

Improve .Nm indentation in the SYNOPSIS;
kristaps@ will do the missing HTML part soon.
"looks nicer" jmc@
"seems perfect to me" sobrado@
"slap it in" kristaps@

More reality-checks for the p->end type.

p->end is an enum: treat it as such.