diff options
author | wl <wl> | 2007-02-02 18:43:59 +0000 |
---|---|---|
committer | wl <wl> | 2007-02-02 18:43:59 +0000 |
commit | 9f73276b35cbd533c42dfadfc0746be621761d46 (patch) | |
tree | b90157790b7980e236539b0cb6572b312333a04d /src | |
parent | 89deb5d66fc8e6845cec183efb434e32829bb6be (diff) | |
download | groff-9f73276b35cbd533c42dfadfc0746be621761d46.tar.gz |
* tmac/an-ext.tmac (ME): Don't use `\:'.
* contrib/chem/chem.man, contrib/groffer/roff2.man,
src/roff/grog/grog.man: Further refinements and normalizations.
Diffstat (limited to 'src')
-rw-r--r-- | src/roff/grog/grog.man | 136 |
1 files changed, 89 insertions, 47 deletions
diff --git a/src/roff/grog/grog.man b/src/roff/grog/grog.man index b7748c04..ff48a4bb 100644 --- a/src/roff/grog/grog.man +++ b/src/roff/grog/grog.man @@ -1,4 +1,5 @@ .TH GROG @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@" +. .\" -------------------------------------------------------------------- .\" Legalize .\" -------------------------------------------------------------------- @@ -9,10 +10,10 @@ grog.1 - man page for grog (section 1) Source file position: <groff_source_top>/src/roff/grog/grog.man Installed position: $prefix/share/man/man1/grog.1 -Last Update: 6 Nov 2006 +Last Update: 2 Feb 2007 .. .de co -Copyright (C) 1989-2000,2001,2002,2003,2006 +Copyright (C) 1989-2000,2001,2002,2003,2006,2007 Free Software Foundation, Inc. . Written by James Clark. @@ -22,23 +23,22 @@ Werner Lemberg .ME Rewritten and put under GPL by Bernd Warken. . -. .P This file is part of -.IR \%grog , +.IR grog , which is part of -.IR \%groff , +.IR groff , a free software project. . You can redistribute it and/or modify it under the terms of the .nh -.B GNU General Public License +.B "GNU General Public License" .hy (\f[CR]GPL\f[]) as published by the .nh .BR "Free Software Foundation" , .hy -either version 2, or (at your option) any later version. +either version\~2, or (at your option) any later version. . .P You should have received a copy of the \f[CR]GNU General Public @@ -54,54 +54,48 @@ Or read the .BR gpl (1). You can also write to the .nh -.B Free Software Foundation, 51 Franklin St - Fifth Floor, Boston, +.B "Free Software Foundation, 51 Franklin St - Fifth Floor, Boston," .BR "MA 02110-1301, USA" . .hy .. . +. .\" -------------------------------------------------------------------- .\" Local macros .de FN .I \\$1 .. - -.\" -------------------------------------------------------------------- . +. +.\" -------------------------------------------------------------------- .SH NAME +. grog \- guess options for groff command - -.SH SYNOPSIS +. . .\" -------------------------------------------------------------------- -.\" SH "SYNOPSIS" -.\" -------------------------------------------------------------------- +.SH SYNOPSIS . .SY grog .OP \-C -.OP groff\-option ... +.RI [ \%groff\-option\ .\|.\|.\&] .OP \-\- -.OP filespec ... -.YS +.RI [ \%filespec\ .\|.\|.] . -.SY groff -[ -.B -h +.SY grog +.B \-h | -.B --help -] +.B \-\-help . -.SY groff -[ -.B -v +.SY grog +.B \-v | ---version -] +.B \-\-version .YS . . .\" -------------------------------------------------------------------- .SH DESCRIPTION -.\" -------------------------------------------------------------------- . .B grog reads the input (file names or standard input) and guesses which of @@ -117,8 +111,7 @@ command is output. . . .\" -------------------------------------------------------------------- -.SH "OPTIONS" -.\" -------------------------------------------------------------------- +.SH OPTIONS . The only .B grog @@ -174,8 +167,7 @@ is specified standard input is read automatically. . . .\" -------------------------------------------------------------------- -.SH "DETAILS" -.\" -------------------------------------------------------------------- +.SH DETAILS . .B grog reads all @@ -317,20 +309,29 @@ is used instead. . . .\" -------------------------------------------------------------------- -.SH "EXAMPLES" -.\" -------------------------------------------------------------------- +.SH EXAMPLES . .IP \(bu Calling +. .RS +.IP .EX grog meintro.me .EE +.RE +. +.IP results in +. +.RS +.IP .EX groff \-me meintro.me .EE -.P +.RE +. +.IP So .B grog recognized that the file @@ -343,16 +344,25 @@ macro package. . .IP \(bu On the other hand, +. .RS +.IP .EX grog pic.ms .EE +.RE +. +.IP outputs +. +.RS .IP -.ft CR +.EX groff \-pte \-ms pic.ms -.ft -.P +.EE +.RE +. +.IP Besides determining the macro package .BR \-ms , .B grog @@ -376,35 +386,52 @@ for . .IP \(bu If both files are combined by the command +. .RS +.IP .EX grog meintro.me pic.ms .EE +.RE +. +.IP an error message is sent to standard error because .B groff cannot work with two different macro packages: +. +.RS .IP .ft CR grog: error: there are several macro packages: -me -ms .ft -.P +.RE +. +.IP Additionally the corresponding output with the wrong options is printed to standard output: +. +.RS .IP -.ft CR +.EX groff -pte -me -ms meintro.me pic.ms -.ft -.P -But the program is terminated with an error code. +.EE .RE . +.IP +But the program is terminated with an error code. +. . .IP \(bu The call of +. .RS +.IP .EX grog \-ksS \-Tdvi grnexmpl.g .EE +.RE +. +.IP contains several .B groff options that are just passed on the output without any interface to @@ -421,9 +448,15 @@ and the option with argument .BR dvi . The output is +. +.RS +.IP .EX groff \-ksS \-Tdvi grnexmpl.g .EE +.RE +. +.IP so no additional option was added by .BR grog . As no option @@ -431,7 +464,6 @@ As no option was found by .B grog this file does not use a macro package. -.RE . . .IP \(bu @@ -441,15 +473,25 @@ can also handle files using the language. . The example +. .RS +.IP .EX grog chAh_brackets.chem .EE +.RE +. +.IP outputs +. +.RS +.IP .EX chem chAh_brackets.chem | groff \-pe .EE -.P +.RE +. +.IP So .B chem is run first and @@ -470,7 +512,7 @@ with . .\" -------------------------------------------------------------------- .SH "SEE ALSO" -.\" -------------------------------------------------------------------- +. .BR groff (@MAN1EXT@), .BR @g@troff (@MAN1EXT@), .BR @g@tbl (@MAN1EXT@), @@ -490,7 +532,7 @@ with . .\" -------------------------------------------------------------------- .SH "COPYING" -.\" -------------------------------------------------------------------- +. .co . . |