gbranden pushed a commit to branch master
in repository groff.
commit 65e5d5eba5ba83f9473d3a502efad04c2c667d5d
Author: G. Branden Robinson <[email protected]>
AuthorDate: Thu Jul 9 09:01:39 2026 -0500
doc/ms.ms.in: Swap presentation order of XM, XR.
Not only is this ordering lexicographic, but I think it makes more sense
to first present the call that establishes the basis upon which the
"subsequent" (barring forward references) one operates.
Admittedly, the "expansion character" feature makes the conceptual
dependencies more circular. :-/
Bump document date.
---
doc/ms.ms.in | 30 +++++++++++++++---------------
1 file changed, 15 insertions(+), 15 deletions(-)
diff --git a/doc/ms.ms.in b/doc/ms.ms.in
index 147702ba7..a489028c5 100644
--- a/doc/ms.ms.in
+++ b/doc/ms.ms.in
@@ -44,7 +44,7 @@
.ds FR 1
.nr TC-MARGIN \w'00' \" expect 2-digit page numbers at most
.ds header-title Using \f[I]groff\f[] with the \f[I]ms\f[] macros\"
-.ds date April 2026\"
+.ds date July 2026\"
.ND \*[date]
.ds CH \" empty
.ie t \{\
@@ -4137,6 +4137,20 @@ cb cb
lf(CR) lx .
Macro Description
_
+\m[red].XM \f[I]name\f[] [\f[I]text\f[]]\m[] T{
+Mark a particular position in the document with a
+.I name .
+Any
+.I text
+given will be used to replace a trailing expansion character in an
+.CW .XR
+command which references the
+.I name .
+It is useful if you wish to name an arbitrary location in the
+document, so you can setup a link to a picture, diagram or even
+a single paragraph.
+T}
+_
\m[red].XR \f[I]name\f[] \f[R][\f[I]after\f[] [\f[I]before\f[] \
[\f[I]hotlink-text\f[]]]]\m[] T{
The
@@ -4171,20 +4185,6 @@ Which is initially set to
(Note the expansion character).
But you can change it.
T}
-_
-\m[red].XM \f[I]name\f[] [\f[I]text\f[]]\m[] T{
-Mark a particular position in the document with a
-.I name .
-Any
-.I text
-given will be used to replace a trailing expansion character in an
-.CW .XR
-command which references the
-.I name .
-It is useful if you wish to name an arbitrary location in the
-document, so you can setup a link to a picture, diagram or even
-a single paragraph.
-T}
.TE
.LP
Using
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
