doc/man2ps.M

   1 .TH MAN2PS 1
   2 .SH NAME
   3 man2ps \- create individual PostScript files for each page of a man page
   4 .SH SYNOPSIS
   5 .B man2ps
   6 .I file
   7 [\fIfile2\fP [\fI...\fP]]
   8 .SH DESCRIPTION
   9 .B man2ps
  10 is a bourne shell script that turns a man page into a set of PostScript
  11 files, for inclusion in a document.
  12 .B man2ps
  13 converts the man page to a PostScript file using
  14 .IR groff (1),
  15 and then uses the
  16 .IR csplit (1)
  17 command to split the file into individual pages.
  18 .B man2ps
  19 inserts the PostScript command:
  20 .sp
  21 .nf
  22 .in +.5i
  23 \&0.85 dup scale
  24 .in -.5i
  25 .fi
  26 .sp
  27 at the beginning of each page, so that the pages will fit onto an
  28 8.5"x11" page.
  29 .PP
  30 The files created by
  31 .B man2ps
  32 have the same name as the command, with a sequential number and the
  33 string ".ps" appended.  For example, running
  34 .B man2ps
  35 on the file "kinit.M" would produce the PostScript files "kinit1.ps",
  36 "kinit2.ps", ...
  37 .SH SEE ALSO
  38 troff(1), csplit(1)
  39 .SH BUGS
  40 .B man2ps
  41 requires the user to have
  42 .I groff
  43 and either
  44 .I csplit
  45 or
  46 .I gcsplit
  47 in her path.
  48 .SH AUTHORS
  49 .B man2ps
  50 was written by Jeff Bigler at Cygnus Support and Theodore Ts'o at MIT.