* man/groff_diff.man: Adding documentation for \O.

2 files changed, 81 insertions, 1 deletions

diff --git a/ChangeLog b/ChangeLog
index d63f5239..817c4c56 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+2001-12-10  Gaius Mulley  <gaius@glam.ac.uk>
+
+	* man/groff_diff.man: Adding documentation for \O.
+
 2001-12-10  Werner LEMBERG  <wl@gnu.org>
 
 	* src/preproc/html/pre-html.cc (TROFF_COMMAND): Removed.
diff --git a/man/groff_diff.man b/man/groff_diff.man
index 9cabdd1a..d5170e49 100644
--- a/man/groff_diff.man
+++ b/man/groff_diff.man
@@ -1,7 +1,7 @@
 .ig
 groff_diff.man
 
-Last update : 14 Nov 2001
+Last update : 9 Dec 2001
 
 This file is part of groff, the GNU roff type-setting system.
 
@@ -397,6 +397,82 @@ the
 escape sequence is the only way to use these.
 .
 .TP
+.BI \eO n
+Suppressing troff output.
+The escapes
+.BR \e02 ,
+.BR \eO3 ,
+.BR \eO4 ,
+and
+.B \eO5
+are intended for internal use by
+.BR grohtml .
+.
+.TP
+.B \eO0
+Disable any ditroff glyphs from being emitted to the device driver, provided
+that the escape occurs at the outer level (see
+.B \eO3
+and
+.BR \eO4 ).
+.
+.TP
+.B \eO1
+Enable output of glyphs, provided that the escape occurs at the outer
+level.
+.IP
+.B \eO0
+and
+.B \eO1
+also reset the registers
+.BR \en[opminx] ,
+.BR \en[opminy] ,
+.BR \en[opmaxx] ,
+and
+.B \en[opmaxy]
+to\~-1.
+These four registers mark the top left and bottom right hand corners of a
+box which encompasses all written glyphs.
+.
+.TP
+.B \eO2
+Provided that the escape occurs at the outer level, enable output of glyphs
+and also write out to stderr the page number and four registers encompassing
+the glyphs previously written since the last call to
+.BR \eO .
+.
+.TP
+.B \eO3
+Begin a nesting level.
+This is really an internal mechanism for
+.B grohtml
+while producing images.
+They are generated by running the troff source through troff to the
+postscript device and ghostscript to produce images in PNG format.
+The
+.B \eO3
+escape will start a new page if the device is not html (to reduce the
+possibility of images crossing a page boundary).
+.
+.TP
+.B \eO4
+End a nesting level.
+.TP
+.BI \eO5[ Pfilename ]
+This escape is
+.B grohtml
+specific.
+Provided that this escape occurs at the outer nesting level, write
+.I filename
+to stderr.
+The position of the image,
+.IR P ,
+must be specified and must be one of l, r, c or i (left, right, centered,
+inline).
+.I filename
+will be associated with the production of the next inline image.
+.
+.TP
 .BI \eR' name\ \(+-n '
 This has the same effect as
 .