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

[Werner LEMBERG]

CVSROOT:        /cvsroot/groff
Module name:    groff
Changes by:     Werner LEMBERG <wl>     11/02/14 08:26:28

Modified files:
        .              : ChangeLog 
        doc            : groff.texinfo 

Log message:
        * doc/groff.texinfo: Add another example for .em request
        Based on a patch from Anton Shepelev <address@hidden>.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/groff/ChangeLog?cvsroot=groff&r1=1.1291&r2=1.1292
http://cvs.savannah.gnu.org/viewcvs/groff/doc/groff.texinfo?cvsroot=groff&r1=1.303&r2=1.304

Patches:
Index: ChangeLog
===================================================================
RCS file: /cvsroot/groff/groff/ChangeLog,v
retrieving revision 1.1291
retrieving revision 1.1292
diff -u -b -r1.1291 -r1.1292
--- ChangeLog   31 Jan 2011 11:49:43 -0000      1.1291
+++ ChangeLog   14 Feb 2011 08:26:27 -0000      1.1292
@@ -1,3 +1,8 @@
+2011-02-14  Werner LEMBERG  <address@hidden>
+
+       * doc/groff.texinfo: Add another example for .em request
+       Based on a patch from Anton Shepelev <address@hidden>.
+
 2011-01-31  Werner LEMBERG  <address@hidden>
 
        More fixes for Savannah bug #32301.

Index: doc/groff.texinfo
===================================================================
RCS file: /cvsroot/groff/groff/doc/groff.texinfo,v
retrieving revision 1.303
retrieving revision 1.304
diff -u -b -r1.303 -r1.304
--- doc/groff.texinfo   30 Jan 2011 17:38:21 -0000      1.303
+++ doc/groff.texinfo   14 Feb 2011 08:26:27 -0000      1.304
@@ -12676,6 +12676,33 @@
 Note that this specific feature affects only the first potential page
 break caused by the end macro; further page breaks emitted by the end
 macro are handled normally.
+
+Another possible use of the @code{em} request is to make @code{gtroff}
+emit a single large page instead of multiple pages.  For example, one
+may want to produce a long plain-text file for reading on-screen.  The
+idea is to set the page length at the beginning of the document to a
+very large value to hold all the text, and automatically adjust it to
+the exact height of the document after the text has been output.
+
address@hidden
+.de adjust-page-length
+.  br
+.  pl \\n[nl]u   \" \n[nl] holds the current page length
+..
+.
+.de single-page-mode
+.  pl 99999
+.  em adjust-page-length
+..
+.
+.\" activate the above code
+.single-page-mode
address@hidden
+
+Since only one end-of-input trap does exist and other macro packages
+may already use it, care must be taken not to break the mechanism.  A
+simple solution would be to append the above macro to the macro
+package's end-of-input macro using the @code{.am} request.
 @endDefreq