[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 24/41: groff_tmac(5): Recast auxiliary pkg descriptions.
From: |
G. Branden Robinson |
Subject: |
[groff] 24/41: groff_tmac(5): Recast auxiliary pkg descriptions. |
Date: |
Sat, 5 Mar 2022 16:06:17 -0500 (EST) |
gbranden pushed a commit to branch master
in repository groff.
commit 2ec4f1d24218e212d59727a37343f03f2fd937d2
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sat Mar 5 03:14:20 2022 +1100
groff_tmac(5): Recast auxiliary pkg descriptions.
Parallelize and tighten wording.
---
man/groff_tmac.5.man | 93 ++++++++++++++++++++++++++++++++--------------------
1 file changed, 57 insertions(+), 36 deletions(-)
diff --git a/man/groff_tmac.5.man b/man/groff_tmac.5.man
index 55d40cee..71a50838 100644
--- a/man/groff_tmac.5.man
+++ b/man/groff_tmac.5.man
@@ -462,47 +462,53 @@ fonts which contain the necessary glyphs.
The macro packages in this section are not intended for stand-alone
use,
but can add functionality to any other macro package or to plain
-(or \[lq]raw\[rq])
+(\[lq]raw\[rq])
.I groff
documents.
.
.
-.TP 9n
+.\" TODO:
+.\" a4
+.\" devtag
+.\" doc-old
+.\" europs
+.\" psatk
+.\" psfig
+.\" psold
+.TP 9n \" 'papersize'
.I 62bit
provides macros for addition,
multiplication,
and division of 62-bit integers
-(allowing safe multiplication of 31-bit integers,
+(allowing safe multiplication of signed 31-bit integers,
for example).
.
.
.TP
.I ec
-switches the
-.MR grodvi @MAN1EXT@
-output driver from the CM
-(Computer Modern)
-to the EC and TC font families.
+configures the
+.B dvi
+output device to use
+the EC and TC font families instead of CM
+(Computer Modern).
.
-The
-.I \%grodvi
-man page has further details.
+See
+.MR grodvi @MAN1EXT@ .
.
.
.TP
.I hdtbl
-The Heidelberger table macros,
-contributed by Joachim Walsdorff,
-allow the generation of tables through a syntax similar to the HTML
-table model.
+allows the generation of tables using a syntax similar to the HTML table
+model.
.
-.I hdtbl
-is a macro package,
-not a preprocessor like
-.MR tbl @MAN1EXT@ .
+This Heidelberger table macro package is not a preprocessor,
+which can be useful if the contents of table entries are determined by
+macro calls or string interpolations.
.
-.I hdtbl
-works only with the
+Compare to
+.MR @g@tbl @MAN1EXT@ .
+.
+It works only with the
.B ps
and
.B pdf
@@ -516,7 +522,7 @@ See
.I papersize
provides an interface to set the paper size on the command line by
giving
-.I \%@g@troff
+.I @g@troff
the
.BI "\-d \%paper=" size
option.
@@ -585,23 +591,41 @@ calls
with which it shares an interface
(see below).
.
+This macro file is normally loaded at startup by the
+.I troffrc
+file.
+.
.
.TP
.I pic
-This file provides proper definitions for the macros
+supplies definitions of the macros
.BR PS ,
.BR PE ,
and
.BR PF ,
-needed for the
+usable with the
.MR @g@pic @MAN1EXT@
preprocessor.
.
They center each picture.
.
-Use it only if your macro package doesn't provide proper definitions for
-those three macros
-(most of them already do).
+Use it if your document does not use a full-service macro package,
+or that package does not supply working
+.I pic
+macro definitions.
+.
+Except for
+.I man
+and
+.IR mdoc ,
+those provided with
+.I groff
+already do so
+(exception:
+.I mm
+employs the name
+.B PF
+for a different purpose).
.
.
.TP
@@ -869,9 +893,9 @@ for a demonstration.
.
.TP
.I trace
-Use this for tracing macro calls.
-.
-It is only useful for debugging.
+aids the debugging of
+.I groff
+documents by tracing macro calls.
.
See
.MR groff_trace @MAN7EXT@ .
@@ -879,22 +903,19 @@ See
.
.TP
.I tty\-char
-Defines fallback definitions of
+defines fallback definitions of
.I roff
special characters for terminal devices.
.
These definitions more poorly optically approximate typeset output
compared to those of the
.I tty
-file in favor of communicating more semantic information,
-which can allow easier processing with critical equipment.
-.\" XXX: critical equipment like what?
+file in favor of communicating more semantic information.
.
.
.TP
.I www
-Additions of elements known from the HTML format, as used in World
-Wide Web pages; this includes URL links and mail addresses.
+defines macros corresponding to HTML elements.
.
See
.MR groff_www @MAN7EXT@ .
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 24/41: groff_tmac(5): Recast auxiliary pkg descriptions.,
G. Branden Robinson <=