1 .TH GROFFER @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@"
3 groffer \- display groff files and man\~pages on X and tty
6 .\" The .SH was moved to this place in order to appease `apropos'.
8 .\" --------------------------------------------------------------------
10 .\" --------------------------------------------------------------------
13 groffer.1 - man page for groffer (section 1).
15 Source file position: <groff_source_top>/contrib/groffer/groffer.man
16 Installed position: $prefix/share/man/man1/groffer.1
18 Version : groffer 0.9.2
19 Last update : 17 Jul 2003
21 This file is part of groff, the GNU roff type-setting system.
23 Copyright (C) 2001, 2002, 2003 Free Software Foundation, Inc.
24 Written by Bernd Warken <bwarken@mayn.de>
26 Permission is granted to copy, distribute and/or modify this document
27 under the terms of the GNU Free Documentation License, Version 1.1 or
28 any later version published by the Free Software Foundation; with the
29 Invariant Sections being this .ig-section and AUTHORS, with no
30 Front-Cover Texts, and with no Back-Cover Texts.
32 A copy of the Free Documentation License is included as a file called
33 FDL in the main directory of the groff source package.
36 .\" --------------------------------------------------------------------
38 .\" --------------------------------------------------------------------
40 .do nr groffer_C \n[.C]
59 .ds @b- "\f[CB]-\f[]\""
60 .ds @b-- "\f[CB]--\f[]\""
62 .ds @i- "\f[CI]-\f[]\""
63 .ds @i-- "\f[CI]--\f[]\""
65 .ds Ellipsis ".\|.\|.\""
67 .\" --------------------------------------------------------------------
68 .\" setup for the macro definitions below
70 .\" naming: namespace:cathegory_macro.variable_name (experimental)
72 .\" --------------------------------------------------------------------
73 .\" configuration of prompt for `.Shell_cmd'* macros
74 .ds groffer:Shell_cmd.prompt_text sh#\" prompt for shell commands
75 .ds groffer:Shell_cmd+.prompt_text >\" prompt on continuation lines
76 .ds groffer:Shell_cmd_base.prompt_font I\" font for prompts
78 .\" automatically determine setup from the configuration above
79 .als @f groffer:Shell_cmd_base.prompt_font\"
80 .als @t groffer:Shell_cmd.prompt_text\"
81 .als @t+ groffer:Shell_cmd+.prompt_text\"
82 .ds groffer:Shell_cmd.prompt \f[\*[@f]]\*[@t]\f[]\" needed
83 .ds groffer:Shell_cmd+.prompt \f[\*[@f]]\*[@t+]\f[]\" needed
84 .nr @w \w'\*[groffer:Shell_cmd.prompt]'\"
85 .nr @w+ \w'\*[groffer:Shell_cmd+.prompt]'\"
87 .\" Full prompt width is maximum of texts plus 1m
88 .nr groffer:Shell_cmd_base.prompt_width (\n[@w]>?\n[@w+]+1m)\" needed
97 .\" --------------------------------------------------------------------
98 .\" static register for inter-macro communication in `.Synopsis'*
99 .nr groffer:Synopsis.level 0
101 .\" --------------------------------------------------------------------
102 .\" static registers for inter-macro communication in `.TP'*
103 .nr groffer:TP.level 0
104 .rr groffer:TP_header.flag
105 .rr groffer:TP_body.flag
106 .rr groffer:TP.indent
109 .\" --------------------------------------------------------------------
110 .\" Macro definitions
112 .\" Ignore all arguments like a comment, even after a .eo call.
115 .c --------------------------------------------------------------------
118 .c Print in constant-width bold font.
125 .c --------------------------------------------------------------------
128 .c Print in constant-width italic font.
135 .c --------------------------------------------------------------------
138 .c Print in constant-width roman font.
145 .c --------------------------------------------------------------------
146 .c .Error (<text>...)
148 .c Print error message to terminal and abort.
154 .c --------------------------------------------------------------------
155 .c .Env_var (<env_var_name> [<punct>])
157 .c Display an environment variable, with optional punctuation.
162 . Text \f[CB]\\$1\f[]\\$2
165 .c --------------------------------------------------------------------
166 .c .File_name (<path_name>)
168 .c Display a file or directory name in CB font.
173 .c --------------------------------------------------------------------
174 .c .Header_CB (<path_name>)
176 .c Display a line in CB font, for example after .TP
180 . Text \f[CB]\\$1\f[]\\$2
183 .c --------------------------------------------------------------------
184 .c .Opt_- ([<punct>])
186 .c Print `-' (minus sign); optional punctuation.
189 . ie (\\n[.$] == 0) \
192 . Opt_alt - "" "\\$1"
194 .c --------------------------------------------------------------------
195 .c .Opt_[-] ([<punct>])
197 .c Print `Opt_[-]' (minus sign in brackets); optional punctuation.
200 . ie (\\n[.$] == 0) \
203 . Opt_[alt] - "" "\\$1"
205 .c --------------------------------------------------------------------
206 .c .Opt_-- ([<punct>])
208 .c Print `--' (double minus); optional punctuation.
211 . ie (\\n[.$] == 0) \
214 . Opt_alt -- "" "\\$1"
216 .c --------------------------------------------------------------------
217 .c .Opt_[--] ([<punct>])
219 .c Print `Opt_[--]' (double minus in brackets); optional punctuation.
222 . ie (\\n[.$] == 0) \
225 . Opt_[alt] -- "" "\\$1"
227 .c --------------------------------------------------------------------
228 .c .Opt_alt ([<minus> <opt>]... [<arg> [<punct>]])
230 .c Alternate options separated by a vertical bar.
233 .c minus: either `-' or `--' (font CB).
234 .c opt: a name for an option, empty allowed (font CB).
235 .c arg: optionally, the argument to the option (font I).
236 .c punct: optional punctuation (in the starting font).
238 .c The minus/opt argument pairs, each
239 .c separated by a vertical bar `|', optionally add 'arg', separated
240 .c a space character ` '.
243 .c .Opt_alt - T -- device -- device-troff device .
245 .c -T|--device|--device-troff device.
248 . Opt_alt_base "" | "" \\$@
250 .c --------------------------------------------------------------------
251 .c .Opt_[alt] ([<minus> <opt>]... [<arg> [<punct>]])
253 .c Alternate options in brackets for section SYNOPSIS.
256 .c minus: either `-' or `--' (font CB).
257 .c opt: a name for an option, empty allowed (font CB).
258 .c arg: optionally, the argument to the option (font I).
259 .c punct: optional punctuation (in the starting font).
260 .c Global strings written to:
261 .c `@oa_prefix': left enclosing character (`[')
262 .c `@oa_sep': separator (`|')
263 .c `@oa_postfix': right enclosing character (`]')
265 .c The minus/opt argument pairs, each separated by a vertical
266 .c bar `|', optionally add 'arg', separated by a space character ` '.
269 .c .Opt_[alt] - T -- device -- device-troff device .
271 .c [-T|--device|--device-troff device].
274 . Opt_alt_base [ | ] \\$@
276 .c --------------------------------------------------------------------
277 .c .Opt_alt_base (<pre> <sep> <post> [<minus> <opt>]... [arg [punct]])
279 .c Alternating options; base macro for many others; do not use directly.
282 .c <pre>: prefix, resulted is preceded by this.
283 .c <sep>: separator between minux/opt pairs.
284 .c <post>: postfix, is appended to the result.
285 .c <minus>: either `-' or `--' (font CB).
286 .c <opt>: a name for an option, empty allowed (font CB).
287 .c <arg>: optionally, the argument to the option (font I).
288 .c <punct>: optional punctuation (in the starting font).
290 .c String `<pre>' followed by the <minus>/<opt> argument pairs, each
291 .c separated by string `<sep>', optionally add '<arg>', separated by
292 .c a single space ` ', followed by the string `<post>'.
297 . Error .\\0: not enough arguments.
298 . ds @pre \)\\$1\)\" prefix
299 . ds @sep \)\\$2\)\" separator
300 . ds @post \)\\$3\)\" postfix
303 . ds @res \f[CR]\\*[@pre]\"
304 . while (\\n[.$] >= 2) \{\
305 . c do the pairs, break on no `-'
311 . if (\\n[@count] > 0) \
312 . as @res \f[CR]\\*[@sep]\"
314 . as @res \f[CB]\\$1\\$2\:\" combine minus with option name
317 . if (\\n[.$] >= 3) \
318 . Error .\\0: wrong arguments: \\$@
319 . c all pairs are done
320 . ie (\\n[.$] == 0) \
321 . as @res \f[CR]\\*[@post]\"
323 . c optional option argument
325 . as @res \f[CR] \,\f[I]\\$1\"
327 . as @res \\f[CR]\\*[@post]\" postfix
328 . if (\\n[.$] >= 1) \{\
330 . as @res \f[\\n[@font]]\\$1\"
344 .c --------------------------------------------------------------------
345 .c .Opt_def ([<minus> <opt>]... [<arg> [<punct>]])
347 .c Definitions of options in section OPTIONS.
350 .c minus: either `-' or `--' (font CB).
351 .c opt: a name for an option, empty allowed (font CB).
352 .c arg: optionally, the argument to the option (font I).
353 .c punct: optional punctuation (in the starting font).
355 .c The header for an indented paragraph, consisting of
356 .c minus/opt argument pairs, each, separated by a space
357 .c character ` ', optionally add 'arg', separated a space
361 .c .Opt_def - T -- device -- device-troff device .
363 .c -T --device --device-troff device.
364 .c as the header of for indented paragraph.
368 . Opt_alt_base "" "\~|\~" "" \\$@
370 .c --------------------------------------------------------------------
371 .c .Opt_element ([<minus> <opt>]... [<arg> [<punct>]])
373 .c Definitions of options in section OPTIONS.
376 .c minus: either `-' or `--' (font CB).
377 .c opt: a name for an option, empty allowed (font CB).
378 .c arg: optionally, the argument to the option (font I).
379 .c punct: optional punctuation (in the starting font).
381 .c The minus/opt argument pairs, each, separated by a space
382 .c character ` ', optionally add 'arg', separated a space
386 .c .Opt_element - T -- device -- device-troff device .
388 .c -T --device --device-troff device.
391 . Opt_alt_base "" "\~" "" \\$@
393 .c --------------------------------------------------------------------
394 .als Opt_list Opt_element
396 .c --------------------------------------------------------------------
397 .c .Opt_long ([<name> [<punct>]])
399 .c Print `--name' somewhere in the text; optional punctuation.
402 . Opt_alt -- "\\$1" "" "\\$2"
404 .c --------------------------------------------------------------------
405 .c .Opt_[long] ([<name> [<punct>]])
407 .c Print `--name' somewhere in the text; optional punctuation.
410 . Opt_[alt] -- "\\$1" "" "\\$2"
412 .c --------------------------------------------------------------------
413 .c .Opt_short ([<name> [<punct>]])
415 .c Print `-name' somewhere in the Text; optional punctuation.
418 . Opt_alt - "\\$1" "" "\\$2"
420 .c --------------------------------------------------------------------
421 .c .Opt_[short] ([name [punct]])
423 .c Print `[-name]' somewhere in the Text; optional punctuation.
426 . Opt_[alt] - "\\$1" "" "\\$2"
428 .c --------------------------------------------------------------------
429 .c .Shell_cmd (<CR> [<CI>] ...)
431 .c A shell command line; display args alternating in fonts CR and CI.
434 .c .Shell_cmd "groffer --dpi 100 file"
435 .c result: `sh# groffer --dpi 100 file'
436 .c with 'sh#' in font I, the rest in CR
438 .c .Shell_cmd groffer\~--dpi\~100\~file
439 .c result: the same as above
441 .c .Shell_cmd "groffer --dpi=" value " file"
442 .c result: sh# groffer --dpi=value file
443 .c with `groffer --dpi=' and `file' in CR; `value' in CI
445 .c .Shell_cmd groffer\~--dpi= value \~file
446 .c result: the same as the previous example
449 . groffer:Shell_cmd_base "\*[groffer:Shell_cmd.prompt]" \\$@
451 .c --------------------------------------------------------------------
452 .c .Shell_cmd+ (<CR> [<CI>] ...)
454 .c A continuation line for .Shell_cmd.
457 . groffer:Shell_cmd_base "\*[groffer:Shell_cmd+.prompt]" \\$@
459 .c --------------------------------------------------------------------
460 .c .Shell_cmd_base (<prompt> [<CR> [<CI>] ...])
462 .c A shell command line; display args alternating in fonts CR and CI.
463 .c Internal, do not use directly.
465 .c Globals: read-only register @.Shell_cmd_width
467 .de groffer:Shell_cmd_base
468 . if (\\n[.$] <= 0) \
470 . nr @+font \\n[.f]\"
473 . c gap between prompt and command
474 . nr @+gap \\n[groffer:Shell_cmd_base.prompt_width]-\\w'\\*[@prompt]'\"
475 . ds @res \\*[@prompt]\h'\\n[@+gap]u'\"
478 . while (\\n[.$] > 0) \{\
479 . as @res \\f[\\*[@cf]]\\$1\"
501 .c --------------------------------------------------------------------
504 .c Begin a synopsis section, to be ended by a ./Synopsis macro.
507 . if (\\n[groffer:Synopsis.level] > 0) \
508 . Error .\\$0: previous .Synopsis was not closed by ./Synopsis.
511 . nr @old_indent \\n(.i
513 . in +\w'\fB\\*[@1]\0'u
514 . ti \\n[@old_indent]u
518 . nr groffer:Synopsis.level +1\" marker for ./Synopsis
520 .c --------------------------------------------------------------------
523 .c Close a synopsis section opened by the previous .Synopsis macro.
526 . if (\\n[groffer:Synopsis.level] <= 0) \
527 . Error .\\$0: no previous call of .Synopsis
532 . nr groffer:Synopsis.level -1
534 .c --------------------------------------------------------------------
537 .c Treat the arguments as text, no matter how they look.
540 . if (\\n[.$] == 0) \
544 .c --------------------------------------------------------------------
545 .c .Topic ([<indent>])
547 .c A bulleted paragraph
558 .c --------------------------------------------------------------------
561 .c Continuation line for .TP header.
568 .c --------------------------------------------------------------------
569 .c .TP_header ([<indent>])
571 .c Start a multi-line header for a .TP-like paragraph
574 . if (\\n[groffer:TP.level] < 0) \
575 . Error .\\$0: wrong level.
576 . nr groffer:TP.level +1
578 . ie (\\n[.$] == 0) \
579 . rr groffer:TP.indent
581 . nr groffer:TP.indent \\$1
582 . nr groffer:TP_header.flag 1
584 .c --------------------------------------------------------------------
585 .c .TP_body ([<indent>])
587 .c End a previous .TP-header and beging the body of the paragraph.
590 . if !rgroffer:TP_header.flag \
591 . Error .\\$0: no previous call of .TP_header
592 . if (\\n[groffer:TP.level] <= 0) \
593 . Error .\\$0: wrong level.
595 . ie (\\n[.$] == 0) \{\
596 . ie rgroffer:TP.indent \{\
597 . RS \\n[groffer:TP.indent]u
604 . rr groffer:TP.indent
605 . rr groffer:TP_header.flag
606 . nr groffer:TP_body.flag 1
608 .c --------------------------------------------------------------------
611 .c End of former .TP_body paragraph.
614 . if !rgroffer:TP_body.flag \
615 . Error .\\$0: no previous .TP_body.
616 . if (\\n[groffer:TP.level] <= 0) \
617 . Error TP_end: wrong level.
618 . nr groffer:TP.level -1
619 . rr grogger:TP.indent
620 . rr groffer:TP_header.flag
621 . rr groffer:TP_body.flag
626 .\" End of macro definitions
629 .\" --------------------------------------------------------------------
631 .\" --------------------------------------------------------------------
635 .RI [ groffer_options ]
636 .RI [ groff_options ]
638 .RI [ "filespec" "\*[Ellipsis]]"
646 .Opt_alt - v -- version
650 .\" --------------------------------------------------------------------
652 .\" --------------------------------------------------------------------
656 program is the easiest way to use
657 .BR groff (@MAN1EXT@).
658 It can display arbitrary documents written in the
659 .BR groff (@MAN7EXT@)
662 languages that are compatible to the original troff language.
666 program also includes many of the features for finding and displaying
667 the UNIX manual pages
669 such that it can be used as a replacement for a
673 Moreover, compressed files that can be handled by
677 are decompressed on-the-fly.
681 The normal usage is quite simple by supplying a file name or name of a
682 man\~page without further options.
684 But the option handling has many possibilities for creating special
687 These can be stored in a configuration file.
691 The output can be generated and viewed in several different ways
695 This includes the groff native X viewer
696 .BR gxditview (@MAN1EXT@),
697 each Postcript or dvi display program, a web browser by generating
698 html in www-mode, or several text modes in text terminals.
702 Most options that must be named when running
704 are determined automatically because
710 But all parts can be controlled manually by supplying options.
713 .\" --------------------------------------------------------------------
714 .SH "OPTION OVERVIEW"
715 .\" --------------------------------------------------------------------
719 The following options determine and configure the display mode.
721 They were synchronized with the options of both
722 .BR groff (@MAN1EXT@)
726 If none of these options is used groffer tries to find a suitable
727 display mode automatically.
733 .Opt_[alt] - Q -- source
734 .Opt_[alt] - T -- device device
735 .Opt_[alt] -- auto-modes mode1,mode2,\*[Ellipsis]
737 .Opt_[alt] -- default
739 .Opt_[alt] -- dvi-viewer prog
741 .Opt_[alt] -- location
742 .Opt_[alt] -- mode display_mode
743 .Opt_[alt] -- pager program
745 .Opt_[alt] -- pdf-viewer prog
747 .Opt_[alt] -- ps-viewer prog
751 .Opt_[alt] -- www-viewer prog
753 .Opt_[alt] -- x-viewer prog
757 The following long options were adapted from the corresponding X
760 Their single leading minus in X Toolkit was changed to a double minus
761 for long options; see
767 .Opt_[alt] -- bg -- background
769 .Opt_[alt] -- display
770 .Opt_[alt] -- fg -- foreground
771 .Opt_[alt] -- ft -- font
772 .Opt_[alt] -- geometry size_pos
773 .Opt_[alt] -- resolution value
775 .Opt_[alt] -- title string
776 .Opt_[alt] -- xrm X_resource
780 The following long options regulate whether and how
782 (UNIX manual pages) are searched.
784 They were constructed for
786 but they are compatible with the long options of the
794 .Opt_[alt] -- apropos
795 .Opt_[alt] -- ditroff
796 .Opt_[alt] -- extension suffix
797 .Opt_[alt] -- locale language
798 .Opt_[alt] -- local-file
800 .Opt_[alt] -- manpath dir1:dir2:\*[Ellipsis]
801 .Opt_[alt] -- no-location
803 .Opt_[alt] -- sections sec1:sec2:\*[Ellipsis]
804 .Opt_[alt] -- systems sys1,sys2,\*[Ellipsis]
805 .Opt_[alt] -- troff-device device
812 long options that are not mentioned are recognized, but they are just
813 ignored because of alternative implementations.
815 The full set of long and short options of the GNU man program can be
816 passed via the environment variable
820 if your system has GNU man installed.
827 Any combination of (short) options from the
828 .BR groff (@MAN1EXT@)
829 program is accepted; the options that are not explicitly handled by
830 groffer are transparently passed to groff.
832 Due to the automatism in groffer, none of these groff options should
833 be necessary, except for advanced usage.
839 Because of the special outputting behavior of the groff options
844 groffer was designed to be switched into
846 mode by each of these options; in this mode, the groffer viewing
847 features are disabled.
850 The other groff options do not switch the mode, but allow to customize
851 the formatting process.
853 Useful groff formatting options include
855 (to add macro files that cannot be recognized by grog), and
857 (to specify an alternative device for the modes
867 is one or more file names or templates for searching
872 can have one of the following forms.
880 parameters means standard input.
885 stands for standard input (can occur several times).
890 the path name of an existing file.
897 is not an existing file search for the man\~page called in the lowest
898 man\~section that has a document for this name.
903 search for a man\~page in the lowest man\~section that has a document
909 .BI man: name . section
911 .BI man: name ( section )
916 each of these search the man\~page
923 .I "std_section name"
924 two arguments like in the
926 program to find man\~page
935 is a standard section name for man\~pages; these are a digit `1',
936 \&\*[Ellipsis], `9', or the single letters `o' or `n'.
938 This should be used only with care.
943 .\" --------------------------------------------------------------------
944 .SH "GROFFER OPTIONS"
945 .\" --------------------------------------------------------------------
949 are compatible with the short options of
950 .BR groff (@MAN1EXT@).
954 options were given a special meaning within
959 options are supported by
961 but they are just transparently transferred to
963 without any intervention.
965 Therefore these transparent options are not documented here, but in
966 .BR groff (@MAN1EXT@).
972 are compatible with the long options of
977 long options were implemented as native options into
980 These options are documented in the following; the other
982 options are recognized, but ignored.
986 Print usage message to standard error and exit.
990 Output the roff source code of the input files unprocessed.
992 This is the equivalent
993 .Opt_long mode\~source .
1001 The input is formatted and postprocessed using plain
1005 as the output device.
1007 The allowed device names are listed in
1008 .BR groff (@MAN1EXT@).
1010 Note that this forces all device names that begin with the letter
1012 to be displayed with
1013 .BR gxditview (@MAN1EXT@);
1014 all other device names generate output for the specified device; this
1015 is printed onto standard output without a pager.
1019 Print version information onto standard error.
1025 mode and format the input with groff option
1027 this produces the groff calling pipe without formatting the input.
1029 This an advanced option from
1030 .BR groff (@MAN1EXT@) ,
1031 only useful for debugging.
1037 mode and format the input with groff option
1039 actually, this formats the input and displays it with
1040 .BR gxditview (@MAN1EXT@) .
1042 This differs from groffer's mode
1044 because groffer's viewer options are not used, but the viewer is
1045 configured like in groff with the groff option
1047 This option is inhereted from
1048 .BR groff (@MAN1EXT@) .
1054 mode and format the input with groff option
1056 this produces the groff intermediate output without postprocessing; see
1057 .BR groff_out (@MAN1EXT@) .
1058 This an advanced option from
1059 .BR groff (@MAN1EXT@) ,
1060 useful for debugging.
1064 In searching man pages, retrieve all suitable ones instead of only one.
1068 Instead of displaying, start the `apropos' command for searching
1069 within man page descriptions; only kept for compatibility with `man'.
1072 .Opt_def -- auto-modes mode1,mode2,\*[Ellipsis]
1073 Set the sequence of modes for default mode to the comma separated list
1074 given in the argument.
1077 .Opt_def -- background color
1078 This is equivalent to
1082 .Opt_def -- bd pixels
1083 Specifies the color of the border surrounding the viewer
1086 This is an adaption of the X Toolkit option
1089 The argument is an X color name, see
1094 .Opt_def -- bg color
1095 Set the background color of the viewer window.
1097 This is an adaption of the X Toolkit option
1100 The argument is an X color name, see
1105 .Opt_def -- bw pixels
1106 Specifies the width in pixels of the border surrounding the viewer
1107 window (not available for all viewers).
1109 This is an adaption of the X Toolkit option
1114 Print debugging information.
1116 Actually, a function call stack is printed if an error occurs.
1120 Reset all configuration from previously processed command line options
1121 to the default values.
1123 This is useful to wipe out all effects of former options and restart
1124 option processing using only the rest of the command line.
1132 .Opt_def -- display X-display
1133 Set the X display on which the viewer program shall be started, see
1135 for the syntax of the argument.
1141 This is kept for compatibiliy with GNU
1146 Choose dvi mode; the formatted input is displayed with the
1147 by default, the formatted input is displayed with the
1152 .Opt_def -- dvi-viewer prog
1153 Set the viewer program for dvi mode.
1155 This can be a file name or a program to be searched in
1158 Known dvi viewers inlude
1163 In each case, arguments can be provided additionally.
1166 .Opt_def -- extension suffix
1167 Restrict man\~page search to file names that have
1169 appended to their section element.
1171 For example, in the file name
1172 .I /usr/share/man/man3/terminfo.3ncurses.gz
1173 the man\~page extension is
1180 .Opt_def -- foreground color
1181 This is equivalent to
1185 .Opt_def -- fg color
1186 Set the foreground color of the viewer window.
1188 This is an adaption of the X Toolkit option
1191 The argument is an X color name, see
1196 .Opt_def -- font font_name
1197 This is equivalent to
1201 .Opt_def -- ft font_name
1202 Set the font used by the viewer window.
1204 This is an adaption of the X Toolkit option
1207 The argument is an X font name, see
1212 .Opt_def -- geometry size_pos
1213 Set the geometry of the display window, that means its size and its
1218 for details on the syntax of the argument.
1220 If the actual display mode is not X then this option is ignored.
1228 Switch groffer to process the input like
1229 .BR groff (@MAN1EXT@).
1231 This disables the groffer viewing features, all groffer viewing
1232 options are ignored.
1240 .Opt_def -- location
1241 Print the location of the retrieved files to standard error.
1244 .Opt_def -- locale language
1246 Set the language for man pages.
1248 This option originates from GNU
1253 Check the non-option command line arguments (filespecs) first on being
1254 man\~pages, then whether they represent an existing file.
1256 By default, a filespec is first tested if it is an existing file.
1259 .Opt_def -- manpath "'dir1:dir2:\*[Ellipsis]'"
1260 Use the specified search path for retrieving man\~pages instead of the
1263 If the argument is set to the empty string "" the search for man\~page
1267 .Opt_def -- mode value
1269 Set the display mode.
1271 The following mode values are recognized:
1279 Display in the default manner; this actually means to try the modes
1286 Useful for restoring default mode when a different mode was specified
1288 .Env_var $GROFFER_OPT .
1293 Display formatted input in a dvi viewer program; equivalent to
1299 Display formatted input in a PDF (Portable Document Format) viewer
1300 program; equivalent to
1306 Display formatted input in a Postscript viewer program; equivalent to
1312 Display formatted input in a text terminal; equivalent to
1318 Display formatted input in a internet browser program; equivalent to
1324 Display formatted input in a native roff viewer such as
1325 .BR gxditview (@MAN1EXT@);
1331 The following modes do not use the
1335 They are only interesting for advanced applications.
1340 Generate device output with plain
1342 without using the special viewing features of
1344 If no device was specified by option
1355 Display source code; same as
1362 .Opt_def -- no-location
1363 Do not display the location of retireved files; this resets a former
1365 .Opt_long location .
1369 Do not check for man\~pages.
1373 Set the pager program in tty mode; default is
1378 Choose pdf mode (Portable Document Format).
1380 By default, the input is formatted by groff using the Postscript
1381 device, then it is transformed into the PDF file format using
1383 (this is quite slow), and finally displayed either with the
1387 program; this can be configured with option
1388 .Opt_long viewer-pdf .
1390 PDF has a big advantage because the text is displayed graphically and
1391 is searchable nevertheless; but as thtransformation into pdf takes a
1392 considerable amount of time, the pdf mode is not suitable as a default
1393 device for the auto mode.
1395 The only device that is compatible to this mode is
1397 which is also the default when no device is specified.
1400 .Opt_def -- pdf-viewer prog
1401 Set the viewer program for
1405 This can be a file name or a program to be searched in
1408 In each case, arguments can be provided additionally.
1412 Choose ps mode (Postscript).
1414 By default, the formatted input is displayed with the
1415 .BR ghostview (@MAN1EXT@)
1416 program; this can be configured with option
1417 .Opt_long viewer-ps .
1419 The only device that is compatible to this mode is
1421 which is also the default when no device is specified.
1424 .Opt_def -- ps-viewer prog
1425 Set the viewer program for
1429 This can be a file name or a program to be searched in
1432 Common Postscript viewers inlude
1438 In each case, arguments can be provided additionally.
1441 .Opt_def -- resolution value
1442 Set X resolution in dpi (dots per inch) in some viewer programs.
1444 The only supported dpi values are
1448 This is an adaption of the X Toolkit option
1449 .Opt_short resolution .
1453 Reverse foreground and background color of the viewer window.
1455 This is an adaption of the X Toolkit option
1457 This feature is not available in all viewer programs.
1460 .Opt_def -- sections
1461 Restrict searching for man pages to the given
1463 a colon-separated list.
1466 .Opt_def -- shell "shell_program"
1467 Specify the shell under which the groffer script should be run.
1469 The script first tests whether this option is set (either within
1471 or as a command line option); if so, the script is rerun under the
1472 shell program specified with the option argument.
1481 Search for man pages for the given operating systems; the argument
1483 is a comma-separated list.
1486 .Opt_def -- title "'some text'"
1487 Set the title for the viewer window.
1489 This feature is not available in all viewer programs.
1492 .Opt_def -- to-postproc opt_or_arg
1497 .Opt_def -- troff-device
1500 This option is only kept for compatibility with GNU
1505 Choose tty display mode, that means displaying in a text pager even
1506 when in X; eqivalent to
1507 .Opt_long mode\~tty .
1516 Instead of displaying the content, get the one-liner description from
1517 the retrieved man page files \[em] or say that it is not a man page.
1522 .Opt_long location .
1526 Choose www mode (html), display in a web browser program, which can be
1527 specified with option
1528 .Opt_long www-viewer .
1529 By default, the existence of a sequence of standard web browsers is
1530 tested, starting with
1536 .Opt_def -- www-viewer prog
1537 Set the web browser program for viewing in
1541 Each program that accepts html input and allows the
1542 .BI file://localhost/ dir / file
1543 syntax on the command line is suitable; it can be the path name of an
1544 executable file or a program in
1547 In each case, arguments can be provided additionally.
1553 mode (view in X roff viewer).
1555 By default, the formatted input is displayed with the
1556 .BR gxditview (@MAN1EXT@)
1557 program, being distributed together with groff, or with
1559 which is distributed as a standard X tool.
1561 This can be configured with option
1562 .Opt_long x-viewer .
1564 The only devices (option
1566 that are compatible with this mode are
1573 (the default device).
1576 .Opt_def -- x-viewer prog
1577 Set the viewer program for
1581 Suitable viewer programs are
1582 .BR gxditview (@MAN1EXT@)
1586 But the argument can be any executable file or a program in
1589 In each case, arguments can be provided additionally.
1594 Signals the end of option processing; all remaining arguments are
1601 Besides these, groffer accepts all arguments that are valid for the
1602 .BR groff (@MAN1EXT@)
1605 All non-groffer options are sent unmodified via grog to groff.
1607 Postprocessors, macro packages, compatibility with classical troff,
1608 and much more can be manually specified.
1611 .\" --------------------------------------------------------------------
1613 .\" --------------------------------------------------------------------
1615 By default, the groffer program formats the input and then
1616 automatically chooses a suitable display mode, but the user can also
1617 choose between the following modes:
1620 graphically display the formatted input with an X window program,
1625 with X window roff viewers such as
1626 .BR gxditview (@MAN1EXT@)
1631 in a dvi viewer program
1636 in a Postscript viewer
1652 display formatted input in a pager on the text terminal
1657 run groffer like groff, but with decompression and man\~page searching
1659 mode); this includes things like generating the groff intermediate
1663 stream the unformatted source code of the input onto standard output
1674 mode is possible, then
1680 This mode testing sequence for
1682 mode can be changed by specifying a comma separated list of modes
1684 .Opt_long default\-modes.
1688 The searching for man\~pages and the decompression of the input are
1689 active in every mode.
1692 .\" --------------------------------------------------------------------
1693 .SS "Graphical Display Modes"
1694 .\" --------------------------------------------------------------------
1696 The graphical display modes work only in the X window environment (or
1697 similar implementations within other windowing environments).
1699 The environment variable
1703 are used for specifying the X display to be used; if neither is
1704 specified, groffer assumes that no X is running.
1708 A certain graphical display mode can be selected by one of the options
1716 By default, some graphical modes are tried first. If none succeeds
1723 The graphical modes can be customized by options that were named
1724 according to the resource options in the
1726 Toolkit but using a leading double minus instead of the single minus
1730 .Opt_long background ,
1731 .Opt_long foreground ,
1732 .Opt_long geometry ,
1733 .Opt_long resolution ,
1742 mode has a major advantage \[em] it is the only graphical diplay mode
1743 that allows to search for text within the viewer; this can be a really
1746 Unfortunately, it takes a long time to transform the input into the
1747 PDF format, so it was not chosen as the major mode.
1749 You can change this by the options
1752 .Opt_long auto\-modes .
1755 .\" --------------------------------------------------------------------
1757 .\" --------------------------------------------------------------------
1761 is not set or empty, groffer assumes that it should produce output on
1764 This mode can also be forced by option
1769 In the actual implementation, the groff output device
1771 is chosen and the processed output is piped into a pager program.
1773 This can be changed by specifying option
1774 .Opt_long tty-device .
1778 The pager to be used can be specified by option
1780 or by the environment variable
1782 If this is not set or empty the
1784 program is used as the default pager.
1787 .\" --------------------------------------------------------------------
1788 .SS "Non-displaying Modes"
1789 .\" --------------------------------------------------------------------
1791 There are some special modes that do not display the formatted output
1792 in a viewer program.
1794 These modes are regarded as advanced, they are useful for debugging
1800 Instead of displaying the formatted output, it is also possible to
1801 have the roff source code streamed onto the standard output.
1803 This mode must be requested by one of the options
1811 This mode disables the groffer viewing facilities.
1813 The input is handled as usual with decompression and man\~page
1814 searching, but then it is passed to groff using only the options
1817 This enables the user to save the generated output into a file or pipe
1818 it into another program.
1820 In this mode, the input is formatted, but not postprocessed; see
1821 .BR groff_out (@MAN5EXT@)
1824 This mode is activated automatically by the three groff options
1826 (print roff pipe, no formatting),
1828 (display with gxditview in groff's native way, using
1830 for customization), and
1832 (disable post-processing, thus producing the groff intermediate output).
1835 .\" --------------------------------------------------------------------
1836 .SH "MAN\~PAGE\~SEARCHING"
1837 .\" --------------------------------------------------------------------
1839 The default behavior of groffer is to first test whether a file
1840 parameter represents a local file; if it is not an existing file name,
1841 it is assumed to represent a name of a man\~page.
1843 This behavior can be modified by the following options.
1848 forces to interpret all file parameters as filespecs for searching
1854 .Opt_long local\-file
1855 disable the man searching; so only local files are displayed.
1859 If neither a local file nor a man\~page was retrieved for some file
1860 parameter a warning is issued on standard error, but processing is
1865 The groffer program provides a search facility for man\~pages.
1867 All long options, all environment variables, and most of the
1868 functionality of the GNU
1870 program were implemented.
1872 This inludes the extended file names of man\~pages, for example,
1875 in man\~section 7 may be stored under
1876 .File_name /usr/share/man/man7/groff.7.gz ,
1878 .File_name /usr/share/man/
1879 is part of the man\~path, the subdirectory
1881 and the file extension
1883 refer to the man\~section 7;
1885 shows the compression of the file.
1891 (preformatted man\~pages) are intentionally excluded from the search
1892 because groffer is a roff program that wants to format by its own.
1894 With the excellent performance of the actual computers, the
1895 preformatted man\~pages aren't necessary any longer.
1899 The algorithm for retrieving man\~pages uses five search methods.
1901 They are successively tried until a method works.
1905 The search path can be manually specified by using the option
1907 An empty argument disables the man\~page searching.
1909 This overwrites the other methods.
1913 If this is not available the environment variable
1919 If this is empty, the program tries to read it from the environment
1924 If this does not work, the
1926 program for determining a path of man directories is tried.
1930 If this does not work a reasonable default path is searched for
1935 After this, the path elements for the language (locale) and operating
1936 system specific man\~pages are added to the man\~path; their sequence
1937 is determined automatically.
1940 .I /usr/share/man/linux/fr
1942 .I /usr/share/man/fr/linux
1943 for french linux man\~pages are found.
1945 The language and operating system names are determined from both
1946 environment variables and command line options.
1950 The locale (language) is determined like in GNU man, that is from
1951 highest to lowest precedence:
1956 .Env_var $GROFFER_OPT
1965 .Env_var $LC_MESSAGES
1972 The language locale is usually specified in the POSIX 1003.1 based
1975 \f[I]<language>\f[][\f[CB]_\f[]\f[I]<territory>\f[][\f[CB].\f[]\
1976 \f[I]<character-set>\f[][\f[CB],\f[]\f[I]<version>\f[]]]],
1978 but the two-letter code in
1980 is sufficient for most purposes.
1984 If no man\~pages for a complicated locale are found the country part
1985 consisting of the first two characters (without the `\f[CB]_\f[]',
1986 `\f[CB].\f[]', and `\f[CB],\f[]', parts) of the locale is searched as
1991 If still not found the corresponding man\~page in the default language
1994 As usual, this default can be specified by one of \f[CR]C\f[] or
1997 The man\~pages in the default language are usually in English.
2001 Several operating systems can be given by appending their names,
2002 separated by a comma.
2004 This is then specified by the environment variable
2006 or by the command line option
2008 The precedence is similar to the locale case above from highest to
2015 .Env_var $GROFFER_OPT
2025 When searching for man\~pages this man\~path with the additional
2026 language and system specific directories is used.
2030 The search can further be restricted by limiting it to certain
2033 A single section can be specified within each filespec argument,
2034 several sections as a colon-separated list in command line option
2036 or environment variable
2039 When no section was specified a set of standard sections is searched
2040 until a suitable man\~page was found.
2044 Finally, the search can be restricted to a so-called
2046 This is a postfix that acts like a subsection.
2048 It can be specified by
2050 or environment variable
2051 .Env_var $EXTENSION .
2055 For further details on man\~page searching, see
2059 .\" --------------------------------------------------------------------
2061 .\" --------------------------------------------------------------------
2063 The program has a decompression facility.
2065 If standard input or a file that was retrieved from the command line
2066 parameters is compressed with a format that is supported by either
2070 it is decompressed on-the-fly.
2072 This includes the GNU
2079 The program displays the concatenation of all decompressed input in
2080 the sequence that was specified on the command line.
2083 .\" --------------------------------------------------------------------
2085 .\" --------------------------------------------------------------------
2087 The groffer programs supports many system variables, most of them by
2088 courtesy of other programs.
2090 All environment variables of
2091 .BR groff (@MAN1EXT@)
2094 and some standard system variables are honored.
2097 .\" --------------------------------------------------------------------
2098 .SS "Native groffer Variables"
2099 .\" --------------------------------------------------------------------
2102 .Env_var $GROFFER_OPT
2103 Store options for a run of groffer.
2105 The options specified in this variable are overridden by the options
2106 given on the command line.
2108 The content of this variable is run through the shell builitin `eval';
2109 so arguments containing white-space or special shell characters should
2113 .\" --------------------------------------------------------------------
2114 .SS "System Variables"
2115 .\" --------------------------------------------------------------------
2117 The groffer program is a shell script that is run through
2119 which can be internally linked to programs like
2121 The corresponding system environment is automatically effective.
2123 The following variables have a special meaning for groffer.
2128 If this variable is set this indicates that the X window system is
2131 Testing this variable decides on whether graphical or text output is
2134 This variable should not be changed by the user carelessly, but it can
2135 be used to start the graphical groffer on a remote X terminal.
2137 For example, depending on your system, groffer can be started on the
2138 second monitor by the command
2139 .Shell_cmd DISPLAY=:0.1\~groffer\~ what.ever &
2145 .Env_var $LC_MESSAGES
2148 If one of these variables is set (in the above sequence), its content
2149 is interpreted as the locale, the language to be used, especially when
2150 retrieving man\~pages.
2152 A locale name is typically of the form
2162 is an ISO 639 language code,
2164 is an ISO 3166 country code, and
2166 is a character set or encoding identifier like ISO-8859-1 or UTF-8;
2170 The locale values\~\c
2174 stand for the default, i.e. the man\~page directories without a
2177 This is the same behavior as when all 3\~variables are unset.
2182 This variable can be used to set the pager for the tty output.
2184 For example, to disable the use of a pager completely set this
2188 .Shell_cmd PAGER=cat\~groffer\~ anything
2193 All programs within the groffer shell script are called without a
2196 Thus this environment variable determines the set of programs used
2197 within the run of groffer.
2201 .Env_var $POSIXLY_CORRECT
2202 If set to a non-empty value this chooses the POSIX mode for option
2203 processing, that means that option processing will be finished as soon
2204 as a non-option argument is found.
2206 Usually, you do not want to set this environment variable.
2209 .\" --------------------------------------------------------------------
2210 .SS "Groff Variables"
2211 .\" --------------------------------------------------------------------
2213 The groffer program internally calls groff, so all environment
2214 variables documented in
2215 .BR groff (@MAN1EXT@)
2216 are internally used within groffer as well.
2218 The following variables have a direct meaning for the groffer program.
2221 .Env_var $GROFF_TMPDIR
2222 If the value of this variable is an existing, writable directory,
2223 groffer uses it for storing its temporary files, just as groff does.
2226 .\" --------------------------------------------------------------------
2228 .\" --------------------------------------------------------------------
2230 Parts of the functionality of the man\~program were implemented in
2231 groffer; support for all environment variables documented in
2233 was added to groffer, but the meaning was slightly modified due to the
2234 different approach in groffer; but the user interface is the same.
2236 The man environment variables can be overwritten by options provided
2239 which in turn is overwritten by the command line.
2244 Restrict the search for man\~pages to files having this extension.
2246 This is overridden by option
2247 .Opt_long extension ;
2248 see there for details.
2253 This variable contains options as a preset for
2255 As not all of these are relevant for groffer only the essential parts
2256 of its value are extracted.
2258 The options specified in this variable overwrite the values of the
2259 other environment variables taht are specific to man.
2261 All options specified in this variable are overridden by the options
2262 given on the command line.
2267 If set, this variable contains the directories in which the man\~page
2270 This is overridden by option
2276 If this is a colon separated list of section names, the search for
2277 man\~pages is restricted to those manual sections in that order.
2279 This is overridden by option
2280 .Opt_long sections .
2285 If this is set to a comma separated list of names these are interpreted
2286 as man\~page trees for different operating systems.
2288 This variable can be overwritten by option
2290 see there for details.
2294 The environment variable
2295 .Env_var $MANROFFSEQ
2296 is ignored by groffer because the necessary preprocessors are
2297 determined automatically.
2300 .\" --------------------------------------------------------------------
2301 .SH "CONFIGURATION FILES"
2302 .\" --------------------------------------------------------------------
2304 The groffer program can be preconfigured by two configuration files.
2306 Both of them are shell scripts that are called at the beginning of
2307 groffer using the `\c
2314 .File_name /etc/groff/groffer.conf
2315 System-wide configuration file for groffer.
2319 .File_name $HOME/.groff/groffer.conf
2320 User-specific configuration file for groffer, where
2322 denotes the user's home directory.
2324 This script is called after the system-wide configuration file to
2325 enable overriding by the user.
2329 It makes sense to use these configuration files for the following
2333 Preset environment variables recognized by groffer; preferably a
2334 variable should only be set when it is unset in order not to override
2335 a user-provided value.
2338 Preset command line options by prepending them to
2339 .Env_var $GROFFER_OPT ;
2340 prepending should be preferred to appending and setting in order not
2341 to delete the environment variable provided by the
2344 Write a function for calling a viewer program for a special
2346 and feed this name into its corresponding
2347 .Opt_long \f[I]mode\f[]\-viewer
2350 Note that the name of such a function must coincide with some existing
2351 program in the system path
2353 in order to be recognized by groffer.
2357 As an example, consider the following configuration file.
2364 # ~/.groff/groffer.conf
2365 if test "$DISPLAY" = ""; then
2366 DISPLAY='localhost:0.0';
2368 GROFF_OPT="--resolution=100 $GROFF_OPT";
2371 /usr/local/bin/gxditview --fg DarkBlue "$@";
2373 GROFF_OPT="--x-viewer gxditview $GROFF_OPT";
2380 This has the following effects:
2382 allows to start groffer in a graphical mode (here on first running X
2385 even from a text terminal (empty
2386 .Env_var $DISPLAY );
2388 all graphical modes use a resolution of
2393 .BR gxditview (@MAN1EXT@)
2394 program is told to use
2396 as the text color by defining a shell function with the program's name
2400 to be used in X mode by option
2401 .Opt_long x\Âviewer .
2405 These configurations can be overridden by command line options and by
2406 environment variable
2407 .Env_var $GROFFER_OPT .
2410 .\" --------------------------------------------------------------------
2412 .\" --------------------------------------------------------------------
2414 The usage of groffer is very easy.
2416 Usually, it is just called with a file name or man\~page.
2418 The following examples, however, show that groffer has much more fancy
2423 .Shell_cmd "groffer\~/usr/local/share/doc/groff/meintro.ms.gz"
2424 Decompress, format and display the compressed file
2427 .IR /usr/local/share/doc/groff ,
2428 using a default graphical viewer when in X window, or the
2430 pager program when not in X.
2434 .Shell_cmd "groffer\~groff.7\~groff\~\[cq]troff(1)\[cq]\~man:roff"
2436 The arguments that are not existing files are looked-up as the
2437 following man\~pages:
2439 (in man\~section\~7),
2441 (automatic search, should be found in man\~section\~1),
2446 (in the section with the lowest number, being\~7 in this case).
2449 .I \[cq]troff(1)\[cq]
2450 are necessary because the paranthesis are special shell characters;
2451 escaping them with a backslash character
2455 would be possible, too.
2457 The formatted files are concatenated and displayed in one piece.
2461 .Shell_cmd "LANG=de\~groffer\~--man\~--www\~--www-viever=netscape\~ls"
2463 Retrieve the German man\~page (language
2467 program (the English version is used if there is no German version),
2468 decompress it, format it into the html format (www mode) and view the
2469 result in the default web browser
2473 guarantees that the man\~page is retrieved, even when a local file
2475 exists in the actual directory.
2479 .Shell_cmd "groffer\~-Q\~'man:roff(7)'"
2481 Get the man\~page called
2483 in man\~section 7 and print its unformatted content (source code
2490 .Shell_cmd "cat\~file.gz\~|\~groffer\~-Z\~-mfoo"
2492 Decompress the standard input, switch to
2497 .Opt_short m ) in non-postprocessing mode (groff option
2499 this produces the groff intermediate output, see
2500 .BR groff_out (@MAN7EXT@).
2504 .Shell_cmd "echo\~'\[rs]f[CB]WOW!'\~|"
2506 .Shell_cmd+ "groffer --x --bg red --fg yellow --geometry 200x100 -"
2508 Display the word \f[CB]WOW!\f[] in a small window in constant-width
2509 bold font, using color yellow on red background.
2512 .\" --------------------------------------------------------------------
2514 .\" --------------------------------------------------------------------
2518 shell script is compatible to both POSIX and GNU.
2520 POSIX compatibility refers to
2521 .B IEEE P1003.2/D11.2
2522 of September 1991, a very early version of this standard.
2524 The script uses only a quite restricted set of shell language elements
2525 and shell builtins, common to all POSIX versions; the only external
2526 program used is `sed', again only the most basic POSIX features of
2529 The groffer script should work on most actual free and commercial
2534 The groffer program provides its own parser for command line options;
2535 it can handle option arguments and file names containing white space
2536 and a large set of special characters.
2540 The groffer shell script was tested with the following common
2541 implementations of the POSIX shell:
2549 Free POSIX compatible shells and shell utilities for most operating
2550 systems are available at the
2551 .URL http://\:www.gnu.org/software/ "GNU software archive" .
2555 The best performance was obtained with the
2557 shell; so groffer tries to run under
2561 If not available the shell under which the script was started in the
2562 first place is used instead.
2564 This can be modified by the option
2569 The groffer program provides its own parser for command line arguments
2570 that is compatible to both POSIX
2575 The following usual types of options are supported.
2579 A single minus always refers to single character options, for example,
2582 .Opt_short Q\~\-m\~foo.
2586 Long options that means option with names longer than one character
2587 are always prededed by a double minus; an option argument can either
2588 go to the next command line argument or be appended with an equal sign
2589 to the argument; for example,
2590 .Opt_alt -- long=arg
2592 .Opt_alt -- long\~arg .
2598 ends option parsing; all further command line arguments are
2599 interpreted as filespec arguments.
2603 By default, all command line arguments that are neither options nor
2604 option arguments are interpreted as filespec parameters and stored
2605 until option parsing has finished.
2607 For example, the command line
2608 .Shell_cmd "groffer file1 -a -o arg file2"
2609 is, by default, equivalent to
2610 .Shell_cmd "groffer -a -o arg -- file1 file2"
2614 This behavior can be changed by setting the environment variable
2615 .Env_var $POSIXLY_CORRECT
2616 to a non-empty value; in this case, option processing is stopped as
2617 soon as the first non-option argument is found.
2619 For example, in posixly correct mode, the command line
2620 .Shell_cmd "groffer file1 -a -o arg file 2"
2622 .Shell_cmd "groffer -- file1 -a -o arg file 2"
2623 As this leads to unwanted behavior in most cases, most people do not
2625 .Env_var $POSIXLY_CORRECT .
2628 .\" --------------------------------------------------------------------
2630 .\" --------------------------------------------------------------------
2633 .BR groff (@MAN1EXT@)
2635 .BR troff (@MAN1EXT@)
2636 Details on the options and environment variables available in groff;
2637 all of them can be used with groffer.
2641 .BR grog (@MAN1EXT@)
2642 Internally, groffer tries to guess the groff command line options from
2643 the input using this program.
2647 .BR groff_out (@MAN5EXT@)
2648 Documentation on the groff intermediate output (ditroff output).
2655 Viewers for groffer's
2664 Viewers for groffer's
2688 .BR gxditview (@MAN1EXT@)
2691 Viewers for groffer's
2700 The decompression programs supported by groffer.
2705 The standard program to diplay man\~pages.
2707 The information there is only useful if it is the man\~page for
2709 Then it documents the options and environment variables that are
2710 supported by groffer.
2713 .\" --------------------------------------------------------------------
2715 .\" --------------------------------------------------------------------
2717 Copyright (C) 2001, 2002, 2003 Free Software Foundation, Inc.
2720 This document is distributed under the terms of the FDL (GNU Free
2721 Documentation License) version 1.1 or later.
2723 You should have received a copy of the FDL on your system, it is also
2724 available on-line at the
2725 .URL http://\:www.gnu.org/\:copyleft/\:fdl.html "GNU copyleft site" .
2728 This document is part of
2730 the GNU roff distribution.
2733 .MTO bwarken@mayn.de "Bernd Warken" .
2737 \" --------------------------------------------------------------------
2739 .\" --------------------------------------------------------------------
2741 .\" Local Variables: