version 1.10, 2003/06/10 09:12:12 |
version 1.11, 2007/03/16 16:03:03 |
|
|
.Nd grind nice listings of programs |
.Nd grind nice listings of programs |
.Sh SYNOPSIS |
.Sh SYNOPSIS |
.Nm vgrind |
.Nm vgrind |
.Op Fl |
.Op Fl fnstWx |
.Op Fl W |
|
.Op Fl d Ar file |
.Op Fl d Ar file |
.Op Fl f |
|
.Op Fl h Ar header |
.Op Fl h Ar header |
.Op Fl l Ar language |
.Op Fl l Ar language |
.Op Fl n |
.Ar |
.Op Fl sn |
|
.Op Fl t |
|
.Op Fl x |
|
.Ar name Ar ... |
|
.Sh DESCRIPTION |
.Sh DESCRIPTION |
.Nm |
.Nm |
formats the program sources which are arguments |
formats the program sources which are arguments |
|
|
acts as a filter in a manner similar to |
acts as a filter in a manner similar to |
.Xr tbl 1 . |
.Xr tbl 1 . |
The standard input is passed directly to the standard output except |
The standard input is passed directly to the standard output except |
for lines bracketed by the |
for lines bracketed by the following troff-like macros: |
.Em troff-like |
.Pp |
macros: |
.Bl -tag -width Ds -offset indent -compact |
.Bl -tag -width Ds |
|
.It \&.vS |
.It \&.vS |
starts processing |
starts processing |
.It \&.vE |
.It \&.vE |
|
|
accepts input files, processes them, and passes them to |
accepts input files, processes them, and passes them to |
.Xr troff 1 |
.Xr troff 1 |
for output. |
for output. |
|
Input is taken from standard input if |
|
.Sq - |
|
is specified instead of |
|
.Ar file . |
.Pp |
.Pp |
In both modes |
In both modes |
.Nm |
.Nm |
|
|
.Pp |
.Pp |
The options are as follows: |
The options are as follows: |
.Bl -tag -width Ds |
.Bl -tag -width Ds |
.It Fl |
|
Forces input to be taken from standard input (default if |
|
.Fl f |
|
is specified). |
|
.It Fl W |
|
Forces output to the (wide) Versatec printer rather than the (narrow) |
|
Varian. |
|
.It Fl d Ar file |
.It Fl d Ar file |
Specifies an alternate language definitions |
Specifies an alternate language definitions |
file (default is |
file (default is |
|
|
.It Fl h Ar header |
.It Fl h Ar header |
Specifies a particular header to put on every output page (default is |
Specifies a particular header to put on every output page (default is |
the file name). |
the file name). |
.It Fl l |
.It Fl l Ar language |
Specifies the language to use. |
Specifies the language to use. |
Currently known are |
Currently known are |
.Tn PASCAL |
.Tn PASCAL |
|
|
Similar to the same option in |
Similar to the same option in |
.Xr troff 1 |
.Xr troff 1 |
causing formatted text to go to the standard output |
causing formatted text to go to the standard output |
|
.It Fl W |
|
Forces output to the (wide) Versatec printer rather than the (narrow) |
|
Varian. |
.It Fl x |
.It Fl x |
Outputs the index file in a |
Outputs the index file in a |
.Dq pretty |
.Dq pretty |