[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Groff-commit] groff/contrib/groffer ChangeLog groffer.man
|
From: |
Werner LEMBERG |
|
Subject: |
[Groff-commit] groff/contrib/groffer ChangeLog groffer.man |
|
Date: |
Sat, 21 May 2005 03:08:00 -0400 |
CVSROOT: /cvsroot/groff
Module name: groff
Branch:
Changes by: Werner LEMBERG <address@hidden> 05/05/21 07:08:00
Modified files:
contrib/groffer: ChangeLog groffer.man
Log message:
* release of groffer 0.9.14
* groffer.man: correction of non-hyphenation
CVSWeb URLs:
http://savannah.gnu.org/cgi-bin/viewcvs/groff/groff/contrib/groffer/ChangeLog.diff?tr1=1.24&tr2=1.25&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/groff/groff/contrib/groffer/groffer.man.diff?tr1=1.21&tr2=1.22&r1=text&r2=text
Patches:
Index: groff/contrib/groffer/ChangeLog
diff -u groff/contrib/groffer/ChangeLog:1.24
groff/contrib/groffer/ChangeLog:1.25
--- groff/contrib/groffer/ChangeLog:1.24 Fri May 20 06:12:24 2005
+++ groff/contrib/groffer/ChangeLog Sat May 21 07:08:00 2005
@@ -1,3 +1,9 @@
+2005-05-20 Bernd Warken
+ ________________________________________________________________
+ * release of groffer 0.9.14
+
+ * groffer.man: correction of non-hyphenation
+
2005-05-17 Bernd Warken
________________________________________________________________
* release of groffer 0.9.13
Index: groff/contrib/groffer/groffer.man
diff -u groff/contrib/groffer/groffer.man:1.21
groff/contrib/groffer/groffer.man:1.22
--- groff/contrib/groffer/groffer.man:1.21 Fri May 20 06:12:24 2005
+++ groff/contrib/groffer/groffer.man Sat May 21 07:08:00 2005
@@ -15,7 +15,7 @@
Source file position: <groff_source_top>/contrib/groffer/groffer.man
Installed position: $prefix/share/man/man1/groffer.1
-Last update : 20 May 2005
+Last update : 21 May 2005
Source file position: <groff-source>/contrib/groffer/groffer.man
..
@@ -60,15 +60,6 @@
. ftr CB CW
.\}
.
-.ds @- "\-\""
-.ds @-- "\-\^\-\""
-.
-.ds @b- "\f[CB]-\f[]\""
-.ds @b-- "\f[CB]--\f[]\""
-.
-.ds @i- "\f[CI]-\f[]\""
-.ds @i-- "\f[CI]--\f[]\""
-.
.ds Ellipsis ".\|.\|.\""
.
.\" --------------------------------------------------------------------
@@ -286,7 +277,7 @@
.c Alternating options; base macro for many others; do not use directly.
.c
.c Arguments:
-.c <pre>: prefix, resulted is preceded by this.
+.c <pre>: prefix, result is preceded by this.
.c <sep>: separator between minus/opt pairs.
.c <post>: postfix, is appended to the result.
.c <minus>: either `-' or `--' (font CB).
@@ -296,7 +287,8 @@
.c Result:
.c String `<pre>' followed by the <minus>/<opt> argument pairs, each
.c separated by string `<sep>', optionally add '<arg>', separated by
-.c a single space ` ', followed by the string `<post>'.
+.c a single space ` ', followed by the string `<post>'. Terminated
+.c by the optional punctuation <punct>.
.c
.de Opt_alt_base
. nr @font \\n[.f]\"
@@ -316,9 +308,13 @@
. \}
. c separator
. if (address@hidden > 0) \
-. as @res address@hidden"
+. as @res address@hidden:\"
. nr @count +1
-. as @res \f[CB]\\$1\\$2\:\" combine minus with option name
+. c combine minus with option name
+. as @res \f[CB]\\-\"
+. if '\\$1'--' \
+. as @res \\-\"
+. as @res \\$2\"
. shift 2
. \}
. if (\\n[.$] >= 3) \
@@ -555,7 +551,9 @@
.de Text
. if (\\n[.$] == 0) \
. return
+. nh
. nop \)\\$*\)
+. hy
..
.c --------------------------------------------------------------------
.c .Topic ([<indent>])
@@ -671,28 +669,32 @@
.\" --------------------------------------------------------------------
.
The
-.I groffer
+.I \%groffer
program is the easiest way to use
-.BR groff (@MAN1EXT@).
+.BR \%groff (@MAN1EXT@).
It can display arbitrary documents written in the
-.BR groff (@MAN7EXT@)
+.BR \%groff (@MAN7EXT@)
language or other
-.BR roff (@MAN7EXT@)
-languages that are compatible to the original troff language.
+.BR \%roff (@MAN7EXT@)
+languages that are compatible to the original
+.I \%troff
+language.
.
The
-.I groffer
+.I \%groffer
program also includes many of the features for finding and displaying
-the UNIX manual pages
+the \%UNIX manual pages
+.nh
.RI ( man\~pages ),
+.hy
such that it can be used as a replacement for a
-.BR man (1)
+.BR \%man (1)
program.
.
Moreover, compressed files that can be handled by
-.BR gzip (1)
+.BR \%gzip (1)
or
-.BR bzip2 (1)
+.BR \%bzip2 (1)
are decompressed on-the-fly.
.
.
@@ -705,28 +707,33 @@
.
This can be done in configuration files, with the shell environment
variable
-.BR $GROFFER_OPT ,
+.BR \%$GROFFER_OPT ,
or on the command line.
.
.
.P
The output can be generated and viewed in several different ways
available for
-.IR groff .
+.IR \%groff .
.
-This includes the groff native X viewer
+This includes the
+.I \%groff
+native X viewer
.BR \%gxditview (@MAN1EXT@),
-each Postcript or dvi display program, a web browser by generating
-html in www-mode, or several text modes in text terminals.
+each Postcript or
+.I \%dvi
+display program, a web browser by generating
+.I \%html
+in www-mode, or several text modes in text terminals.
.
.
.P
Most of the options that must be named when running
-.I groff
+.I \%groff
directly are determined automatically for
-.IR groffer ,
+.IR \%groffer ,
due to the internal usage of the
-.BR grog (@MAN1EXT@)
+.BR \%grog (@MAN1EXT@)
program.
.
But all parts can also be controlled manually by arguments.
@@ -736,7 +743,7 @@
Several file names can be specified on the command line arguments.
.
They are transformed into a single document in the normal way of
-.IR groff .
+.IR \%groff .
.
.
.\" --------------------------------------------------------------------
@@ -748,40 +755,40 @@
.RS
.P
.Opt_[alt] -- apropos name
-.Opt_[alt] -- apropos-data name
-.Opt_[alt] -- apropos-devel name
-.Opt_[alt] -- apropos-progs name
+.Opt_[alt] -- apropos\-data name
+.Opt_[alt] -- apropos\-devel name
+.Opt_[alt] -- apropos\-progs name
.Opt_[alt] - h -- help
.Opt_[alt] - v -- version
.RE
.
.
.TP
-.I groffer mode options
+.I \%groffer mode options
.RS
.P
.Opt_[alt] -- auto
.Opt_[alt] -- default
-.Opt_[alt] -- default-modes mode1,mode2,\*[Ellipsis]
+.Opt_[alt] -- default\-modes mode1,mode2,\*[Ellipsis]
.Opt_[alt] -- dvi
-.Opt_[alt] -- dvi-viewer prog
+.Opt_[alt] -- dvi\-viewer prog
.Opt_[alt] -- groff
.Opt_[alt] -- html
-.Opt_[alt] -- html-viewer prog
+.Opt_[alt] -- html\-viewer prog
.Opt_[alt] -- man
.Opt_[alt] -- mode display_mode
.Opt_[alt] -- no-man
.Opt_[alt] -- pdf
-.Opt_[alt] -- pdf-viewer prog
+.Opt_[alt] -- pdf\-viewer prog
.Opt_[alt] -- ps
-.Opt_[alt] -- ps-viewer prog
+.Opt_[alt] -- ps\-viewer prog
.Opt_[alt] -- text
.Opt_[alt] -- tty
-.Opt_[alt] -- tty-viewer prog
+.Opt_[alt] -- tty\-viewer prog
.Opt_[alt] -- www
-.Opt_[alt] -- www-viewer prog
+.Opt_[alt] -- www\-viewer prog
.Opt_[alt] -- x -- X
-.Opt_[alt] -- x-viewer -- X-viewer prog
+.Opt_[alt] -- x\-viewer -- X\-viewer prog
.RE
.
.
@@ -795,16 +802,16 @@
.
.
.TP
-.I options related to groff
+.I options related to \%groff
.RS
.P
-.Opt_[alt] - P -- postproc-arg opt_or_arg
+.Opt_[alt] - P -- postproc\-arg opt_or_arg
.Opt_[alt] - Q -- source
.Opt_[alt] - T -- device device
-.Opt_[alt] - Z -- intermediate-output -- ditroff
+.Opt_[alt] - Z -- intermediate\-output -- ditroff
.P
All further
-.I groff
+.I \%groff
short options are accepted.
.RE
.
@@ -874,8 +881,8 @@
.TP+
.IB name ( section )
search the man\~page
-.I name
-in man\~section\~\c
+.I \%name
+in man\~section
.IR section .
.
.
@@ -886,9 +893,9 @@
if
.I s
is a character in
-.BR [1-9on] ,
+.BR \%[1-9on] ,
search for a man\~page
-.I name
+.I \%name
in man\~section
.IR s .
.
@@ -896,7 +903,7 @@
.TP
.BI man: name
man\~page in the lowest man\~section that has
-.IR name .
+.IR \%name .
.
.
.TP
@@ -904,9 +911,9 @@
if
.I s
is a character in
-.BR [1-9on] ,
+.BR \%[1-9on] ,
search for a man\~page
-.I name
+.I \%name
in man\~section
.IR s .
.
@@ -914,9 +921,9 @@
.TP
.I name
if
-.I name
+.I \%name
is not an existing file search for the man\~page
-.I name
+.I \%name
in the lowest man\~section.
.
.RE
@@ -927,7 +934,7 @@
.\" --------------------------------------------------------------------
.
The
-.I groffer
+.I \%groffer
program can usually be run with very few options.
.
But for special purposes, it supports many options.
@@ -937,14 +944,14 @@
.
.P
All short options of
-.I groffer
+.I \%groffer
are compatible with the short options of
-.BR groff (@MAN1EXT@).
+.BR \%groff (@MAN1EXT@).
.
All long options of
-.I groffer
+.I \%groffer
are compatible with the long options of
-.BR man (1).
+.BR \%man (1).
.
.
.\" --------------------------------------------------------------------
@@ -953,7 +960,7 @@
.
As soon as one of these options is found on the command line it is
executed, printed to standard output, and the running
-.I groffer
+.I \%groffer
is terminated thereafter.
.
All other arguments are ignored.
@@ -961,29 +968,29 @@
.
.Opt_def -- apropos name
Start the
-.BR apropos (1)
-command for searching within man page
+.BR \%apropos (1)
+command for searching within man\~page
descriptions.
.
That slightly differs from the strange behavior of the
.Opt_long apropos
program of
-.BR man (1),
+.BR \%man (1),
which has no argument of its own, but takes the file arguments
instead.
.
Practically both concepts are compatible.
.
.
-.Opt_def -- apropos-data name
+.Opt_def -- apropos\-data name
Show only the
-.BR apropos (1)
+.BR \%apropos (1)
descriptions for data documents, in the
-.BR man (7)
+.BR \%man (7)
sections 4, 5, and 7.
.
.
-.Opt_def -- apropos-devel name
+.Opt_def -- apropos\-devel name
Show only the
.BR apropos (1)
descriptions for development documents, in the
@@ -991,11 +998,11 @@
sections 2, 3, and 9.
.
.
-.Opt_def -- apropos-progs name
+.Opt_def -- apropos\-progs name
Show only the
-.BR apropos (1)
+.BR \%apropos (1)
descriptions for documents on programs, in the
-.BR man (7)
+.BR \%man (7)
sections 1, 6, and 8.
.
.
@@ -1016,7 +1023,7 @@
options.
.
If none of these mode and viewer options is specified
-.I groffer
+.I \%groffer
tries to find a suitable display mode automatically.
.
.
@@ -1034,9 +1041,9 @@
and restart option processing using only the rest of the command line.
.
.
-.Opt_def -- default-modes mode1,mode2,\*[Ellipsis]
+.Opt_def -- default\-modes mode1,mode2,\*[Ellipsis]
Set the sequence of modes for
-.I auto mode
+.I \%auto mode
to the comma separated list given in the argument.
.
See
@@ -1046,26 +1053,28 @@
.IR x ,
.IR ps ,
and
-.I tty
+.I \%tty
in this sequence.
.
.
.
.Opt_def -- dvi
Equivalent to
-.Opt_long_arg mode dvi .
+.Opt_long_arg mode \%dvi .
.
.
-.Opt_def -- dvi-viewer prog
+.Opt_def -- dvi\-viewer prog
Set the viewer program for dvi mode.
.
This can be a file name or a program to be searched in
.Env_var $PATH .
.
-Known dvi viewers inlude
-.BR xdvi (1)
+Known
+.I \%dvi
+viewers inlude
+.BR \%xdvi (1)
and
-.BR dvilx (1)
+.BR \%dvilx (1)
.
In each case, arguments can be provided additionally.
.
@@ -1080,13 +1089,13 @@
.Opt_long_arg mode html .
.
.
-.Opt_def -- html-viewer
+.Opt_def -- html\-viewer
Set the web browser program for viewing in
-.I html
+.I \%html
mode.
.
Each program that accepts html input and allows the
-.BI file://localhost/ dir / file
+.BI \%file://localhost/ dir / file
syntax on the command line is suitable as viewer program; it can be
the path name of an executable file or a program in
.Env_var $PATH .
@@ -1107,7 +1116,7 @@
Select the automatic determination of the display mode.
.
The sequence of modes that are tried can be set with the
-.Opt_long default-modes
+.Opt_long default\-modes
option.
.
Useful for restoring the default mode when a different mode was
@@ -1117,11 +1126,11 @@
.TP
.Header_CB dvi
Display formatted input in a
-.I dvi
+.I \%dvi
viewer program.
.
By default, the formatted input is displayed with the
-.BR xdvi (1)
+.BR \%xdvi (1)
program.
.Opt_long dvi .
.
@@ -1129,13 +1138,13 @@
.TP
.Header_CB groff
After the file determination, switch
-.I groffer
+.I \%groffer
to process the input like
-.BR groff (@MAN1EXT@)
-would do .
+.BR \%groff (@MAN1EXT@)
+would do.
.
This disables the
-.I groffer
+.I \%groffer
viewing features.
.
.
@@ -1146,27 +1155,27 @@
.
By default, the existence of a sequence of standard web browsers is
tested, starting with
-.BR konqueror (1)
+.BR \%konqueror (1)
and
-.BR mozilla (1).
+.BR \%mozilla (1).
The text html viewer is
-.BR lynx (1).
+.BR \%lynx (1).
.
.
.TP
.Header_CB pdf
Display formatted input in a
-.I PDF
+.I \%PDF
(Portable Document Format) viewer
program.
.
By default, the input is formatted by groff using the Postscript
device, then it is transformed into the PDF file format using
-.BR gs (1),
+.BR \%gs (1),
and finally displayed either with the
-.BR xpdf (1)
+.BR \%xpdf (1)
or the
-.BR acroread (1)
+.BR \%acroread (1)
program.
.
PDF has a big advantage because the text is displayed graphically and
@@ -1181,19 +1190,19 @@
Display formatted input in a Postscript viewer program.
.
By default, the formatted input is displayed with the
-.BR ghostview (@MAN1EXT@)
+.BR \%ghostview (@MAN1EXT@)
program.
.
.
.TP
.Header_CB text
Format in a
-.I groff
+.I \%groff
text mode and write the result to standard output without a pager or
viewer program.
.
The text device,
-.I latin1
+.I \%latin1
by default, can be chosen with option
.Opt_short T .
.
@@ -1201,9 +1210,9 @@
.TP
.Header_CB tty
Format in a
-.I groff
+.I \%groff
text mode and write the result to standard output using a text pager
-program, even when in X Window.
+program, even when in X\~\%Window.
.
.
.TP
@@ -1231,7 +1240,7 @@
.
.P
The following modes do not use the
-.I groffer
+.I \%groffer
viewing features.
.
They are only interesting for advanced applications.
@@ -1240,15 +1249,15 @@
.TP
.Header_CB groff
Generate device output with plain
-.I groff
+.I \%groff
without using the special viewing features of
-.IR groffer .
+.IR \%groffer .
If no device was specified by option
.Opt_short T
the
-.I groff
+.I \%groff
default
-.B ps
+.B \%ps
is assumed.
.
.
@@ -1268,7 +1277,7 @@
.
.Opt_def -- pdf-viewer prog
Set the viewer program for
-.I pdf
+.I \%pdf
mode.
.
This can be a file name or a program to be searched in
@@ -1284,17 +1293,17 @@
.
.Opt_def -- ps-viewer prog
Set the viewer program for
-.I ps
+.I \%ps
mode.
.
This can be a file name or a program to be searched in
.Env_var $PATH .
.
Common Postscript viewers inlude
-.BR gv (1),
-.BR ghostview (1),
+.BR \%gv (1),
+.BR \%ghostview (1),
and
-.BR gs (1),
+.BR \%gs (1),
.
In each case, arguments can be provided additionally.
.
@@ -1309,7 +1318,7 @@
.Opt_long_arg mode tty .
.
.
-.Opt_def -- tty-viewer
+.Opt_def -- tty\-viewer
Choose tty display mode, that means displaying in a text pager even
when in X; eqivalent to
.Opt_long_arg mode tty .
@@ -1320,9 +1329,9 @@
.Opt_long_arg mode html .
.
.
-.Opt_def -- www-viewer prog
+.Opt_def -- www\-viewer prog
Equivalent to
-.Opt_long html-viewer .
+.Opt_long html\-viewer .
.
.
.Opt_def - X -- X -- x
@@ -1330,7 +1339,7 @@
.Opt_long_arg mode X .
.
.
-.Opt_def -- X-viewer -- x-viewer prog
+.Opt_def -- X\-viewer -- x\-viewer prog
Set the viewer program for
.I x
mode.
@@ -1350,24 +1359,24 @@
.Opt_--
Signals the end of option processing; all remaining arguments are
interpreted as
-.I filespec
+.I \%filespec
parameters.
.
.
.P
Besides these,
-.I groffer
+.I \%groffer
accepts all arguments that are valid for the
-.BR groff (@MAN1EXT@)
+.BR \%groff (@MAN1EXT@)
program.
.
All non-groffer options are sent unmodified via
-.I grog
+.I \%grog
to
-.IR groff .
+.IR \%groff .
.
Postprocessors, macro packages, compatibility with classical
-.IR troff ,
+.IR \%troff ,
and much more can be manually specified.
.
.
@@ -1401,7 +1410,7 @@
.
.P
Other useful debugging options are the
-.I groff
+.I \%groff
options
.Opt_short V
and
@@ -1415,33 +1424,33 @@
.\" --------------------------------------------------------------------
.
All short options of
-.I groffer
+.I \%groffer
are compatible with the short options of
-.BR groff (@MAN1EXT@).
+.BR \%groff (@MAN1EXT@).
.
The following of
-.I groff
+.I \%groff
options have either an additional special meaning within
-.I groffer
+.I \%groffer
or make sense for normal usage.
.
.
.P
Because of the special outputting behavior of the
-.I groff
+.I \%groff
options
.Opt_short V
and
.Opt_short Z
-.I groffer
+.I \%groffer
was designed to be switched into
-.I groff
+.I \%groff
mode by these; the
-.I groffer
+.I \%groffer
viewing features are disabled there.
.
The other
-.I groff
+.I \%groff
options do not switch the mode, but allow to customize the formatting
process.
.
@@ -1455,9 +1464,9 @@
.
.Opt_def - m file
Add
-.I file
+.I \%file
as a
-.I groff
+.I \%groff
macro file.
.
This is useful in case it cannot be recognized automatically.
@@ -1465,61 +1474,61 @@
.
.Opt_def - P opt_or_arg
Send the argument
-.I opt_or_arg
+.I \%opt_or_arg
as an option or option argument to the actual
-.I groff
+.I \%groff
postprocessor.
.
.
.Opt_def - T -- device devname
.
This option determines
-.IR groff 's
+.IR \%groff 's
output device.
.
The most important devices are the text output devices for referring
to the different character sets, such as
-.BR ascii ,
-.BR utf8 ,
-.BR latin1 ,
+.BR \%ascii ,
+.BR \%utf8 ,
+.BR \%latin1 ,
and others.
.
Each of these arguments switches
-.I groffer
+.I \%groffer
into a text mode using this device, to
-.I mode tty
+.I mode \%tty
if the actual mode is not a text mode.
.
The following
-.I devname
+.I \%devname
arguments are mapped to the corresponding
-.I groffer
+.I \%groffer
.Opt_long_arg mode \fIdevname\fR
option:
-.BR dvi ,
-.BR html ,
+.BR \%dvi ,
+.BR \%html ,
and
-.BR ps .
+.BR \%ps .
All
-.B X*
+.B \%X*
arguments are mapped to mode
-.BR X .
+.BR \%X .
Each other
-.I devname
+.I \%devname
argument switches to
-.I mode groff
+.I mode \%groff
using this device.
.
.
.Opt_def - V
Switch into
-.I groff
+.I \%groff
mode and show only the
-.I groff
+.I \%groff
calling pipe without formatting the input.
.
This an advanced option from
-.BR groff (@MAN1EXT@) ,
+.BR \%groff (@MAN1EXT@) ,
only useful for debugging.
.
.
@@ -1527,44 +1536,44 @@
was made equivalent to
.Opt_long_arg mode x ;
this slightly enhances the facility of
-.IR groff 's
+.IR \%groff 's
option.
.
.
.Opt_def - Z -- intermediate-output -- ditroff
Switch into
-.I groff
+.I \%groff
mode and format the input with
-.I groff
+.I \%groff
intermediate output without postprocessing; see
-.BR groff_out (@MAN1EXT@).
+.BR \%groff_out (@MAN1EXT@).
This is equivalent to option
.Opt_long ditroff
of
-.IR man ,
+.IR \%man ,
which can be used as well.
.
.
.P
All other
-.I groff
+.I \%groff
options are supported by
-.IR groffer ,
+.IR \%groffer ,
but they are just transparently transferred to
-.I groff
+.I \%groff
without any intervention.
.
The options that are not explicitly handled by
-.I groffer
+.I \%groffer
are transparently passed to
-.IR groff .
+.IR \%groff .
.
Therefore these transparent options are not documented here, but in
-.BR groff (@MAN1EXT@).
+.BR \%groff (@MAN1EXT@).
Due to the automatism in
-.IR groffer ,
+.IR \%groffer ,
none of these
-.I groff
+.I \%groff
options should be needed, except for advanced usage.
.
.
@@ -1575,7 +1584,7 @@
The following long options were adapted from the corresponding X
Toolkit options.
.
-.I groffer
+.I \%groffer
will pass them to the actual viewer program if it is an X Window
program.
.
@@ -1587,10 +1596,10 @@
long options.
.
For
-.I groffer
+.I \%groffer
that was changed to the standard with using a double minus for long
options, for example,
-.I groffer
+.I \%groffer
uses the option
.Opt_long font
for the
@@ -1601,8 +1610,8 @@
.
.P
See
-.BR X (1),
-.BR X (7),
+.BR \%X (1),
+.BR \%X (7),
and the documentation on the X toolkit options for more details on
these options and their arguments.
.
@@ -1627,7 +1636,7 @@
.
.Opt_def -- display X-display
Set the X display on which the viewer program shall be started, see the
-.I X Window
+.I X\~\%Window
documentation for the syntax of the argument.
.
.
@@ -1656,7 +1665,7 @@
starting position.
.
See
-.BR X (7)
+.BR \%X (7)
for the syntax of the argument.
.
.
@@ -1669,7 +1678,7 @@
.BR 100 .
.
Actually, the default resolution for
-.I groffer
+.I \%groffer
is set to
.BR 75 .
.
@@ -1691,20 +1700,20 @@
.\" --------------------------------------------------------------------
.
The long options of
-.I groffer
+.I \%groffer
were synchronized with the long options of
.IR GNU man .
.
All long options of
.I GNU man
are recognized, but not all of these options are important to
-.IR groffer ,
+.IR \%groffer ,
so most of them are just ignored.
.
.
.P
The following two options were added to
-.I groffer
+.I \%groffer
for choosing whether the file name arguments are interpreted as names
for local files or as a search pattern for man pages.
.
@@ -1713,12 +1722,14 @@
.
.Opt_def -- man
Check the non-option command line arguments
+.nh
.RI ( filespecs )
+.hy
first on being man\~pages, then whether they represent an existing
file.
.
By default, a
-.I filespec
+.I \%filespec
is first tested whether it is an existing file.
.
.
@@ -1735,7 +1746,7 @@
In the following, the
.I man
options that have a special meaning for
-.I groffer
+.I \%groffer
are documented.
.
.
@@ -1745,7 +1756,7 @@
program can be passed via the environment variable
.Env_var $MANOPT ;
see
-.BR man (1)
+.BR \%man (1)
if your system has
.I GNU man
installed.
@@ -1762,19 +1773,19 @@
.
.Opt_def -- ditroff
Eqivalent to
-.I groffer
+.I \%groffer
.Opt_short Z .
.
.
.Opt_def -- extension suffix
Restrict man\~page search to file names that have
-.I suffix
+.I \%suffix
appended to their section element.
.
For example, in the file name
-.I /usr/share/man/man3/terminfo.3ncurses.gz
+.I \%/usr/share/man/man3/terminfo.3ncurses.gz
the man\~page extension is
-.IR ncurses .
+.IR \%ncurses .
.
.
.Opt_def -- locale language
@@ -1795,7 +1806,7 @@
.Opt_long location .
.
This was added by
-.IR groffer .
+.IR \%groffer .
.
.
.Opt_def -- manpath "'dir1:dir2:\*[Ellipsis]'"
@@ -1808,7 +1819,7 @@
.
.Opt_def -- pager
Set the pager program in tty mode; default is
-.IR less .
+.IR \%less .
This is equivalent to
.Opt_long tty-viewer .
.
@@ -1821,7 +1832,7 @@
.
.Opt_def -- systems "'sys1,sys2,\*[Ellipsis]'"
Search for man pages for the given operating systems; the argument
-.I systems
+.I \%systems
is a comma-separated list.
.
.
@@ -1837,7 +1848,7 @@
.
.P
Additionally, the following short option of
-.I man
+.I \%man
is supported as well.
.
.
@@ -1846,43 +1857,44 @@
.\" --------------------------------------------------------------------
.
A
-.I filespec
+.I \%filespec
parameter is an argument meaning an input source, such as a file name
or template for searching man\~pages.
.
These input sources are collected and composed into a single output
file such as
-.I groff
+.I \%groff
does.
.
.
.P
The strange POSIX behavior that maps all arguments behind the first
non-option argument into
-.I filespec
+.I \%filespec
arguments is ignored.
.
The GNU behavior to recognize options even when mixed with
-.I filespec
+.I \%filespec
arguments is used througout.
.
But, as usual, the double minus argument
.Opt_long
still takes all following arguments as
-.IR filespecs .
+.I \%filespec
+arguments.
.
.
.P
Each
-.I filespec
+.I \%filespec
parameters can have one of the following forms.
.
.
.P
No
-.I filespec
+.I \%filespec
parameters means that
-.I groffer
+.I \%groffer
waits for standard input.
.
The minus option
@@ -1890,7 +1902,7 @@
stands for standard input, too, but can occur several times.
.
Next
-.I filespec
+.I \%filespec
is tested whether it is the path name of an existing file.
.
Otherwise it is assumed as a searching pattern for a man\~page.
@@ -1918,7 +1930,7 @@
.
.P
The internal precedence of
-.I man
+.I \%man
for searching man pages with the same name within several sections
goes according to the classical single-character sequence.
.
@@ -1926,22 +1938,22 @@
string.
.
But the special
-.I groffer
-man page facility is based on the classical single character sections.
+.I \%groffer
+man\~page facility is based on the classical single character sections.
.
.
.P
-.BI man: name ( section )
+.BI \%man: name ( section )
and
-.IB name ( section )
+.IB \%name ( section )
search the man\~page
-.I name
+.I \%name
in man\~section\~\c
-.IR section ,
+.IR \%section ,
where
-.I section
+.I \%section
can be any string, but it must exist in the
-.I man
+.I \%man
system.
.
.
@@ -1950,11 +1962,11 @@
.I classical man sections
were constructed.
.
-.BI man: name . s
+.BI \%man: name . s
and
-.IB name . s
+.IB \%name . s
search for a man\~page
-.I name
+.I \%name
in man\~section
.I s
if
@@ -1964,23 +1976,23 @@
mentioned above.
.
Otherwise search for a man\~page named
-.IR name.s
+.IR \%name.s
in the lowest
-.I man
-section.
+.I man\~\c
+.IR section .
.
.
.P
Now
-.BI man: name
+.BI \%man: name
searches for a man\~page in the lowest man\~section that has a
document called
-.IR name .
+.IR \%name .
.
.
.P
The pattern
-.I "s name"
+.I \%s\~name
originates from a strange argument parsing of the
.I man
program.
@@ -1990,25 +2002,25 @@
is a
.I classical man section
interpret it as a search for a man\~page called
-.I name
+.I \%name
in man\~section
.IR s ,
otherwise interpret
.I s
as a file argument and
-.I name
+.I \%name
as another
-.I filespec
+.I \%filespec
argument.
.
.
.P
We are left with the argument
-.I name
+.I \%name
which is not an existing file.
.
So this searches for the man\~page called
-.I name
+.I \%name
in the lowest man\~section that has a document for this name.
.
.
@@ -2016,14 +2028,14 @@
Several file name arguments can be supplied.
.
They are mixed by
-.I groff
+.I \%groff
into a single document.
.
Note that the set of option arguments must fit to all of these file
arguments.
.
So they should have at least the same style of the
-.I groff
+.I \%groff
language.
.
.
@@ -2032,19 +2044,19 @@
.\" --------------------------------------------------------------------
.
By default, the
-.I groffer
+.I \%groffer
program collects all input into a single file, formats it with the
-.I groff
+.I \%groff
program for a certain device, and then chooses a suitable viewer
program.
.
The device and viewer process in
-.I groffer
+.I \%groffer
is called a
-.IR mode .
+.IR \%mode .
.
The mode and viewer of a running
-.I groffer
+.I \%groffer
program is selected automatically, but the user can also choose it
with options.
.
@@ -2062,23 +2074,23 @@
.P
Several different modes are offered, graphical X modes, text modes,
and some direct
-.I groff
+.I \%groff
modes for debugging and development.
.
.
.P
By default,
-.I groffer
+.I \%groffer
first tries whether
.B x
mode is possible, then
-.B ps
+.B \%ps
mode, and finally
-.B tty
+.B \%tty
mode.
.
This mode testing sequence for
-.B auto
+.B \%auto
mode can be changed by specifying a comma separated list of modes
with the option
.Opt_long default\-modes.
@@ -2093,8 +2105,9 @@
.SS "Graphical Display Modes"
.\" --------------------------------------------------------------------
.
-The graphical display modes work only in the X Window environment (or
-similar implementations within other windowing environments).
+The graphical display modes work only in the
+.I X\~Window environment
+(or similar implementations within other windowing environments).
.
The environment variable
.Env_var $DISPLAY
@@ -2103,7 +2116,7 @@
are used for specifying the X display to be used.
.
If neither is given,
-.I groffer
+.I \%groffer
assumes that no X and changes to one text mode.
.
You can change this automatic behavior by the option
@@ -2127,31 +2140,39 @@
.
.Topic
in a Postscript viewer
+.nh
.RI ( ps
mode),
+.hy
.
.Topic
in a dvi viewer program
+.nh
.RI ( dvi
mode),
+.hy
.
.Topic
in a PDF viewer
+.nh
.RI ( pdf
mode),
+.hy
.
.Topic
in a web browser
+.nh
.RI ( html
or
.I www
mode),
+.hy
.RE
.
.
.P
The
-.I pdf
+.I \%pdf
mode has a major advantage \[em] it is the only graphical diplay mode
that allows to search for text within the viewer; this can be a really
important feature.
@@ -2165,9 +2186,11 @@
Toolkit.
.
But the
-.I groffer
+.I \%groffer
options use a leading double minus instead of the single minus used by
-the X Window Toolkit.
+the
+.I X\~Window\~\c
+.IR Toolkit .
.
.
.\" --------------------------------------------------------------------
@@ -2175,9 +2198,9 @@
.\" --------------------------------------------------------------------
.
There are to modes for text output, mode
-.I text
+.I \%text
for plain output without a pager and mode
-.I tty
+.I \%tty
for a text output on a text terminal using some pager program.
.
.
@@ -2185,13 +2208,13 @@
If the variable
.Env_var $DISPLAY
is not set or empty, groffer assumes that it should use
-.I tty
+.I \%tty
mode.
.
.
.P
In the actual implementation, the groff output device
-.I latin1
+.I \%latin1
is chosen for text modes.
.
This can be changed by specifying option
@@ -2208,7 +2231,7 @@
or by the environment variable
.Env_var $PAGER .
If all of this is not used the
-.BR less (1)
+.BR \%less (1)
program with the option
.Opt_short r
for correctly displaying control sequences is used as the default
@@ -2220,13 +2243,13 @@
.\" --------------------------------------------------------------------
.
These modes use the
-.I groffer
+.I \%groffer
file determination and decompression.
.
This is combined into a single input file that is fed directly into
-.I groff
+.I \%groff
with different strategy without the
-.I groffer
+.I \%groffer
viewing facilities.
.
These modes are regarded as advanced, they are useful for debugging
@@ -2235,15 +2258,15 @@
.
.P
The
-.I source
+.I \%source
mode with just displays the generated input.
.
The
-.I groff
+.I \%groff
mode passes the input to
-.I groff
+.I \%groff
using only some suitable options provided to
-.IR groffer .
+.IR \%groffer .
.
This enables the user to save the generated output into a file or pipe
it into another program.
@@ -2251,23 +2274,25 @@
.
.P
In
-.I groff
+.I \%groff
mode, the option
.Opt_short Z
disables post-processing, thus producing the
+.nh
.I groff intermediate
.IR output .
+.hy
.
In this mode, the input is formatted, but not postprocessed; see
-.BR groff_out (@MAN5EXT@)
+.BR \%groff_out (@MAN5EXT@)
for details.
.
.
.P
All
-.I groff
+.I \%groff
short options are supported by
-.IR groffer .
+.IR \%groffer .
.
.
.\" --------------------------------------------------------------------
@@ -2304,22 +2329,22 @@
.
All long options, all environment variables, and most of the
functionality of the GNU
-.BR man (1)
+.BR \%man (1)
program were implemented.
.
This inludes the extended file names of man\~pages, for example,
the man\~page of
-.I groff
+.I \%groff
in man\~section 7 may be stored under
.File_name /usr/share/man/man7/groff.7.gz ,
where
.File_name /usr/share/man/
is part of the man\~path, the subdirectory
-.I man7
+.I \%man7
and the file extension
.I .7
refer to the man\~section 7;
-.I .gz
+.I \%.gz
shows the compression of the file.
.
.
@@ -2367,7 +2392,7 @@
.
.Topic
If this does not work, the
-.BR manpath (1)
+.BR \%manpath (1)
program for determining a path of man directories is tried.
.
.
@@ -2377,9 +2402,9 @@
is determined automatically.
.
For example, both
-.I /usr/share/man/linux/fr
+.File_name /usr/share/man/linux/fr
and
-.I /usr/share/man/fr/linux
+.File_name /usr/share/man/fr/linux
for french linux man\~pages are found.
.
The language and operating system names are determined from both
@@ -2412,18 +2437,22 @@
The language locale is usually specified in the POSIX 1003.1 based
format:
.P
+.nh
\f[I]<language>\f[][\f[CB]_\f[]\f[I]<territory>\f[][\f[CB].\f[]\
\f[I]<character-set>\f[][\f[CB],\f[]\f[I]<version>\f[]]]],
+.hy
.P
but the two-letter code in
+.nh
.I <language>
+.hy
is sufficient for most purposes.
.
.
.P
If no man\~pages for a complicated locale are found the country part
consisting of the first two characters (without the `\f[CB]_\f[]',
-`\f[CB].\f[]', and `\f[CB],\f[]', parts) of the locale is searched as
+`\f[CB].\f[]', and `\f[CB],\f[]' parts) of the locale is searched as
well.
.
.
@@ -2493,7 +2522,7 @@
.
.P
For further details on man\~page searching, see
-.BR man (1).
+.BR \%man (1).
.
.
.\" --------------------------------------------------------------------
@@ -2504,16 +2533,16 @@
.
If standard input or a file that was retrieved from the command line
parameters is compressed with a format that is supported by either
-.BR gzip (1)
+.BR \%gzip (1)
or
-.BR bzip2 (1)
+.BR \%bzip2 (1)
it is decompressed on-the-fly.
.
This includes the GNU
-.BR .gz ,
-.BR .bz2 ,
+.BR \%.gz ,
+.BR \%.bz2 ,
and the traditional
-.B .Z
+.B \%.Z
compression.
.
The program displays the concatenation of all decompressed input in
@@ -2528,9 +2557,9 @@
courtesy of other programs.
.
All environment variables of
-.BR groff (@MAN1EXT@)
+.BR \%groff (@MAN1EXT@)
and GNU
-.BR man (1)
+.BR \%man (1)
and some standard system variables are honored.
.
.
@@ -2555,9 +2584,9 @@
.\" --------------------------------------------------------------------
.
The groffer program is a shell script that is run through
-.BR /bin/sh ,
+.File_name /bin/sh ,
which can be internally linked to programs like
-.BR bash (1).
+.BR \%bash (1).
The corresponding system environment is automatically effective.
.
The following variables have a special meaning for groffer.
@@ -2590,6 +2619,7 @@
retrieving man\~pages.
.
A locale name is typically of the form
+.nh
.IR language [\c
.B _\c
.IR territory [\c
@@ -2597,20 +2627,21 @@
.IR codeset [\c
.B @\c
.IR modifier ]]],
+.hy
where
-.I language
+.I \%language
is an ISO 639 language code,
-.I territory
+.I \%territory
is an ISO 3166 country code, and
-.I codeset
+.I \%codeset
is a character set or encoding identifier like ISO-8859-1 or UTF-8;
see
-.BR setlocale (3).
+.BR \%setlocale (3).
.
The locale values\~\c
.B C
and
-.B POSIX
+.B \%POSIX
stand for the default, i.e. the man\~page directories without a
language prefix.
.
@@ -2623,7 +2654,7 @@
.
For example, to disable the use of a pager completely set this
variable to the
-.BR cat (1)
+.BR \%cat (1)
program
.Shell_cmd PAGER=cat\~groffer\~ anything
.
@@ -2643,13 +2674,13 @@
.
This is done internally by some shells.
.
-.I groffer
+.I \%groffer
ignores the bad POSIX behavior for option processing, that means that
option processing will be finished as soon as a non-option argument is
found.
.
Instead the GNU behavior of freely mixing options and
-.I filespec
+.I \%filespec
arguments is used in any case.
.
Usually, you do not want to set this environment variable externally.
@@ -2661,7 +2692,7 @@
.
The groffer program internally calls groff, so all environment
variables documented in
-.BR groff (@MAN1EXT@)
+.BR \%groff (@MAN1EXT@)
are internally used within groffer as well.
.
The following variables have a direct meaning for the groffer program.
@@ -2669,7 +2700,8 @@
.TP
.Env_var $GROFF_TMPDIR
If the value of this variable is an existing, writable directory,
-groffer uses it for storing its temporary files, just as groff does.
+.I \%groffer
+uses it for storing its temporary files, just as groff does.
.
.
.\" --------------------------------------------------------------------
@@ -2678,7 +2710,7 @@
.
Parts of the functionality of the man\~program were implemented in
groffer; support for all environment variables documented in
-.BR man (1)
+.BR \%man (1)
was added to groffer, but the meaning was slightly modified due to the
different approach in groffer; but the user interface is the same.
.
@@ -2700,7 +2732,7 @@
.TP
.Env_var $MANOPT
This variable contains options as a preset for
-.BR man (1).
+.BR \%man (1).
As not all of these are relevant for groffer only the essential parts
of its value are extracted.
.
@@ -2751,7 +2783,7 @@
.\" --------------------------------------------------------------------
.
The
-.I groffer
+.I \%groffer
program can be preconfigured by two configuration files.
.
This configuration can be overridden at each program start by command
@@ -2783,26 +2815,32 @@
of $GROFFER_OPT.
.
This easily allows to set general
-.I groffer
+.I \%groffer
options that are used with any call of
-.IR groffer .
+.IR \%groffer .
.
.
.P
-After the transformation of the minus lines the emerging shell scripts
-that are called by
-.I groffer
-using the `\c
-.CB .\~\c
+After the transformation of the minus lines, the emerging
+configuration shell scripts are called using the `\c
+.nh
+.CB \.\~\c
.IR filename '
-syntax.
+.hy
+shell syntax within
+.IR \%groffer .
.
.
.P
-The only option that needs a minus line in the configuration files is
+In the configuration files, there is only one option that really needs
+a line starting with a minus character because it cannot be restored
+by any shell tricks.
+.
+This is
.Opt_long shell .
-The reason is that its argument must be called at a very early stage
-before the whole syntax of the configuration can be transformed.
+The reason is that its argument must be retrieved at a very early
+stage of
+.IR \%groffer .
.
.
.P
@@ -2814,11 +2852,12 @@
minus sign.
.
.Topic
-Preset environment variables recognized by groffer.
+Preset environment variables recognized by
+.IR \%groffer .
.
.Topic
Write a function for calling a viewer program for a special
-.I mode
+.I \%mode
and feed this name into its corresponding
.Opt_long \f[I]mode\f[]\-viewer
option.
@@ -2831,7 +2870,8 @@
.
.P
As an example, consider the following configuration file in
-~/.groff/groffer.conf, say.
+.File_name ~/.groff/groffer.conf ,
+say.
.
.P
.ft CR
@@ -2857,32 +2897,30 @@
.
.P
This configuration sets four
-.I groffer
-options and runs two shell commands.
+.I \%groffer
+options (the lines starting with `-') and runs two shell commands (the
+rest of the script).
.
This has the following effects:
.
.
.Topic
-Lines starting with a
-.B #
-character
-are
-.
-.
-.Topic
Use
.B /bin/bash
as the shell to run the
-.I groffer
+.I \%groffer
script.
.
.
.Topic
-Take a resolution of
-.B 100 dpi
-and a text color of
-.B DarkBlue
+Use a resolution of
+.B 100\~dpi
+in all viewers that support this.
+.
+.
+.Topic
+Use a text color of
+.B \%DarkBlue
in all viewers that support this.
.
.
@@ -2891,28 +2929,29 @@
.BR \%gxditview (@MAN1EXT@)
as the X-mode viewer using the geometry option for setting the width
to
-.B 850 dpi
+.B 850\~dpi
and the height to
-.B 800
+.B 800\~\c
.BR dpi .
.
.
.Topic
-The variable
+If the environment variable
.Env_var $DISPLAY
-is set to
-.IR localhost:0.0
-which allows to start
-.I groffer
-in the standard X display, even when the program is called from a text
+is empty set it to
+.IR localhost:0.0 .
+.
+That allows to start
+.I \%groffer
+in the standard X\~display, even when the program is called from a text
console.
.
.
.Topic
Just for fun, the date of each
-.I groffer
+.I \%groffer
start is written to the file
-.B mygroffer.log
+.File_name mygroffer.log
in the home directory.
.
.
@@ -2920,7 +2959,9 @@
.SH "EXAMPLES"
.\" --------------------------------------------------------------------
.
-The usage of groffer is very easy.
+The usage of
+.I \%groffer
+is very easy.
.
Usually, it is just called with a file name or man\~page.
.
@@ -2931,33 +2972,33 @@
.TP
.Shell_cmd "groffer\~/usr/local/share/doc/groff/meintro.ms.gz"
Decompress, format and display the compressed file
-.I meintro.ms.gz
+.File_name meintro.ms.gz
in the directory
-.IR /usr/local/share/doc/groff ,
+.File_name /usr/local/share/doc/groff ,
using
.I \%gxditview
as graphical viewer when in X Window, or the
-.BR less (1)
+.BR \%less (1)
pager program when not in X.
.
.
.TP
.Shell_cmd "groffer\~groff"
If the file
-.I ./groff
+.I \%./groff
exists use it as input.
.
Otherwise interpret the argument as a search for the man\~page named
-.I groff
-in the smallest possible man\~section, being secion 1 in this case.
+.I \%groff
+in the smallest possible man\~section, being section 1 in this case.
.
.
.TP
.Shell_cmd "groffer\~man:groff"
search for the man\~page of
-.I groff
+.I \%groff
even when the file
-.I ./groff
+.File_name ./groff
exists.
.
.
@@ -2966,7 +3007,7 @@
.TP+
.Shell_cmd "groffer\~7\~groff"
search the man\~page of
-.I groff
+.I \%groff
in man\~section
.BR 7 .
This section search works only for a digit or a single character from
@@ -2976,11 +3017,11 @@
.TP
.Shell_cmd "groffer\~fb.modes"
If the file
-.I ./fb.modes
+.File_name ./fb.modes
does not exist interpret this as a search for the man\~page of
.IR fb.modes .
As the extension
-.I modes
+.I \%modes
is not a single character in classical section style the argument is
not split to a search for
.IR fb .
@@ -2991,16 +3032,18 @@
.
The arguments that are not existing files are looked-up as the
following man\~pages:
-.I groff
+.I \%groff
(automatic search, should be found in man\~section\~1),
-.I troff
+.I \%troff
(in section\~1),
and
-.I roff
+.I \%roff
(in the section with the lowest number, being\~7 in this case).
.
The quotes around
+.nh
.I \[cq]troff(1)\[cq]
+.hy
are necessary because the paranthesis are special shell characters;
escaping them with a backslash character
.I \[rs](
@@ -3019,15 +3062,18 @@
for the
.B ls
program, decompress it, format it to
-.I html
+.I \%html
format
+.nh
.RI ( www
-mode) and view the result in the web browser
-.I galeon .
+mode)
+.hy
+and view the result in the web browser
+.IR \%galeon .
The option
.Opt_long man
guarantees that the man\~page is retrieved, even when a local file
-.I ls
+.I \%ls
exists in the actual directory.
.
.
@@ -3035,7 +3081,7 @@
.Shell_cmd "groffer\~--source\~'man:roff(7)'"
.
Get the man\~page called
-.I roff
+.I \%roff
in man\~section 7, decompress it, and print its unformatted content,
its source code.
.
@@ -3044,11 +3090,11 @@
.Shell_cmd "cat\~file.gz\~|\~groffer\~-Z\~-mfoo"
.
Decompress the standard input, send this to
-.I groff
+.I \%groff
intermediate mode without post-processing (groff option
.Opt_short Z ),
using macro package by
-.I foo
+.I \%foo
(groff option
.Opt_short m ) .
.
@@ -3067,7 +3113,7 @@
.\" --------------------------------------------------------------------
.
The
-.B groffer
+.B \%groffer
shell script is compatible with both GNU and POSIX.
.
POSIX compatibility refers to
@@ -3091,25 +3137,33 @@
Nevertheless this script uses only a restricted set of shell language
elements and shell builtins.
.
-The groffer script should work on most actual free and commercial
-operating systems.
+The
+.I \%groffer
+script should work on most actual free and commercial operating
+systems.
.
.
.P
-The groffer program provides its own parser for command line options;
-it can handle option arguments and file names containing white space
-and a large set of special characters.
+The
+.I \%groffer
+program provides its own parser for command line options; it can
+handle option arguments and file names containing white space and a
+large set of special characters.
.
.
.P
-The groffer shell script was tested with the following common
-implementations of the GNU shells:
-POSIX
-.BR sh (1),
-.BR bash (1),
+The
+.I \%groffer
+shell script was tested with the following common implementations of
+the GNU shells:
+.I \%POSIX
+.BR \%sh (1),
+.BR \%bash (1),
and others.
.
-Free POSIX compatible shells and shell utilities for most operating
+Free
+.I \%POSIX
+compatible shells and shell utilities for most operating
systems are available at the
.URL http://\:www.gnu.org/software/ "GNU software archive" .
.
@@ -3120,18 +3174,22 @@
This option can also be given to the environment variable
.Env_var $GROFF_OPT .
If you want to write it to one of the
-.I groffer
+.I \%groffer
configuration files you must use the single option style, a line
starting with
.Opt_long shell .
.
.
.P
-The groffer program provides its own parser for command line arguments
-that is compatible to both POSIX
-.BR getopts (1)
-and GNU
-.BR getopt (1)
+The
+.I \%groffer
+program provides its own parser for command line arguments that is
+compatible to both
+.I \%POSIX
+.BR \%getopts (1)
+and
+.I \%GNU
+.BR \%getopt (1)
except for shortcuts of long options.
.
The following standard types of options are supported.
@@ -3140,7 +3198,7 @@
.Topic
A single minus always refers to single character option or a
combination thereof, for example, the
-.I groffer
+.I \%groffer
short option combination
.Opt_short Qmfoo
is equivalent to
@@ -3199,116 +3257,130 @@
.\" --------------------------------------------------------------------
.
.TP
-.BR groff (@MAN1EXT@)
+.BR \%groff (@MAN1EXT@)
.TP+
-.BR troff (@MAN1EXT@)
+.BR \%troff (@MAN1EXT@)
Details on the options and environment variables available in
-.IR groff ;
+.IR \%groff ;
all of them can be used with groffer.
.
.
.TP
-.BR groff (@MAN7EXT@)
+.BR \%groff (@MAN7EXT@)
Documentation of the
-.I groff
+.I \%groff
language.
.
.
.TP
-.BR grog (@MAN1EXT@)
-Internally, groffer tries to guess the groff command line options from
-the input using this program.
+.BR \%grog (@MAN1EXT@)
+Internally,
+.I \%groffer
+tries to guess the
+.I \%groff
+command line options from the input using this program.
.
.
.TP
.BR groff_out (@MAN5EXT@)
-Documentation on the groff intermediate output (ditroff output).
+Documentation on the
+.I \%groff intermediate output
+.nh
+.RI ( ditroff
+output).
+.hy
.
.
.TP
-.BR man (1)
+.BR \%man (1)
The standard program to diplay man\~pages.
.
The information there is only useful if it is the man\~page for
.IR "GNU\~man" .
Then it documents the options and environment variables that are
-supported by groffer.
+supported by
+.IR \%groffer .
.
.
.TP
-.BR gxditview (@MAN1EXT@)
+.BR \%gxditview (@MAN1EXT@)
.TP+
-.BR xditview (1x)
-Viewers for groffer's
+.BR \%xditview (1x)
+Viewers for
+.IR \%groffer 's
.I x
mode.
.
.
.TP
-.BR kghostview (1)
+.BR \%kghostview (1)
.TP+
-.BR ggv (1)
+.BR \%ggv (1)
.TP+
-.BR gv (1)
+.BR \%gv (1)
.TP+
-.BR ghostview (1)
+.BR \%ghostview (1)
.TP+
-.BR gs (1)
-Viewers for groffer's
+.BR \%gs (1)
+Viewers for
+.IR \%groffer 's
.I ps
mode.
.
.
.TP
-.BR kghostview (1)
+.BR \%kghostview (1)
.TP+
-.BR ggv (1)
+.BR \%ggv (1)
.TP+
-.BR xpdf (1)
+.BR \%xpdf (1)
.TP+
-.BR acroread (1)
+.BR \%acroread (1)
.TP+
-.BR kpdf (1)
-Viewers for groffer's
-.I pdf
+.BR \%kpdf (1)
+Viewers for
+.IR \%groffer 's
+.I \%pdf
mode.
.
.
.TP
-.BR kdvi (1)
+.BR \%kdvi (1)
.TP+
-.BR xdvi (1)
+.BR \%xdvi (1)
.TP+
-.BR dvilx (1)
-Viewers for groffer's
-.I dvi
+.BR \%dvilx (1)
+Viewers for
+.IR \%groffer 's
+.I \%dvi
mode.
.
.
.TP
-.BR konqueror (1)
+.BR \%konqueror (1)
.TP+
-.BR mozilla (1)
+.BR \%mozilla (1)
.TP+
-.BR lynx (1)
-Web-browsers for groffer's
-.I html
+.BR \%lynx (1)
+Web-browsers for
+.IR \%groffer 's
+.I \%html
or
-.I www
+.I \%www
mode.
.
.
.TP
-.BR less (1)
+.BR \%less (1)
Standard pager program for the
-.I tty
+.I \%tty
.IR mode .
.
.
.TP
-.BR gzip (1)
+.BR \%gzip (1)
.TP+
-.BR bzip2 (1)
+.BR \%bzip2 (1)
The decompression programs supported by groffer.
.
.
| [Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Groff-commit] groff/contrib/groffer ChangeLog groffer.man,
Werner LEMBERG <=