HEADS UP: New mdoc(7) features

[Ruslan Ermilov]

Below is the more verbose explanation of the new features and
bugs fixed in mdoc(7).

----- Forwarded message from Ruslan Ermilov <ru at FreeBSD.org> -----

: ru          2003/07/03 09:46:09 PDT
: 
:   FreeBSD src repository
: 
:   Modified files:        (Branch: FSF)
:     contrib/groff/tmac   doc-common doc.tmac groff_mdoc.man 
:   Log:
:   Update mdoc(7) to the current version.  From ChangeLog:
:   
:   2003-07-01  Ruslan Ermilov  <ru at FreeBSD.org>
:   
:           * tmac/doc.tmac (doc-do-func, doc-do-func-args): Don't print a comma
:           after `/*' and `*/'.
:           Fix spacing.
:           (Fn, Fo): Reduce indentation in synopsis.
:   
See the recent lib/libc/gen/exec.3 commit.

:           * tmac/doc-common (doc-check-depth): New macro.
:           (doc-end-macro, Sh, Ss): Use it.

This improves self-diagnostic of mdoc(7); it now checks that
paired macros (.Bl/.El, .Bd/.Ed, and .Bf/.Ef) have zero balance,
at the beginning of each section/subsection.

:           (Cd): Fix behaviour in synopsis.

The .Cd macro can now be "called" normally in the SYNOPSIS section,
e.g., ".Pq Cd options FOO".

:           (In): Make it parsed and callable.
:           If not in the synopsis, represent the C header file enclosed in
:           angle brackets.

The .In macro can now be used instead of ugly ".Aq Pa foo.h";
see the updated mdoc(7) manpage for details.

:           (doc-str-Rv-std-suffix, doc-str-Rv-stds-suffix, doc-str-Rv-std0):
:           Use minus, not hyphen.
:   
These fixes are minor; the changes are only visible in the troff mode.

:   Revision  Changes    Path
:   1.1.1.15  +25 -3     src/contrib/groff/tmac/doc-common
:   1.1.1.11  +69 -17    src/contrib/groff/tmac/doc.tmac
:   1.1.1.14  +14 -4     src/contrib/groff/tmac/groff_mdoc.man

----- End forwarded message -----

-- 
Ruslan Ermilov		Sysadmin and DBA,
ru at sunbay.com		Sunbay Software Ltd,
ru at FreeBSD.org		FreeBSD committer
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 187 bytes
Desc: not available
URL: <http://lists.freebsd.org/pipermail/freebsd-doc/attachments/20030703/a47d76fe/attachment.sig>