From 252a944b7db71569915192fbfd903fc7f30a93c9 Mon Sep 17 00:00:00 2001
From: wlemb <wlemb>
Date: Thu, 27 Feb 2003 15:54:53 +0000
Subject: * doc/texinfo.tex: New version 2003-02-11.06.

* tmac/doc-common (Dt): Don't emit warning for unknown section.
* tmac/groff_mdoc.man: Fix description of `Dt'.

* font/devps/prologue.ps: Fix for included Postscript that does
a setpagedevice -- which is now safely ignored.

* NEWS: Updated.

* src/devices/grops/ps.cc: Now sets the page size in the generated
document.  This is done in two ways: Via a %%-comment for gv and
the like, and via a PageSize and setpagedevice for programs that
understands Postscript proper, like ps2pdf.

* src/devices/grops/ps.h: New broken-flag to avoid page size
definition, if required.

* src/devices/grops/grops.man: New broken-flag 16 mentioned.

* doc/Makefile.in: Added -nosetpage flag (via @pnmtops_nosetpage@).
Not really necessary due to the fix in prologue.ps, but cleaner:
Such information does not belong in an .eps file.

* doc/Makefile.sub: See doc/Makefile.in.

* aclocal.m4 (GROFF_PNMTOPS_NOSETPAGE): Use P2 format for testing
instead of P1 since the latter is broken in some versions of netpbm.
* configure: Updated.
---
 tmac/groff_mdoc.man | 19 ++++++++++++++++++-
 1 file changed, 18 insertions(+), 1 deletion(-)

(limited to 'tmac/groff_mdoc.man')

diff --git a/tmac/groff_mdoc.man b/tmac/groff_mdoc.man
index 5033cb57..e39df7a2 100644
--- a/tmac/groff_mdoc.man
+++ b/tmac/groff_mdoc.man
@@ -46,7 +46,7 @@
 .\" for an already extremely slow package.
 .\"
 .
-.Dd October 07, 2002
+.Dd February 27, 2003
 .Os
 .Dt GROFF_MDOC 7
 .
@@ -778,14 +778,27 @@ By default, the following architecture keywords are defined:
 .Ed
 .Pp
 .
+If the section number is neither a numeric expression in the range 1 to\~9
+nor one of the above described keywords, the third parameter is used
+verbatim as the volume name.
+.Pp
 In the following examples, the left (which is identical to the right) and
 the middle part of the manual page header strings are shown.
+Note how
+.Ql \e&
+prevents the digit\~1 from being a valid numeric expression.
 .
 .Bd -ragged
 .Bl -tag -width ".Li .Dt\ FOO\ 2\ i386" -compact -offset indent
 .It Li ".Dt FOO 7"
 .Ql FOO(7)
 .Ql \*[volume-operating-system] \*[volume-ds-7]
+.It Li ".Dt FOO 7 bar"
+.Ql FOO(7)
+.Ql \*[volume-operating-system] \*[volume-ds-7]
+.It Li ".Dt FOO \e&7 bar"
+.Ql FOO(7)
+.Ql bar
 .It Li ".Dt FOO 2 i386"
 .Ql FOO(2)
 .Ql \*[volume-operating-system]/\*[volume-as-i386] \*[volume-ds-2]
@@ -3064,11 +3077,13 @@ display must be ended with the
 macro.
 It has the following syntax:
 .Pp
+.Bd -ragged -compact
 .Bl -tag -width ".Li .Bd" -offset indent
 .It Li .Bd Xo
 .Bro \-literal | \-filled | \-unfilled | \-ragged | \-centered Brc
 .Oo \-offset Ao string Ac Oc Oo \-file Ao file name Ac Oc Oo \-compact Oc Xc
 .El
+.Ed
 .Pp
 .
 .Bl -tag -width ".Fl file Ao Ar file name Ac " -compact
@@ -3194,6 +3209,7 @@ Most of this document has been formatted with a tag style list
 It has the following syntax forms:
 .
 .Pp
+.Bd -ragged -compact
 .Bl -tag -width ".Li .Bl" -offset indent -compact
 .It Li .Bl Xo
 .Bro \-hang | \-ohang | \-tag | \-diag | \-inset Brc
@@ -3206,6 +3222,7 @@ It has the following syntax forms:
 .Bro \-item | \-enum Oo \-nested Oc | \-bullet | \-hyphen | \-dash Brc
 .Oo \-offset Ao string Ac Oc Oo \-compact Oc Xc
 .El
+.Ed
 .Pp
 .
 And now a detailed description of the list types.
-- 
cgit v1.2.1