--- a2ps.1 2024-11-25 23:38:42.068108362 +0000 +++ a2ps.1.new 2024-11-26 02:20:42.141699091 +0000 @@ -4,16 +4,18 @@ a2ps \- format files for printing on a PostScript printer .SH SYNOPSIS .B a2ps -[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]... +[\fI\,OPTION\/\fR]...\& [\fI\,FILE\/\fR]... .SH DESCRIPTION .\" Add any additional description here .PP -Convert FILE(s) or standard input to PostScript. By default, the output is -sent to the default printer. An output file may be specified with \fB\-o\fR. +Convert FILE(s) or standard input to PostScript. +By default, +the output is sent to the default printer. +An output file may be specified with \fB\-o\fR. .PP Mandatory arguments to long options are mandatory for short options too. -Long options marked with `*' require a yes/no argument, corresponding short -options stand for `yes'. +Long options marked with `*' require a yes/no argument, +corresponding short options stand for `yes'. .PP Tasks: .TP @@ -43,8 +45,8 @@ encodings, features, variables, media, p printers, prologues, style\-sheets, user\-options) .PP -After having performed the task, exit successfully. Detailed lists may provide -additional help on specific features. +After having performed the task, exit successfully. +Detailed lists may provide additional help on specific features. .PP Global: .TP @@ -60,7 +62,7 @@ use the user defined shortcut OPTION \fB\-\-debug\fR enable debugging features .TP -\fB\-D\fR, \fB\-\-define\fR=\fI\,KEY[\/\fR:VALUE] +\fB\-D\fR, \fB\-\-define\fR=\fI\,KEY\/\fR[:\fIVALUE\fR] unset variable KEY or set to VALUE .PP Sheets: @@ -97,10 +99,13 @@ print borders around columns \fB\-\-margin\fR[=\fI\,NUM\/\fR] define an interior margin of size NUM .PP -The options \fB\-1\fR.. \fB\-9\fR affect several primitive parameters to set up predefined -layouts with 80 columns. Therefore the order matters: `\-R \fB\-f40\fR \fB\-2\fR' is -equivalent to `\-2'. To modify the layout, use `\-2Rf40', or compose primitive -options (`\-\-columns', `\-\-font\-size' etc.). +The options \fB\-1\fR..\fB\-9\fR affect several primitive parameters to set +up predefined layouts with 80 columns. +Therefore the order matters: +`\-R \fB\-f40\fR \fB\-2\fR' is equivalent to `\-2'. +To modify the layout, +use `\-2Rf40', or compose primitive options +(`\-\-columns', `\-\-font\-size' etc.). .PP Virtual pages: .TP @@ -125,7 +130,8 @@ process FILE as a man page (same as \fB\ \fB\-T\fR, \fB\-\-tabsize\fR=\fI\,NUM\/\fR set tabulator size to NUM .HP -\fB\-\-non\-printable\-format\fR=\fI\,FMT\/\fR specify how non\-printable chars are printed +\fB\-\-non\-printable\-format\fR=\fI\,FMT\/\fR specify how non\-printable \ +chars are printed .PP Headings: .TP @@ -187,9 +193,10 @@ delegate files to another application \fB\-\-toc\fR[=\fI\,TEXT\/\fR] generate a table of content .PP -When delegations are enabled, a2ps may use other applications to handle the -processing of files that should not be printed as raw information, e.g., HTML -PostScript, PDF etc. +When delegations are enabled, +a2ps may use other applications to handle the processing of files +that should not be printed as raw information, +e.g., HTML, PostScript, PDF, etc. .PP Pretty\-printing: .TP @@ -197,7 +204,7 @@ Pretty\-printing: enable pretty\-printing (set style to LANG) .TP \fB\-\-highlight\-level\fR=\fI\,LEVEL\/\fR -set pretty printing highlight LEVEL +set pretty printing highlight LEVEL. LEVEL can be none, normal or heavy .TP \fB\-g\fR @@ -209,8 +216,8 @@ level of comments stripping Output: .TP \fB\-o\fR, \fB\-\-output\fR=\fI\,FILE\/\fR -leave output to file FILE. If FILE is `\-', -leave output to stdout. +leave output to file FILE. +If FILE is `\-', leave output to stdout. .TP \fB\-\-version\-control\fR=\fI\,WORD\/\fR override the usual version control @@ -240,10 +247,10 @@ print NUM copies of each page set the duplex MODE (`1' or `simplex', `2' or `duplex', `tumble') .TP -\fB\-S\fR, \fB\-\-setpagedevice\fR=\fI\,K[\/\fR:V] +\fB\-S\fR, \fB\-\-setpagedevice\fR=\fI\,K\/\fR[:\fIV\fP] pass a page device definition to output .TP -\fB\-\-statusdict\fR=\fI\,K[\/\fR:[:]V] +\fB\-\-statusdict\fR=\fI\,K\/\fR[:[:]\fIV\fP] pass a statusdict definition to the output .TP \fB\-k\fR, \fB\-\-page\-prefeed\fR @@ -252,31 +259,34 @@ enable page prefeed \fB\-K\fR, \fB\-\-no\-page\-prefeed\fR disable page prefeed .PP -By default a2ps is tuned to do what you want to, so trust it. To pretty print -the content of the `src' directory and a table of content, and send the result -to the printer `lw', +By default a2ps is tuned to do what you want to, so trust it. +To pretty print the content of the `src' directory +and a table of content, +and send the result to the printer `lw', .IP -\f(CW$ a2ps -P lw --toc src/*\fR +\f(CR$ a2ps \-P lw \-\-toc src/*\fR .PP To process the files `sample.ps' and `sample.html' and display the result, .IP -\f(CW$ a2ps -P display sample.ps sample.html\fR +\f(CR$ a2ps \-P display sample.ps sample.html\fR .PP To process a mailbox in 4 up, .IP -\f(CW$ a2ps -=mail -4 mailbox\fR +\f(CR$ a2ps \-=mail \-4 mailbox\fR .PP -To print as a booklet on the default printer, which is duplex capable, +To print as a booklet on the default printer, +which is duplex capable, .IP -\f(CW$ a2ps -=book paper.dvi.gz -d\fR +\f(CR$ a2ps \-=book paper.dvi.gz \-d\fR .SH FILES -a2ps reads several files before the command line options. In order, -they are: +a2ps reads several files before the command line options. +In order, they are: .IP 1. -The system configuration file (usually \fI/usr/local/etc/a2ps.cfg\fR) -unless you have defined the environment variable \fIA2PS_CONFIG\fR, in -which case a2ps reads the file it points to; +The system configuration file +(usually \fI/usr/local/etc/a2ps.cfg\fR) +unless you have defined the environment variable \fIA2PS_CONFIG\fR, +in which case a2ps reads the file it points to; .IP 2. the user's home configuration file (\fI$HOME/.a2ps/a2psrc\fR) @@ -284,8 +294,8 @@ the user's home configuration file (\fI$ .IP 3. the file \fI.a2psrc\fR in the current directory. -See the info manual for more information, including a description of the -configuration file format. +See the info manual for more information, +including a description of the configuration file format. .SH AUTHOR Written by Akim Demaille, Miguel Santana, and Reuben Thomas. .SH "REPORTING BUGS" @@ -308,11 +318,13 @@ There is NO WARRANTY, to the extent perm .PP The full documentation for .B a2ps -is maintained as a Texinfo manual. If the +is maintained as a Texinfo manual. +If the .B info and .B a2ps -programs are properly installed at your site, the command +programs are properly installed at your site, +the command .IP .B info a2ps .PP