home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 September / Simtel20_Sept92.cdr / msdos / postscpt / text2ps.arc / TEXT2PS.DOC < prev    next >
Text File  |  1987-07-17  |  5KB  |  112 lines
  1. TEXT2PS(1)                   (V1.04)                   TEXT2PS(1)
  2.  
  3.  
  4.  
  5. NAME
  6.    text2ps - convert text to postscript
  7.  
  8. SYNOPSIS
  9.    text2ps  [-r[angle]]  [-f[fontname]]  [-s[pointsize]]
  10.             [-h[space]]  [-p[linepitch]]  [-o[offset]]
  11.             [-oe[offset]]  [-m[topmargin]] [-w[linewidth]] 
  12.             [-l[pagelength]]  [-v]  [-?]  [files...]
  13.  
  14. DESCRIPTION
  15.    Text2ps reads text from standard input (or files if specified)
  16.    and produces postscript output, suitable for sending to any
  17.    postscript device (such as an Apple Laserwriter) or for using
  18.    with any program that expects postscript input (such as a
  19.    postscript interpreter used to drive some other raster
  20.    device).  Text is normally aligned to the top and left edges
  21.    of the imageable region of the page (usually slightly smaller
  22.    than the physical page size), and a new page is started
  23.    whenever text would fall below this region.  The following
  24.    options are understood, with all values able to be given
  25.    as integer or real:
  26.  
  27.    -r[angle]
  28.         Rotate the page by the given angle (in degrees).  The
  29.         default angle is 0 (portrait mode).  If -r is used
  30.         without specifying an angle, angle is set to 90
  31.         (landscape mode).  Angles other than 0 or 90 may cause
  32.         text to fall outside the imageable region.
  33.  
  34.    -f[fontname]
  35.         Set the font to the given fontname.  The default font is
  36.         Courier.  If -f is used without a fontname, the font is
  37.         set to Times-Roman.  The list of available fonts for the
  38.         Apple Laser-Writer printer is:
  39.  
  40.        Courier             Times-Roman      Helvetica
  41.        Courier-Bold        Times-Bold       Helvetica-Bold
  42.        Courier-Oblique     Times-Italic     Helvetica-Oblique
  43.        Courier-BoldOblique Times-BoldItalic Helvetica-BoldOblique
  44.  
  45.         Note that only the Courier family is a fixed-width font;
  46.         all the others are variable width, and so program
  47.         listings or columns of data will not line up.
  48.  
  49.    -s[pointsize]
  50.         Set the pointsize (character size) to the given value (72
  51.         points = 1 inch).  The default pointsize is 10.  If -s is
  52.         used without specifying the pointsize, the pointsize is
  53.         set to 12.
  54.  
  55.    -h[space]
  56.         Increase the horizontal spacing of characters by the
  57.         given fraction of the current pointsize.  For example,
  58.         using `-h0.25' when pointsize = 12 causes the horizontal
  59.         spacing to increase by 3 points. The default horizontal
  60.         spacing is 0 i.e. the characters are placed next to each
  61.         other, using their natural widths.  If -h is used without
  62.         specifying spacing, spacing is set to 0.25 x pointsize.
  63.  
  64.    -p[linepitch]
  65.         Set the line spacing of printed text to the given value
  66.         (72 points = 1 inch).  Unless a value is specified for
  67.         the linepitch using this option, the linepitch used will
  68.         be equal to pointsize + 2. 
  69.  
  70.    -o[offset]
  71.         Offset text from the left edge of the imageable region,
  72.         by the given distance (in centimeters) on all pages.  The
  73.         default offset is 0.  If -o is used without specifying an
  74.         offset, offset is set to 1 cm. 
  75.  
  76.    -oe[offset]
  77.         Offset text from the left edge of the imageable region,
  78.         by the given distance (in centimeters) on even pages
  79.         only.  The default offset for even pages is the same as
  80.         that for odd pages.  If -oe is used without specifying an
  81.         offset, offset is set to 1 cm on even pages.  Option -o
  82.         followed by the option -oe may be used to set offsets on
  83.         odd and even pages independently.
  84.  
  85.    -m[topmargin]
  86.         Set the top margin to the given value (in centimeters).
  87.         The default is to set this to 0.5 cm.  If -m is specified                       without a value for top margin, top margin is set to 1.5
  88.         cm.
  89.  
  90.    -w[linewidth]
  91.         Specify the number of characters per line.  Longer lines
  92.         are folded.  The default is no folding.  If -w is used
  93.         without specifying linewidth, linewidth is set to 72
  94.         characters per line.  Useful with fixed-width fonts.
  95.  
  96.    -l[pagelength]
  97.         Specify the number of lines per page.  The default is to
  98.         start a new page whenever text falls below the imageable
  99.         region.  If -l is used without specifying a pagelength,
  100.         pagelength is set to 60. 
  101.  
  102.    -v
  103.         Print the version number and quit.
  104.  
  105.    -?
  106.         Print a list of options and quit.
  107.  
  108. AUTHOR
  109.    Original: Stephen Frede, UNSW, Australia
  110.    Modifications: Venu P. Gopal
  111.  
  112.