From owner-freebsd-doc@FreeBSD.ORG Thu Jul 3 12:18:59 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 12E6937B401 for ; Thu, 3 Jul 2003 12:18:59 -0700 (PDT) Received: from whale.sunbay.crimea.ua (whale.sunbay.crimea.ua [212.110.138.65]) by mx1.FreeBSD.org (Postfix) with ESMTP id 497EB43FEC for ; Thu, 3 Jul 2003 12:18:51 -0700 (PDT) (envelope-from ru@sunbay.com) Received: from whale.sunbay.crimea.ua (ru@localhost [127.0.0.1]) h63JIfVU084032 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Thu, 3 Jul 2003 22:18:41 +0300 (EEST) (envelope-from ru@sunbay.com) Received: (from ru@localhost) by whale.sunbay.crimea.ua (8.12.9/8.12.8/Submit) id h63JIeR2084027 for doc@FreeBSD.org; Thu, 3 Jul 2003 22:18:40 +0300 (EEST) (envelope-from ru) Date: Thu, 3 Jul 2003 22:18:40 +0300 From: Ruslan Ermilov To: doc@FreeBSD.org Message-ID: <20030703191840.GC78376@sunbay.com> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="hUH5gZbnpyIv7Mn4" Content-Disposition: inline User-Agent: Mutt/1.5.4i Subject: HEADS UP: New mdoc(7) features X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 03 Jul 2003 19:18:59 -0000 --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 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 : =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--