gbranden pushed a commit to branch master
in repository groff.
commit 54b2b3a8c7871ba36f0fa07118fa7a328c7b8e35
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sun Jul 21 12:36:00 2024 -0500
[mm]: Recognize an `AFX` hook macro.
* contrib/mm/mm/0.MT:
* contrib/mm/mm/4.MT:
* contrib/mm/mm/ms.cov: Call `AFX` hook macro if defined, instead of
default formatting of affiliated firm.
* contrib/mm/groff_mm.7.man (Macros) <AFX>: Document facility.
---
contrib/mm/ChangeLog | 8 ++++++++
contrib/mm/groff_mm.7.man | 30 ++++++++++++++++++++++++++++++
contrib/mm/mm/0.MT | 3 ++-
contrib/mm/mm/4.MT | 3 ++-
contrib/mm/mm/ms.cov | 3 ++-
5 files changed, 44 insertions(+), 3 deletions(-)
diff --git a/contrib/mm/ChangeLog b/contrib/mm/ChangeLog
index c85f5c954..10c734f42 100644
--- a/contrib/mm/ChangeLog
+++ b/contrib/mm/ChangeLog
@@ -1,3 +1,11 @@
+2024-07-21 G. Branden Robinson <[email protected]>
+
+ * mm/0.MT:
+ * mm/4.MT:
+ * mm/ms.cov: Call `AFX` hook macro if defined, instead of
+ default formatting of affiliated firm.
+ * groff_mm.7.man (Macros) <AFX>: Document facility.
+
2024-07-14 G. Branden Robinson <[email protected]>
* mm/4.MT (cov@print-abstract):
diff --git a/contrib/mm/groff_mm.7.man b/contrib/mm/groff_mm.7.man
index 1c6c211fc..d02bd721d 100644
--- a/contrib/mm/groff_mm.7.man
+++ b/contrib/mm/groff_mm.7.man
@@ -716,6 +716,36 @@ and
.
.
.TP
+.B AFX
+This user-definable hook macro assumes responsibility for formatting
+the affiliated firm name defined by
+.B AF
+in memorandum types 0 and 4 and documents using the
+.I ms
+cover page style.
+.
+If not defined
+(the default),
+internally defined macros handle this task;
+see sections \[lq]Internals\[rq] and \[lq]Files\[rq] below.
+.
+Applications include setting the firm name in a different font family,
+at a larger type size,
+drawing a rule across the page,
+and including an logo image using
+.IR groff 's
+.B PDFPIC
+or
+.B PSPIC
+macros.
+.
+See
+.B MT
+and
+.BR COVER .
+.
+.
+.TP
.BR AL \~[\c
.IR number-format \~[ text-indent \~[\c
.BR 1 ]]]
diff --git a/contrib/mm/mm/0.MT b/contrib/mm/mm/0.MT
index 0fd3b676e..d7beb81a3 100644
--- a/contrib/mm/mm/0.MT
+++ b/contrib/mm/mm/0.MT
@@ -239,7 +239,8 @@ http://savannah.gnu.org/bugs/?group=groff.
.\" definition.)
.if !d cov*mt-printed \{\
. cov@print-title subject
-. cov@print-firm
+. ie d AFX .AFX
+. el .cov@print-firm
. cov@print-date date
. cov@print-authors from
. cov@print-abstract \\*[Abstract]
diff --git a/contrib/mm/mm/4.MT b/contrib/mm/mm/4.MT
index cf9c77a36..aae99d3bb 100644
--- a/contrib/mm/mm/4.MT
+++ b/contrib/mm/mm/4.MT
@@ -98,7 +98,8 @@ http://savannah.gnu.org/bugs/?group=groff.
.if !d cov*mt-printed \{\
. cov@print-title
. cov@print-authors
-. cov@print-firm
+. ie d AFX .AFX
+. el .cov@print-firm
. if d cov*abstract \{\
. if !\n[cov*abstract-placement] .cov@print-abstract
. \}
diff --git a/contrib/mm/mm/ms.cov b/contrib/mm/mm/ms.cov
index 53df6d7f3..1c1ddb30c 100644
--- a/contrib/mm/mm/ms.cov
+++ b/contrib/mm/mm/ms.cov
@@ -101,7 +101,8 @@ http://savannah.gnu.org/bugs/?group=groff.
.sp |4.2c
.cov@print-title
.cov@print-authors
-.cov@print-firm
+.ie d AFX .AFX
+.el .cov@print-firm
.cov@print-abstract "\\*[Abstract]"
.cov@print-date
.pg@enable-top-trap
_______________________________________________
Groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
