Manual Reference Pages  - a2ps2 (1)


NAME

a2ps2 -

CONTENTS

Arguments
Author
Description
Diagnostics
Documented Version
Exit Status
Hints
Options
Permissions
Rcs Information
Rcs.sh Version
Restrictions
See Also
Synopsis
Warning(s)

DOCUMENTED VERSION

1.11 - 2012/09/04 21:34:12

SYNOPSIS

a2ps2 -c [-x]* [-X]* [-Z n]*
a2ps2 -l [-x]* [-X]* [-Z n]*
a2ps2 [-a altcmdname] [-f] [-n] [-o a2ps-opt]* [-P printer] [-t] [-T] [-x]* [-X]* [-Z n]* [-- {a2ps options}* [--]] {filenames}+

DESCRIPTION

Front-end for a2ps to allow easy to remember script names to be use for
automatically formatting printed output.
Note: the following 2 comment lines are handy for testing very wide output.
3456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_1234
10 20 30 40 50 60 70 80 90 100 110 120 130 140 150 160 170 180 190 200 210 220 230 240 250 260 270 280 290 300 310 320 330 340 350 360 370 380 390 400 410 420 430 440 450 460 470 480 490 500 510 520 530 540 550 560 570 580 590 600 610 620 630 640 650 660 670 680 690 700 710 720 730 740 750 760 770 780 790 800 810 820 830 840 850 860 870 880 890 900 910 920 930 940 950 960 970 980 990 1000 1010 1020

ARGUMENTS

    {filename}+ one or more files to print

OPTIONS

-c create symbolic links to this script
-l list information about pre-defined output formats
-a altcmdname
  output formatting is done using the name of this script when it executes,
use -a to specify formatting associated with a different script name
-f fill mode (i.e. --file-align=virtual) start each file on the next
virtual page instead of the next physical sheet (not supported by
prman[1..9] due to pre-processing of the man page source files)
-n number the lines (i.e. a2ps --line-numbers=1)
-o a2ps-opt
  options to pass through to a2ps
-P printer
  send output to specified printer instead of system default printer
-s simplex|duplex
  pass value to a2ps
-t truncate long lines (i.e. ap2s --truncate-lines=yes)
-T generate table of contents (i.e. ap2s --toc), all files get passed
to one a2ps call (not supported by prman[1..9] due to pre-processing
of the man page source files)
-- {a2ps options}
  because a2ps supports lots of options, it can be handy to be
able to access them, hence, between the options for this script and any filename
parameters you can specify ’--’ then any a2ps options
-x does ’set -x’ (may be used in functions and external script calls) (see DIAGNOSTICS below)
-X sets debugging level--the number of times -X is specified (see DIAGNOSTICS below)
-Z n specify debugging flag ’n’ (see DIAGNOSTICS below)

HINTS

  1. To use this file as print test file to count columns use the "-t" option to truncate the very long column numbering rows near the top of this script
  2. A2ps may have delegating enabled (cf. a2ps --list=defaults). If so, then it may assume you want another program to process the output first. For example, if you execute the command "pr80 file.html," then a2ps will assume you want to print the interpreted HTML and not the source. To print the source file, you need to turn off delegating.
    e.g.: pr80 -- --delegate=no file.html
  3. This web page documents command line options better than the man page does: http://www.infres.enst.fr/~demaille/a2ps/doc-4.10/a2ps_3.html

RESTRICTIONS

  1. There is a limited amount of space in the title area and the footer for text strings. If it happens that the strings overlap, then a postscript error may occur and the document will fail to print properly. If the printer is set to display PostScript errors, then you will get a stack dump on the page. If the printer is set to NOT display PostScript errors, then your printout will fail to print without any other indication. To help with this problem, this script will reduce the amount of information printed in the title/footer for particular values of the layout (i.e. -1 .. -9) which are prone to this problem, however if you print a document with a 100 character file name, then you may never be able to print it with this script--try plain a2ps.
  2. Because any a2ps options can be passed to a2ps and the mechanism used is to allow them to be inserted after a "--" and before the filename(s), the first filename should not start with a "-" or a "--" as this script will just pass them to a2ps as options (which may or may not work as expected. Insert another "--" at the end of the a2ps options if a file name starts with "-".

RCS.SH VERSION

00014

RCS INFORMATION

$Id: a2ps2,v 1.11 2012/09/04 21:34:12 earneson Exp $
$Author: earneson $
$Date: 2012/09/04 21:34:12 $
$Revision: 1.11 $
$Source: /Users/cvs/scripts/all/Users/earneson/bin/a2ps2,v $
$State: Exp $

PERMISSIONS

rwxr-xr-x userUID staff

WARNING(S)

40 - The localize script could not be found. Global machine settings can not be set.

EXIT STATUS

51 - An unknown option was passed to the script, or syntax of the parameters is wrong.
51 - Unknown option >$errflag<
52 - Variable ejadir not set. Home directory not found.
53 - Can not find eja binary directory $ejadir/bin
56 - The USAGE was requested using -z or -?.

SEE ALSO

pr100 (symlink)
pr132 (symlink)
pr132x101 (symlink)
pr155 (symlink)
pr155p (symlink)
pr155x117 (symlink)
pr16up132l (symlink)
pr16up132p (symlink)
pr16up80l (symlink)
pr16up80p (symlink)
pr172 (symlink)
pr172x75 (symlink)
pr186 (symlink)
pr186p (symlink)
pr186x141 (symlink)
pr200 (symlink)
pr205 (symlink)
pr205x87 (symlink)
pr240 (symlink)
pr240x105 (symlink)
pr246x105 (symlink)
pr300 (symlink)
pr400 (symlink)
pr500 (symlink)
pr600 (symlink)
pr700 (symlink)
pr80 (symlink)
pr800 (symlink)
pr80x66 (symlink)
pr86x66 (symlink)
pr900 (symlink)
prman (symlink)
prman1 (symlink)
prman2 (symlink)
prman3 (symlink)
prman4 (symlink)
prman5 (symlink)
prman6 (symlink)
prman7 (symlink)
prman8 (symlink)
prman9 (symlink)

AUTHOR

Edwin Arneson

DIAGNOSTICS

-X output "while getopts" processing;
 
-XX ditto
 
-XXX ditto
 
-XXXX ditto
 
-Z10.0 none
 


\\$4  a2ps2 (1) EJA UTILITY
Generated by manServer 1.07 from a2ps2.1 using man macros. With tweaks by Edwin Arneson.