[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 17/30: groff(7) (Strings): Fix style nits.
From: |
G. Branden Robinson |
Subject: |
[groff] 17/30: groff(7) (Strings): Fix style nits. |
Date: |
Sun, 22 Dec 2024 19:39:19 -0500 (EST) |
gbranden pushed a commit to branch master
in repository groff.
commit c9fc63b7577c0e15eb2131ccf111c6b0212b085b
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sat Dec 21 18:05:06 2024 -0600
groff(7) (Strings): Fix style nits.
Stop naming requests with a leading dot. That's a traning wheel for
*roff novices. On the other hand, some request names are confusable
with English words, so quote them in addition to setting them in bold,
to avoid such confusion (even if bold styling is stripped).
---
man/groff.7.man | 34 +++++++++++++++++-----------------
1 file changed, 17 insertions(+), 17 deletions(-)
diff --git a/man/groff.7.man b/man/groff.7.man
index 554366c4c..784e23c09 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -6067,16 +6067,16 @@ or
.
.P
The
-.request .ds
+.request ds
request creates a string with a specified name and contents.
.
If the identifier named by
-.request .ds
+.request ds
already exists as an alias,
the target of the alias is redefined.
.
If
-.request .ds
+.request ds
is called with only one argument,
the named string becomes empty.
.
@@ -6166,13 +6166,13 @@ see section \[lq]Punning names\[rq] below.
.
.P
The
-.request .as
+.RB \[lq] as \[rq]
request is similar to
-.request .ds
+.request ds
but appends to a string instead of redefining it.
.
If
-.request .as
+.RB \[lq] as \[rq]
is called with only one argument,
no operation is performed
(beyond dereferencing the string).
@@ -6186,13 +6186,13 @@ compatibility mode enablement when interpolated;
see section \[lq]Compatibility mode\[rq] below.
.
The
-.request .ds1
+.request ds1
request defines a string that suspends compatibility mode when the
string is later interpolated.
.
-.request .as1
+.request as1
is likewise similar to
-.BR .as ,
+.RB \[lq] as \[rq],
with compatibility mode suspended when the appended portion of the
string is later interpolated.
.
@@ -6219,20 +6219,20 @@ Several requests exist to perform rudimentary string
operations.
.
Strings can be queried
(\c
-.request .length )
+.request length )
and modified
(\c
-.request .chop ,
-.request .substring ,
-.request .stringup ,
-.request .stringdown ),
+.request chop ,
+.request substring ,
+.request stringup ,
+.request stringdown ),
and their names can be manipulated through renaming,
removal,
and aliasing
(\c
-.request .rn ,
-.request .rm ,
-.request .als).
+.request rn ,
+.request rm ,
+.request als).
.
.
.br
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 17/30: groff(7) (Strings): Fix style nits.,
G. Branden Robinson <=