1 files changed, 98 insertions, 0 deletions
diff --git a/upstream/debian-bookworm/man1/fstopgm.1 b/upstream/debian-bookworm/man1/fstopgm.1
new file mode 100644
index 00000000..5e2f1afd
--- /dev/null
+++ b/upstream/debian-bookworm/man1/fstopgm.1
@@ -0,0 +1,98 @@
+\
+.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
+.\" Do not hand-hack it!  If you have bug fixes or improvements, please find
+.\" the corresponding HTML page on the Netpbm website, generate a patch
+.\" against that, and send it to the Netpbm maintainer.
+.TH "Fstopgm User Manual" 1 "06 April 89" "netpbm documentation"
+
+.SH NAME
+fstopgm - convert a Usenix FaceSaver(tm) file into a PGM image
+
+
+.UN synopsis
+.SH SYNOPSIS
+
+\fBfstopgm\fP
+[\fIfsfile\fP]
+
+.UN description
+.SH DESCRIPTION
+.PP
+This program is part of
+.BR "Netpbm" (1)\c
+\&.
+.PP
+\fBfstopgm\fP reads a Usenix FaceSaver(tm) file as input and
+produces a PGM image as output.
+.PP
+FaceSaver(tm) files sometimes have rectangular pixels.  While
+\fBfstopgm\fP won't re-scale them into square pixels for you, it will
+give you the precise \fBpamscale\fP command that will do the job.
+Because of this, reading a FaceSaver(tm) image is a two-step process.
+First you do:
+
+.nf
+  fstopgm > /dev/null
+
+.fi
+
+This will tell you whether you need to use \fBpamscale.\fP
+
+Then use one of the following pipelines:
+.nf
+  fstopgm | pnmnorm
+  fstopgm | pamscale -whatever | pnmnorm
+
+.fi
+
+To go to PBM, you want something more like one of these:
+.nf
+  fstopgm | pamenlarge 3 | pnmnorm | pamditherbw
+  fstopgm | pamenlarge 3 | pamscale <whatever> | pnmnorm | pamditherbw
+
+.fi
+
+You want to enlarge when going to a bitmap because otherwise you lose
+information; but enlarging by more than 3 does not look good.
+.PP
+FaceSaver is a registered trademark of Metron Computerware Ltd. of
+Oakland, CA.
+
+
+.UN options
+.SH OPTIONS
+.PP
+There are no command line options defined specifically
+for \fBfstopgm\fP, but it recognizes the options common to all
+programs based on libnetpbm (See 
+.UR index.html#commonoptions
+ Common Options
+.UE
+\&.)
+
+.UN seealso
+.SH SEE ALSO
+.BR "pgmtofs" (1)\c
+\&,
+.BR "pgm" (1)\c
+\&,
+.BR "pnmnorm" (1)\c
+\&,
+.BR "pamenlarge" (1)\c
+\&,
+.BR "pamscale" (1)\c
+\&,
+.BR "pamditherbw" (1)\c
+\&
+
+
+.UN author
+.SH AUTHOR
+
+Copyright (C) 1989 by Jef Poskanzer.
+.SH DOCUMENT SOURCE
+This manual page was generated by the Netpbm tool 'makeman' from HTML
+source.  The master documentation is at
+.IP
+.B http://netpbm.sourceforge.net/doc/fstopgm.html
+.PP
+\ No newline at end of file