Skip site navigation (1)Skip section navigation (2)
Date:      Thu, 3 Jul 2003 22:18:40 +0300
From:      Ruslan Ermilov <ru@FreeBSD.org>
To:        doc@FreeBSD.org
Subject:   HEADS UP: New mdoc(7) features
Message-ID:  <20030703191840.GC78376@sunbay.com>

next in thread | raw e-mail | index | archive | help

--hUH5gZbnpyIv7Mn4
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

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

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

: ru          2003/07/03 09:46:09 PDT
:=20
:   FreeBSD src repository
:=20
:   Modified files:        (Branch: FSF)
:     contrib/groff/tmac   doc-common doc.tmac groff_mdoc.man=20
:   Log:
:   Update mdoc(7) to the current version.  From ChangeLog:
:  =20
:   2003-07-01  Ruslan Ermilov  <ru@FreeBSD.org>
:  =20
:           * 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.
:  =20
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.
:  =20
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 -----

--=20
Ruslan Ermilov		Sysadmin and DBA,
ru@sunbay.com		Sunbay Software Ltd,
ru@FreeBSD.org		FreeBSD committer

--hUH5gZbnpyIv7Mn4
Content-Type: application/pgp-signature
Content-Disposition: inline

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.1 (FreeBSD)

iD8DBQE/BIGQUkv4P6juNwoRAh+iAJ9slo55cBb2oQw9QwtxijT7Th1oqACeIwBf
cLZryZMRV/LjD4QLMxV1yjU=
=PyZt
-----END PGP SIGNATURE-----

--hUH5gZbnpyIv7Mn4--



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030703191840.GC78376>