[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 03/06: doc/groff.texi: Relocate some string material.
From: |
G. Branden Robinson |
Subject: |
[groff] 03/06: doc/groff.texi: Relocate some string material. |
Date: |
Wed, 29 Jul 2020 06:20:20 -0400 (EDT) |
gbranden pushed a commit to branch master
in repository groff.
commit 7dde6e243dc4a3aa843d2bacdb1c1a8066edda30
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Mon Jul 27 21:40:08 2020 +1000
doc/groff.texi: Relocate some string material.
This is a relocation-only commit (almost) in preparation for editorial
work.
The exception involves movement of the .T string description from the
node "Built-in Registers" to the node "Strings". The former was in a
table, so adjust whitespace, drop the @item macro and wrap it in (local)
Defstr macros at its destination to prevent parsing problems.
---
doc/groff.texi | 67 +++++++++++++++++++++++++++++-----------------------------
1 file changed, 34 insertions(+), 33 deletions(-)
diff --git a/doc/groff.texi b/doc/groff.texi
index 819dc87..334e60a 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -6216,13 +6216,6 @@ information.
If @code{gtroff} is called with the @option{-T} command-line option, the
number register @code{.T} is set to@tie{}1, and zero otherwise.
@xref{Groff Options}.
-
-@item \*[.T]
-@stindex .T
-@cindex output device name string register (@code{.T})
-A single read-write string register that contains the current output
-device (for example, @samp{latin1} or @samp{ps}). This is the only
-string register defined by @code{gtroff}.
@end table
@@ -10395,6 +10388,14 @@ GNU @code{troff} has string variables, which are
entirely for user
convenience (i.e., there are no built-in strings except @code{.T}, but
even that is a read/write string variable).
+@Defstr {.T,}
+@stindex .T
+@cindex output device name string register (@code{.T})
+A single read-write string register that contains the current output
+device (for example, @samp{latin1} or @samp{ps}). This is the only
+string register defined by @code{gtroff}.
+@endDefstr
+
Although the following requests can be used to create strings, simply
using an undefined string will cause it to be defined as empty.
@xref{Identifiers}.
@@ -10649,6 +10650,32 @@ input token at the end.
Rudimentary string manipulation routines are given with the next several
requests.
+@Defreq {length, reg str}
+@cindex length of a string (@code{length})
+@cindex string, length of (@code{length})
+@cindex @code{length} request, and copy-in mode
+@cindex copy-in mode, and @code{length} request
+@cindex mode, copy-in, and @code{length} request
+Compute the number of characters of @var{str} and return it in the
+number register @var{reg}. If @var{reg} doesn't exist, it is created.
+@code{str} is read in copy mode.
+
+@Example
+.ds xxx abcd\h'3i'efgh
+.length yyy \*[xxx]
+\n[yyy]
+ @result{} 14
+@endExample
+@endDefreq
+
+@Defreq {chop, xx}
+Remove (chop) the last character from the macro, string, or diversion
+named @var{xx}. This is useful for removing the newline from the end of
+diversions that are to be interpolated as strings. This command can be
+used repeatedly; see @ref{Gtroff Internals}, for details on nodes
+inserted additionally by GNU @code{troff}.
+@endDefreq
+
@Defreq {substring, str n1 [@Var{n2}]}
@cindex substring (@code{substring})
Replace the string named @var{str} with the substring defined by the
@@ -10670,24 +10697,6 @@ the character before the last character has
index@tie{}@minus{}2, etc.
@endExample
@endDefreq
-@Defreq {length, reg str}
-@cindex length of a string (@code{length})
-@cindex string, length of (@code{length})
-@cindex @code{length} request, and copy-in mode
-@cindex copy-in mode, and @code{length} request
-@cindex mode, copy-in, and @code{length} request
-Compute the number of characters of @var{str} and return it in the
-number register @var{reg}. If @var{reg} doesn't exist, it is created.
-@code{str} is read in copy mode.
-
-@Example
-.ds xxx abcd\h'3i'efgh
-.length yyy \*[xxx]
-\n[yyy]
- @result{} 14
-@endExample
-@endDefreq
-
@DefreqList {stringdown, str}
@DefreqListEndx {stringup, str}
@cindex case-transforming a string (@code{stringdown}, @code{stringup})
@@ -10801,14 +10810,6 @@ To remove an alias, simply call @code{rm} on its name.
The object
itself is not destroyed until it has no more names.
@endDefreq
-@Defreq {chop, xx}
-Remove (chop) the last character from the macro, string, or diversion
-named @var{xx}. This is useful for removing the newline from the end of
-diversions that are to be interpolated as strings. This command can be
-used repeatedly; see @ref{Gtroff Internals}, for details on nodes
-inserted additionally by GNU @code{troff}.
-@endDefreq
-
@xref{Identifiers}, and @ref{Comments}.
@codequoteundirected off
@codequotebacktick off
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 03/06: doc/groff.texi: Relocate some string material.,
G. Branden Robinson <=