[Groff-commit] groff ./ChangeLog src/devices/xditview/gxditvie...

[Werner LEMBERG]

CVSROOT:        /cvsroot/groff
Module name:    groff
Branch:         
Changes by:     Werner LEMBERG <address@hidden> 05/06/23 21:01:37

Modified files:
        .              : ChangeLog 
        src/devices/xditview: gxditview.man 

Log message:
        * src/devices/xditview/gxditview.man: Revised and improved.

CVSWeb URLs:
http://savannah.gnu.org/cgi-bin/viewcvs/groff/groff/ChangeLog.diff?tr1=1.837&tr2=1.838&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/groff/groff/src/devices/xditview/gxditview.man.diff?tr1=1.2&tr2=1.3&r1=text&r2=text

Patches:
Index: groff/ChangeLog
diff -u groff/ChangeLog:1.837 groff/ChangeLog:1.838
--- groff/ChangeLog:1.837       Thu Jun 23 11:33:00 2005
+++ groff/ChangeLog     Thu Jun 23 21:01:37 2005
@@ -1,3 +1,7 @@
+2005-06-23  Bernd Warken
+
+       * src/devices/xditview/gxditview.man: Revised and improved.
+
 2005-06-22  Werner LEMBERG  <address@hidden>
 
        Another round in fixing getopt problems.  Hopefully the last one!
@@ -53,7 +57,6 @@
        earlier to get correct error message.
 
 2005-06-16  Bernd Warken
-
        * src/roff/nroff/nroff.sh: Add support for iso-8859-15.
 
 2005-06-15  Werner LEMBERG  <address@hidden>
@@ -361,7 +364,7 @@
 
        Add support for double- and zero-width characters in grotty.
 
-       * src/devices/grotty/tty.cpp (glyph): Add width. 
+       * src/devices/grotty/tty.cpp (glyph): Add width.
        (tty_printer::make_underline, tty_printer::make_bold,
        tty_printer::add_character): Add parameter to pass character width.
        Update all callers.
@@ -2533,7 +2536,7 @@
        hpftodit has been extended to handle TrueType metric files and
        more glyphs.  See hpftodit.man for more details.
 
-       * src/utils/hpftodit/hpftodit.cpp: Include stdio.h, string.h, 
+       * src/utils/hpftodit/hpftodit.cpp: Include stdio.h, string.h,
        ctype.h, and unicode.h.
        s/msl/charcode/ everywhere since we now handle Unicode values also.
        (equal, NO, YES, MSL, SYMSET, UNICODE, UNICODE): New macros.
@@ -2608,7 +2611,7 @@
        * font/devutf8/R.proto: Add u00{47,67}_0306, u00{53,73}_0327,
        and u0049_0307.
 
-       * tmac/composite.tmac: Add `,' as a synonym for `ac' accent. 
+       * tmac/composite.tmac: Add `,' as a synonym for `ac' accent.
        * tmac/tty-char.tmac: Add representations for u00{47,67}_0306,
        u00{53,73}_0327, and u0049_0307.
 
@@ -5697,7 +5700,7 @@
        (fill, no_fill): Set .br html tag additionally.
        (environment::newline): Emit `eol.ce' or `eol' tag for html.
        (environment::add_html_tag_eol): Removed.
-       (tab_stops::distance_to_next_tab): Add variant for handling 
+       (tab_stops::distance_to_next_tab): Add variant for handling
        nextpos'.
        (environment::distance_to_next_tab): Ditto.
        Updated all callers.
@@ -6312,7 +6315,7 @@
        * tmac/html.tmac: Don't use black for background colour.
 
        * src/roff/troff/node.cc: Include `div.h'.
-       (troff_output_file::really_print_line): Don't use `is_on'. 
+       (troff_output_file::really_print_line): Don't use `is_on'.
        (troff_output_file::word_marker, troff_output_file::flush_tbuf
        troff_output_file::check_charinfo,
        troff_output_file::put_char_width, troff_output_file::put_char,
@@ -9478,11 +9481,11 @@
        * src/roff/troff/env.h: New boolean `emitted_node'.
        * src/roff/troff/input.cc (do_suppress): Handles extra suppress
        nodes \O3, \O4, \O5.  No longer use `output_low_mark_miny'.
-       * src/roff/troff/node.cc (check_charinfo): New method. 
+       * src/roff/troff/node.cc (check_charinfo): New method.
        (troff_output_file::determine_line_limits): Alterations to limit
        checking.
        * tmac/www.tmac: Changes to reflect new suppress nodes.
-         
+
 2001-04-12  Bruno Haible  <address@hidden>
 
        * src/devices/grohtml/post-html.cc (html_printer::add_to_sbuf):
@@ -9613,7 +9616,7 @@
        (doc-indent-synopsis-active): New register.
        (Nd, Fn, Fo): Use it.
        (Cd): It requires manipulation of \n[doc-indent-synopsis] so that
-       `.Cd' with long argument line produces indented wrapped lines. 
+       `.Cd' with long argument line produces indented wrapped lines.
        Also, the misplaced `.nop \*[doc-Nm-font]\c'' caused extra
        undesirable line break to be output.
        (doc-do-func-decl, Nm, Vt, Fn, Fo): Remove extraneous calls to
@@ -9984,7 +9987,7 @@
 
 2001-03-04  Gaius Mulley  <address@hidden>
 
-       Fixed grohtml handling of any named glyph for glyph indexes < 0x80. 
+       Fixed grohtml handling of any named glyph for glyph indexes < 0x80.
        Cosmetic changes to `.html-begin', `.html-end', `.html-image' which
        are now `.begin', `.end', `.image'.
 
@@ -10733,7 +10736,7 @@
        * tmac/*.tmac: this.
        * tmac/man.local: Fix comment.
        * tmac/groff_man.man, tmac/groff_markup.man, tmac/groff_mdoc.man,
-       tmac/groff_me.man, tmac/groff_ms.man, tmac/groff_tmac.man: Updated. 
+       tmac/groff_me.man, tmac/groff_ms.man, tmac/groff_tmac.man: Updated.
        Added some `FILES' sections.  More use of @...@ directives.  Other
        minor updates.
        * arch/djgpp/README, font/devutf8/NOTES: Updated.
@@ -11383,7 +11386,7 @@
 
 2000-05-24  Werner LEMBERG  <address@hidden>
 
-       * Makefile.in (dist): Remove src/xditview/Imakefile explicitly. 
+       * Makefile.in (dist): Remove src/xditview/Imakefile explicitly.
        This is needed e.g. if you do
        `make distclean; ./configure; make dist'.
 
@@ -11427,8 +11430,8 @@
 2000-05-21  Werner LEMBERG  <address@hidden>
 
        * tmac/tmac.an: Added a new command line option `-rSxx' (`xx' can be
-       10, 11, or 12) to support output with 11pt and 12pt base font sizes. 
-       `.SS' now produces a heading with a smaller size than `.SH'. 
+       10, 11, or 12) to support output with 11pt and 12pt base font sizes.
+       `.SS' now produces a heading with a smaller size than `.SH'.
        Completely formatted.
        * doc/groff.texinfo, tmac/groff_man.man, NEWS: Document it.
 
@@ -12767,7 +12770,7 @@
        macro `TP' specifies, the rest of the tag went into the space for
        the next line.
 
-1999-09-12  Jeffrey Copeland  <address@hidden> 
+1999-09-12  Jeffrey Copeland  <address@hidden>
 
        * grolj4/lj4.cc: Added duplex printing (option `-d').
 
@@ -12933,7 +12936,7 @@
 
 Fri Aug 15 08:51:47 1997  Eric S. Raymond  <address@hidden>
 
-       * README, PROJECTS, NEWS, INSTALL, VERSION, 
+       * README, PROJECTS, NEWS, INSTALL, VERSION,
        doc/Makefile. doc/pic.ms, groff/groff.man:
        Prepare for 1.11 release.  No code changes.
        Documentation for pic added (doc/pic.ms).
@@ -13475,7 +13478,7 @@
        * troff/input.cc (exit_troff): Likewise
 
        * Makefile.in: Remove `Making ...' messages since GNU make now
-       gives these. 
+       gives these.
 
        * configure.in: Use AC_HAVE_HEADERS(unistd.h) instead of AC_UNISTD_H.
 
@@ -14754,7 +14757,7 @@
        font::set_unknown_desc_command_handler.
        (broken.h): Don't include.
        * ps/Makefile: No need for broken.h.  Pass BROKEN_SPOOLER_FLAGS to
-       submake 
+       submake
        * ps/devps/Makefile: Add `broken' command to DESC file using
        BROKEN_SPOOLER_FLAGS.
 
@@ -14895,7 +14898,7 @@
        (main): Call process_startup_file().
        * macros/troffrc: New file.
        * macros/Makefile: Install troffrc.
-       * groff.c (main): Don't pass extra -m option to troff. For a 
+       * groff.c (main): Don't pass extra -m option to troff. For a
        pseudo device pass the name of the pseudo device to troff using
        -d.
        * groff.sh: Likewise.
@@ -15170,7 +15173,7 @@
        only if current_field.
 
        * troff/dictionary.c (dictionary::lookup): Free old_table after
-       rehashing. 
+       rehashing.
 
 Mon Jun  1 10:15:22 1992  James Clark  (address@hidden)
 
@@ -15619,7 +15622,7 @@
 
 Fri Jan  3 13:27:51 1992  James Clark  (jjc at jclark)
 
-       * tbl/table.h (format_type): 
+       * tbl/table.h (format_type):
        * refer/token.h (token_type): If NESTED_TYPES is defined, use
        typedef to make these types visible at file scope.
        * Makefile: Add NESTED_TYPES configuration option.
@@ -15738,7 +15741,7 @@
        * pic/pic.y (YYDEBUG): Don't define for Borland C++.
 
        * lib/lib.h: #ifdef out declarations of itoa and iftoa for Borland
-       C++. 
+       C++.
 
        * pic/lex.c (input_stack::bol): Move definition out of class body.
 
@@ -15854,7 +15857,7 @@
        ps_printer::do_mdef, ps_printer::do_import): Call flush_sbuf().
        (ps_printer::special): New specials invis and endinvis.
        (ps_printer::do_invis, ps_printer::do_endinvis): New functions.
-       (ps_printer::set_char, ps_printer::draw): Return if invis_count>0. 
+       (ps_printer::set_char, ps_printer::draw): Return if invis_count>0.
        (ps_printer::end_page): Check that invis_count == 0.
        (ps_printer::invis_count): New member.
        (ps_printer::ps_printer): Initialize invis_count to 0.
@@ -16432,7 +16435,7 @@
 
 Wed Mar 13 12:49:40 1991  James Clark  (jjc at jclark)
 
-       * Version 1.01 released. 
+       * Version 1.01 released.
 
        * dvi/devdvi/CompileFonts: Add cm*ss10 fonts.
 
@@ -16559,7 +16562,7 @@
 Thu Feb 21 11:49:26 1991  James Clark  (jjc at jclark)
 
        * eqn/main.c (main): New option -N which sets
-       no_newline_in_delim_flag. 
+       no_newline_in_delim_flag.
        (do_file): If no_newline_in_delim_flag is set don't allow newlines
        in delimiters.
        * groff.c (main): Pass -N on to eqn.
@@ -16868,7 +16871,7 @@
        instead of setting trap; call @init first.  Set address@hidden as top of
        page macro.
        (cov*auto-init): Deleted.  Set cov*tl-init instead of
-       cov*auto-init as top of page trap. 
+       cov*auto-init as top of page trap.
        (TL, LP): Do a break instead of calling cov*tl-init.
        (cov*print): With RP format but no TL, alias FS and FE to @FS and
        @FE; in this case also give a warning and always start another
@@ -18564,7 +18567,7 @@
 
        * troff/node.h (class transparent_dummy_node): New class.
        * troff/node.c (class transparent_dummy_node): Provide member
-       functions. 
+       functions.
        * troff/env.c (interrupt): Add a transparent_dummy_node, rather
        than a dummy_node.
 
Index: groff/src/devices/xditview/gxditview.man
diff -u groff/src/devices/xditview/gxditview.man:1.2 
groff/src/devices/xditview/gxditview.man:1.3
--- groff/src/devices/xditview/gxditview.man:1.2        Thu Jun  3 06:24:28 2004
+++ groff/src/devices/xditview/gxditview.man    Thu Jun 23 21:01:37 2005
@@ -2,11 +2,11 @@
 .
 .
 .SH NAME
-gxditview \- display gtroff output files
+gxditview \- display groff intermediate output files
 .
 .
 .SH SYNOPSIS
-.B gxditview
+.B \%gxditview
 .RI [\fB\- toolkitoption\  .\|.\|.\|]
 .RI [\fB\- option\  .\|.\|.\|]
 .RI [ filename ]
@@ -15,20 +15,83 @@
 .SH DESCRIPTION
 The
 .I \%gxditview 
-program displays gtroff output on an X display.
-It uses the standard X11 fonts,
-so it does not require access to the server machine for font loading.
+program displays the
+.I groff intermediate
+.IR output ,
+see
+.BR groff_out (@MAN5EXT@),
+on an X display.
+.
+It uses the standard X11 fonts, so it does not require access to the
+server machine for font loading.
+.
+There are several ways to use
+.IR \%gxditview .
+.
 .
 .PP
+The
+.I groff intermediate output
+can be generated by
+.B groff -Z
+which then can be viewed by explicity calling
+.I \%gxditview
+.IR \%filename .
 If
 .I filename
 is
 .BR \- ,
 .I \%gxditview
 will read the standard input.
+.I \%filename
+cannot be omitted.
+.
+.
+.PP
+A simpler method is to use an
+.BR X *
+device for the option
+.B -T
+of
+.IR groff .
+.
+Then
+.I groff
+generates the
+.I intermediate output
+and calls
+.I \%gxditview
+automatically for viewing.
+.
+There are four
+.BR X *
+devices:
+.BR -TX75 ,
+.BR -TX75-12 ,
+.BR -TX100 ,
+.BR -TX100-12 .
+They differ by the X resolution (75dpi or 100dpi) and the used base font
+size (10pt or 12pt).
+.
+.
+.PP
+.IR groff 's
+option
+.B -X
+should be considered obsolete today;
+it produces
+.I Postscript
+output and uses
+.I \%gxditview
+as a previewer for it, but with a bad quality.
+.
+Simply don't use it.
+.
 .
 .PP
-The left mouse button brings up a menu with the following entries:
+During the run of
+.IR \%gxditview ,
+the left mouse button brings up a menu with the following entries:
 .
 .TP 8
 .B "Next Page"
@@ -44,7 +107,10 @@
 .
 .TP
 .B Print
-Print the gtroff output using a command specified by a dialog box.
+Print the
+.I groff intermediate output
+using a command specified by a dialog box.
+.
 The default command initially displayed is controlled by the
 .B printCommand
 application resource, and by the
@@ -54,7 +120,10 @@
 .TP
 .B Open
 Open for display a new file specified by a dialog box.
-The file should contain gtroff output.
+.
+The file should contain
+.I groff intermediate
+.IR output .
 If the filename starts with
 .B |
 it will be taken to be a command to read from.
@@ -64,32 +133,40 @@
 Exit from
 .IR \%gxditview .
 .
+.
 .PP
 The
-.BR n ,
-Space
-and Return keys are bound to the
+.IR n ,
+.I Space
+and
+.I Return
+keys are bound to the
 .B Next\ Page
 action.
+.
 The
-.BR p ,
-BackSpace
+.IR p ,
+.I BackSpace
 and
-Delete
+.I Delete
 keys are bound to the
 .B Previous\ Page
 action.
+.
 The
-.B q
+.I q
 key is bound to the
 .B Quit
 action.
+.
 The
-.B r
+.I r
 key is bound to the
 .B Rerasterize
-action which rereads the current file, and redisplays the current page;
-if the current file is a command, the command will be reexecuted.
+action which rereads the current file, and redisplays the current
+page; if the current file is a command, the command will be
+reexecuted.
+.
 .
 .PP
 The
@@ -102,9 +179,10 @@
 .
 .
 .SH OPTIONS
-.I \%Gxditview
-accepts all of the standard X Toolkit command line options along with the 
-additional options listed below:
+The
+.I \%gxditview
+program accepts all of the standard X Toolkit command line options
+along with the additional options listed below:
 .
 .TP 8
 .B \-help
@@ -117,10 +195,11 @@
 .
 .TP
 .BI \-backingStore\  backing-store-type
-Redisplay of the gtroff output window can take upto a second or so,
-this option causes the server to save the window contents so that when
-it is scrolled around the viewport, the window is painted from
-contents saved in backing store.
+Redisplay of the
+.I groff intermediate output
+window can take upto a second or so, this option causes the server to
+save the window contents so that when it is scrolled around the
+viewport, the window is painted from contents saved in backing store.
 .I backing-store-type
 can be one of
 .BR Always ,
@@ -137,17 +216,20 @@
 .
 .TP
 .BI \-resolution\  res
-The gtroff output file will be displayed at a resolution of
+The
+.I groff intermediate output
+file will be displayed at a resolution of
 .I res
-dpi,
-unless the DESC file contains the
+dpi, unless the DESC file contains the
 .B X11
 command, in which case the device resolution will be used.
+.
 This corresponds the
 .I Dvi
 widget's
 .B resolution
 resource.
+.
 The default is 75.
 .
 .TP
@@ -159,6 +241,7 @@
 This can be either a filename, or a command starting with
 .BR | .
 .
+.
 .PP
 The following standard X Toolkit command line arguments are commonly used with 
 .IR \%gxditview :
@@ -166,11 +249,13 @@
 .TP 8
 .BI \-bg\  color
 This option specifies the color to use for the background of the window.  
+.
 The default is \fIwhite\fP.
 .
 .TP
 .BI \-bd\  color
 This option specifies the color to use for the border of the window.
+.
 The default is \fIblack\fP.
 .
 .TP
@@ -180,13 +265,16 @@
 .
 .TP
 .BI \-fg\  color
-This option specifies the color to use for displaying text.  The default is 
+This option specifies the color to use for displaying text.
+.
+The default is 
 \fIblack\fP.
 .
 .TP
 .BI \-fn\  font
-This option specifies the font to be used for displaying widget text.  The
-default is \fIfixed\fP.
+This option specifies the font to be used for displaying widget text.
+.
+The default is \fIfixed\fP.
 .
 .TP
 .B \-rv
@@ -209,8 +297,9 @@
 .SH X DEFAULTS
 This program uses the 
 .I Dvi
-widget in the X Toolkit.  It understands all of the core resource names and
-classes as well as:
+widget in the X Toolkit.
+.
+It understands all of the core resource names and classes as well as:
 .
 .TP 8
 .BR width\  (class\  Width )
@@ -230,10 +319,16 @@
 .
 .TP
 .BR fontMap\  (class\  FontMap )
-Specifies the mapping from groff font names to X font names.  This
-must be a string containing a sequence of lines.  Each line contains
-two whitespace separated fields: first the groff font name, and
-secondly the X font name.  The default is
+Specifies the mapping from
+.I groff
+font names to X font names.
+.
+This must be a string containing a sequence of lines.
+.
+Each line contains two whitespace separated fields: first the groff
+font name, and secondly the X font name.
+.
+The default is
 .nf
 "\e
 TR     -adobe-times-medium-r-normal--*-100-*-*-*-*-iso8859-1\en\e
@@ -259,17 +354,16 @@
 .
 .
 .SH "SEE ALSO"
-.IR X (1),
-.IR xrdb (1),
-.IR xditview (1),
-.IR gtroff (@MAN1EXT@),
-.IR groff (@MAN1EXT@)
+.BR X (1),
+.BR xrdb (1),
+.BR xditview (1),
+.BR groff (@MAN1EXT@),
+.BR groff_out (@MAN5EXT@)
 .
 .
 .SH ORIGIN
-This program is derived from \%xditview;
-portions of \%xditview originated in xtroff which was derived
-from suntroff.  
+This program is derived from \%xditview; portions of \%xditview
+originated in xtroff which was derived from suntroff.
 .
 .
 .SH COPYRIGHT