[Groff-commit] groff ChangeLog doc/groff.texinfo

[Werner LEMBERG]

CVSROOT:        /cvsroot/groff
Module name:    groff
Changes by:     Werner LEMBERG <wl>     12/09/21 04:58:33

Modified files:
        .              : ChangeLog 
        doc            : groff.texinfo 

Log message:
        * doc/groff.texinfo: Improve documentation of `.ad'.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/groff/ChangeLog?cvsroot=groff&r1=1.1354&r2=1.1355
http://cvs.savannah.gnu.org/viewcvs/groff/doc/groff.texinfo?cvsroot=groff&r1=1.311&r2=1.312

Patches:
Index: ChangeLog
===================================================================
RCS file: /cvsroot/groff/groff/ChangeLog,v
retrieving revision 1.1354
retrieving revision 1.1355
diff -u -b -r1.1354 -r1.1355
--- ChangeLog   20 Sep 2012 20:38:01 -0000      1.1354
+++ ChangeLog   21 Sep 2012 04:58:32 -0000      1.1355
@@ -1,3 +1,7 @@
+2012-09-21  Werner LEMBERG  <address@hidden>
+
+       * doc/groff.texinfo: Improve documentation of `.ad'.
+
 2012-09-20  Werner LEMBERG  <address@hidden>
 
        * doc/Makefile.sub (uninstall_sub): Fix removal of info files.

Index: doc/groff.texinfo
===================================================================
RCS file: /cvsroot/groff/groff/doc/groff.texinfo,v
retrieving revision 1.311
retrieving revision 1.312
diff -u -b -r1.311 -r1.312
--- doc/groff.texinfo   26 Jul 2012 06:12:41 -0000      1.311
+++ doc/groff.texinfo   21 Sep 2012 04:58:32 -0000      1.312
@@ -6674,28 +6674,52 @@
 Finally, @var{mode} can be the numeric argument returned by the
 @code{.j} register.
 
-With no argument, @code{gtroff} adjusts lines in the same way it did
-before adjusting was deactivated (with a call to @code{na}, for
-example).
+Using @code{ad} without argument is the same as saying
address@hidden@code{.ad \[.j]}}.  In particular, @code{gtroff} adjusts lines
+in the same way it did before adjusting was deactivated (with a call
+to @code{na}, say).  For example, this input code
 
 @Example
-text
-.ad r
+.de AD
+.  br
+.  ad \\$1
+..
+.
+.de NA
+.  br
+.  na
+..
+.
+textA
+.AD r
 .nr ad \n[.j]
-text
-.ad c
-text
-.na
-text
-.ad         \" back to centering
-text
-.ad \n[ad]  \" back to right justifying
+textB
+.AD c
+textC
+.NA
+textD
+.AD         \" back to centering
+textE
+.AD \n[ad]  \" back to right justifying
+textF
address@hidden
+
address@hidden
+produces the following output:
+
address@hidden
+textA
+                                                    textB
+                          textC
+textD
+                          textE
+                                                    textF
 @endExample
 
 @cindex adjustment mode register (@code{.j})
-The current adjustment mode is available in the read-only number
-register @code{.j}; it can be stored and subsequently used to set
-adjustment.
+As just demonstrated, the current adjustment mode is available in the
+read-only number register @code{.j}; it can be stored and
+subsequently used to set adjustment.
 
 The adjustment mode status is associated with the current environment
 (@pxref{Environments}).