[groff] 12/17: groff(7): Summarize .ta request more faithfully.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 7593293057e7a99d2697d5a2f1e8d22a97a75fe3
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Tue May 25 17:36:36 2021 +1000

    groff(7): Summarize .ta request more faithfully.
    
    * man/groff.7.man (Requests/Request short reference) <.ta>: Describe the
      request as tersely as possible without omitting its essential syntax
      and semantics.  (The AT&T troff "+" relative prefix for normally
      absolute positions ".ta 1i +1i +1i" and alignment-specifying suffixes
      "L", "R", and "C" had both been omitted.)
---
 ChangeLog       |  9 +++++++++
 man/groff.7.man | 35 ++++++++++++++++++++++++++++-------
 2 files changed, 37 insertions(+), 7 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index a70e21a..f327767 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,14 @@
 2021-05-25  G. Branden Robinson <g.branden.robinson@gmail.com>
 
+       * man/groff.7.man (Requests/Request short reference) <.ta>:
+       Describe the request as tersely as possible without omitting its
+       essential syntax and semantics.  (The AT&T troff "+" relative
+       prefix for normally absolute positions ".ta 1i +1i +1i" and
+       alignment-specifying suffixes "L", "R", and "C" had both been
+       omitted.)
+
+2021-05-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
        * man/groff.7.man (Registers/Writable registers): Fix error;
        \n[nl] interpolates the current vertical position, not the
        vertical position of the "last printed text baseline"; the
diff --git a/man/groff.7.man b/man/groff.7.man
index 0963068..89ee591 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -2799,12 +2799,7 @@ request (default scaling indicator\~\c
 Execute program
 .IR command-line .
 .
-.TPx
-.REQ .ta "T N"
-Set tabs after every position that is a multiple of
-.I N
-(default scaling indicator\~\c
-.scaleindicator m ).
+.
 .TPx
 .REQ .ta "n1 n2 \fR\&.\|.\|.\&\fP n\fRn\fP \f[CB]T\f[] r1 r2 \
 \fR\&.\|.\|.\&\fP r\fRn\fP"
@@ -2819,7 +2814,33 @@ through
 .IR n n+ m \[tmu] r n+ r n,
 where
 .I m
-increments from 0, 1, 2, \&.\|.\|.\& to infinity.
+increments from 0,
+1,
+2,
+\&.\|.\|.\& to the output line length.
+.
+Each
+.IR n \~argument
+can be prefixed with
+.RB a\~\[lq] + \[rq]
+to place the tab stop
+.I ni
+at a distance relative to the previous,
+.IR n ( i \-1).
+.
+Each argument
+.IR ni \~or\~ ri
+can be suffixed with a letter to align text within the tab column
+bounded by tab stops
+.IR i \~and\~ i +1;
+.RB \[lq] L \[rq]
+for left-aligned
+(the default),
+.RB \[lq] C \[rq]
+for centered,
+and
+.RB \[lq] R \[rq]
+for right-aligned.
 .
 .
 .TPx