groff-commit
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[groff] 09/33: doc/groff.texi (Strings, String Index): Tweak.


From: G. Branden Robinson
Subject: [groff] 09/33: doc/groff.texi (Strings, String Index): Tweak.
Date: Sun, 16 Oct 2022 15:52:17 -0400 (EDT)

gbranden pushed a commit to branch master
in repository groff.

commit a3a7f6e0edcbb875e658b2e6e0faac9695872380
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Tue Oct 11 01:56:56 2022 -0500

    doc/groff.texi (Strings, String Index): Tweak.
    
    * (Strings) Stop presenting the idea of nested interpolations here; it
      is already presented in "Using Escape Sequences".
    * (Strings) Add obligatory notice and cross reference regarding
      delimiters.
---
 doc/groff.texi | 22 ++++++++--------------
 1 file changed, 8 insertions(+), 14 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index a7ec0b567..349c32c40 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -12004,13 +12004,11 @@ invocations, however, a closing bracket as a string 
argument must be
 enclosed in double quotes.  @code{\\*} is interpreted even in copy mode
 (@pxref{Copy Mode}).
 
-The @code{\*} escape @dfn{interpolates} (expands in place) a previously
-defined string variable @var{name} (one-character name@tie{}@var{n},
-two-character name @var{nm}).  More precisely, the stored string is
-pushed onto the input stack, which is then parsed normally.  Similarly
-to registers, it is possible to nest strings; i.e., string variables can
-be called within string variables.  An argument in a string definition
-must be escaped for correct behavior;
+The @code{\*} escape sequence @dfn{interpolates} (expands in place) a
+previously defined string variable @var{name} (one-character
+name@tie{}@var{n}, two-character name @var{nm}).  The delimited form
+need not use the neutral apostrophe; see @ref{Delimiters}.  An argument
+in a string definition must be escaped for correct behavior;
 @xref{Parameters}.
 
 @Example
@@ -18519,13 +18517,9 @@ They appear without the leading control character 
(normally @samp{.}).
 @node String Index, File Keyword Index, Macro Index, Top
 @appendix String Index
 
-The macro package or program a specific string belongs to is appended in
-brackets.
-
-A string name@tie{}@code{x} consisting of exactly one character can be
-accessed as @samp{\*x}.  A string name @code{xx} consisting of exactly
-two characters can be accessed as @samp{\*(xx}.  String names @code{xxx}
-of any length can be accessed as @samp{\*[xxx]}.
+The macro package or program a that defines or uses each string is
+appended in brackets. (Only one string, @code{.T}, is defined by the
+@code{troff} formatter itself.)  @xref{Strings}.
 
 
 @printindex st



reply via email to

[Prev in Thread] Current Thread [Next in Thread]