grog.man revision 75584
1.ig \"-*- nroff -*-
2Copyright (C) 1989-2000 Free Software Foundation, Inc.
3
4Permission is granted to make and distribute verbatim copies of
5this manual provided the copyright notice and this permission notice
6are preserved on all copies.
7
8Permission is granted to copy and distribute modified versions of this
9manual under the conditions for verbatim copying, provided that the
10entire resulting derived work is distributed under the terms of a
11permission notice identical to this one.
12
13Permission is granted to copy and distribute translations of this
14manual into another language, under the above conditions for modified
15versions, except that this permission notice may be included in
16translations approved by the Free Software Foundation instead of in
17the original English.
18..
19.TH GROG @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@"
20.SH NAME
21grog \- guess options for groff command
22.SH SYNOPSIS
23.B grog
24[
25.BI \- option
26\|.\|.\|.
27]
28[
29.IR files \|.\|.\|.
30]
31.SH DESCRIPTION
32.B grog
33reads
34.I files
35and guesses which of the
36.BR groff  (@MAN1EXT@)
37options
38.BR \-e ,
39.BR \-man ,
40.BR \-me ,
41.BR \-mm ,
42.BR \-ms ,
43.BR \-mdoc,
44.BR \-mdoc-old,
45.BR \-p ,
46.BR \-R ,
47.BR \-g ,
48.BR \-G ,
49.BR \-s ,
50and
51.BR \-t
52are required for printing
53.IR files ,
54and prints the groff command including those options on the standard output.
55A filename of
56.B \-
57is taken to refer to the standard input.
58If no files are specified the standard input will be read.
59Any specified options will be included in the printed command.
60No space is allowed between options and their arguments.
61The only options recognized are
62.B \-C
63(which is also passed on) to enable compatibility mode, and
64.B \-v
65to print the version number.
66.LP
67For example,
68.IP
69.B `grog \-Tdvi paper.ms`
70.LP
71will guess the appropriate command to print
72.B paper.ms
73and then run it after adding the
74.B \-Tdvi
75option.
76.SH "SEE ALSO"
77.BR doctype (1),
78.BR groff (@MAN1EXT@),
79.BR @g@troff (@MAN1EXT@),
80.BR @g@tbl (@MAN1EXT@),
81.BR @g@pic (@MAN1EXT@),
82.BR @g@eqn (@MAN1EXT@),
83.BR @g@refer (@MAN1EXT@),
84.BR @g@grn (@MAN1EXT@),
85.BR grap (1),
86.BR @g@soelim (@MAN1EXT@)
87