gbranden pushed a commit to branch master
in repository groff.
commit 8aae1a7f7a40e82dec4cd369b933d22726cbbd49
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sun Jul 14 10:09:14 2024 -0500
tmac/an-ext.tmac: Improve internal documentation.
---
tmac/an-ext.tmac | 15 ++++++++++++---
1 file changed, 12 insertions(+), 3 deletions(-)
diff --git a/tmac/an-ext.tmac b/tmac/an-ext.tmac
index 9c59c5081..d31b5160e 100644
--- a/tmac/an-ext.tmac
+++ b/tmac/an-ext.tmac
@@ -33,7 +33,9 @@
.if \n(mZ>1 \
. nx
.
-.\" Define this to your implementation's constant-width typeface.
+.\" Set `mC` this to your implementation's constant-width typeface.
+.\" There is no globally portable choice; `CW`, `C`, and `CR` are all
+.\" seen. AT&T troff offers no mechanism to query font availability.
.ds mC CW
.if n .ds mC R
.
@@ -53,7 +55,8 @@
.nr mE 0 \" in an example (EX/EE)?
.
.
-.\" Declare start of command synopsis. Sets up hanging indentation.
+.\" Declare start of a command or function synopsis.
+.\" .SY keyword [punctuation]
.de SY
. ie \\n(.$ \{\
. if !\\n(mS \{\
@@ -95,7 +98,9 @@
..
.
.
-.\" End of command synopsis.
+.\" End a synopsis. With any argument, the next `SY` call on the page
+.\" reuses the indentation computed for the one ended by this call.
+.\" .YS [argument]
.de YS
. in \\n(mIu
. ad \\n(mA
@@ -129,6 +134,7 @@
.
.
.\" Start URL.
+.\" .UR url
.if \n(.g-\n(mG \{\
.de UR
. mV \\$1
@@ -137,6 +143,7 @@
.
.
.\" End URL.
+.\" .UE [punctuation]
.if \n(.g-\n(mG \{\
.de UE
. mQ \\$1
@@ -145,6 +152,7 @@
.
.
.\" Start email address.
+.\" .MT address
.if \n(.g-\n(mG \{\
.de MT
. mV \\$1
@@ -153,6 +161,7 @@
.
.
.\" End email address.
+.\" .ME [punctuation]
.if \n(.g-\n(mG \{\
.de ME
. mQ \\$1
_______________________________________________
Groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
