[groff] 03/03: Add comments to annotate locally-defined font change macros.

[Keith Marshall]

keithmarshall pushed a commit to branch master
in repository groff.

commit fb63a9cde48fbf2cb654ae5752693afbba44b5c6
Author: Keith Marshall <keith.d.marshall@ntlworld.com>
AuthorDate: Mon Sep 13 22:29:16 2021 +0100

    Add comments to annotate locally-defined font change macros.
    
    * pdfmark.ms (EM): Annotate this locally-defined emphasis macro...
    (CWB, CWI, CWBI): ...these constant width font interpolation macros...
    (=): ...and this locally-defined IP tag variant string.
---
 contrib/pdfmark/ChangeLog  | 39 +++++++++++++++++++++++++++++++++++++++
 contrib/pdfmark/pdfmark.ms | 17 +++++++++++++++++
 2 files changed, 56 insertions(+)

diff --git a/contrib/pdfmark/ChangeLog b/contrib/pdfmark/ChangeLog
index 25a06c3..8728b6c 100644
--- a/contrib/pdfmark/ChangeLog
+++ b/contrib/pdfmark/ChangeLog
@@ -1,3 +1,42 @@
+2021-09-13  Keith Marshall  <keith.d.marshall@ntlworld.com>
+
+       Add comments to annotate locally-defined font change macros.
+
+       * pdfmark.ms (EM): Annotate this locally-defined emphasis macro...
+       (CWB, CWI, CWBI): ...these constant width font interpolation macros...
+       (=): ...and this locally-defined IP tag variant string.
+
+2021-09-13  Keith Marshall  <keith.d.marshall@ntlworld.com>
+
+       Update defunct internet URL references.
+
+       * pdfmark.ms (pdfmark-manual): Adobe moved the document (again);
+       update the document reference macro, to follow the URL relocation.
+       (www.mingw.org): The MinGW Project has relinquished this domain;
+       update the URL reference, to follow web-site relocation to...
+       (mingw.osdn.io): ...here.
+
+2021-09-13  Keith Marshall  <keith.d.marshall@ntlworld.com>
+
+       Factor document-specific bloat out of spdf.tmac
+
+       * spdf.tmac: Reorganize; add many comments.
+       (XN): Retained, but reimplemented, to serve as...
+       (XH, XN): ...both of these; add callback hooks for...
+       (XH-INIT, XN-INIT, XH-UPDATE-TOC): ...these; provide no-op stubs;
+       factor out TOC collection code, delegating to XH-UPDATE-TOC.
+       (opt*XN-N, opt*XN-S, opt*XN-X): Rename internal macros to...
+       (de spdf:XH-N, de spdf:XH-S, de spdf:XH-X): ...these, respectively.
+       (AN, @AN, IE, IS, LU, NN, PXREF, SAME-PAGE, XM): Delete; we do not
+       require these; if users do, they should define their own.
+       (pdf@toc): Delete internal macro; fold body into...
+       (TC): ...this.
+
+       * pdfmark.ms (XH-UPDATE-TOC): Implement callback; it is based on...
+       (XN): ...original implementation of this, factored out of spdf.tmac,
+       but with significant simplification, to remove unnecessary code.
+       (XNVS1, XNVS2, XNVS3): Tighten vertical spacing.
+
 2021-09-04  Keith Marshall  <keith.d.marshall@ntlworld.com>
 
        Reduce potential for user-space exposure of "ms" internals.
diff --git a/contrib/pdfmark/pdfmark.ms b/contrib/pdfmark/pdfmark.ms
index 6eaa93e..a930fc7 100644
--- a/contrib/pdfmark/pdfmark.ms
+++ b/contrib/pdfmark/pdfmark.ms
@@ -86,11 +86,22 @@ Publishing with GNU Troff
 .\"
 .nr GROWPS 4
 .nr PSINCR 1.5p
+.
+.\" Define a local macro to facilitate choice of style for emphasis;
+.\" by default, make it equivalent to the ms standard "I" macro.
 .\"
 .de EM
 .\".I "\s'+0.3'\\$1\s0" "\\$2" "\\$3"
 .I \\$@
 ..
+.\" Also, define variations on the ms standard "CW" macro, to add
+.\" bold, italic, and both styles to constant width text; note that
+.\" each of these accept two additional arguments, in comparison to
+.\" standard "CW", such that \$1 specifies the text which is to be
+.\" styled, \$2 and \$3 specify inner after/before bracketting, to
+.\" set as regular "CW" text,  while \$4 and \$5 become equivalent
+.\" to \$2 and \$3 of standard "CW", acting as outer bracketting.
+.\"
 .de CWB
 \\$5\fC\\$3\fP\f(CB\\$1\fP\fC\\$2\fP\\$4
 ..
@@ -100,6 +111,12 @@ Publishing with GNU Troff
 .de CWBI
 \\$5\fC\\$3\fP\f[CBI]\\$1\fP\fC\\$2\fP\\$4
 ..
+.\" Finally, augment this group with a variant string, which may be
+.\" used to set constant width tags on "IP" paragraphs, with \$1 set
+.\" as if by "CWB", followed by an optional suffix set as if by "CWBI",
+.\" and with the suffix bracketted by \$3 after and \$4 before, each
+.\" set in the regular "CW" style.
+.\"
 .ds = \f(CB\\$1\f(CR\\$4\f[CBI]\\$2\f(CR\\$3
 .
 .NH 1