Completely rewrote Makefile. Fixed up man2ps script and wrote manpage

for it.

git-svn-id: svn://anonsvn.mit.edu/krb5/trunk@9040 dc483132-0cff-0310-8789-dd5450dbe970

1 files changed, 44 insertions, 0 deletions

diff --git a/doc/man2ps.M b/doc/man2ps.M
new file mode 100644
index 0000000..dc4e4ad
--- /dev/null
+++ b/doc/man2ps.M
@@ -0,0 +1,44 @@
+.TH MAN2PS 1
+.SH NAME
+man2ps \- create individual PostScript files for each page of a man page
+.SH SYNOPSIS
+.B man2ps
+.I file
+[\fIfile2\fP [\fI...\fP]]
+.SH DESCRIPTION
+.B man2ps
+is a bourne shell script that turns a man page into a set of PostScript
+files, for inclusion in a document.
+.B man2ps
+converts the man page to a PostScript file using
+.IR troff (1), 
+and then uses the
+.IR csplit (1)
+command to split the file into individual pages.
+.B man2ps
+inserts the PostScript command:
+.sp
+.nf
+.in +.5i
+\&.7 dup scale
+.in -.5i
+.fi
+.sp
+at the beginning of each page, so that the pages will fit onto a page in
+a standard size reference manual (7"x9.25").
+.PP
+The files created by
+.B man2ps
+have the same name as the command, with a sequential number and the
+string ".ps" appended.  For example, running
+.B man2ps
+on the file "kinit.M" would produce the PostScript files "kinit1.ps",
+"kinit2.ps", ...
+.SH SEE ALSO
+troff(1), csplit(1)
+.SH BUGS
+.B man2ps
+fails if the
+.I csplit
+command is not in the user's path.
+