1 files changed, 103 insertions, 0 deletions
diff --git a/upstream/debian-unstable/man1/sunicontopnm.1 b/upstream/debian-unstable/man1/sunicontopnm.1
new file mode 100644
index 00000000..a4f72a9b
--- /dev/null
+++ b/upstream/debian-unstable/man1/sunicontopnm.1
@@ -0,0 +1,103 @@
+\
+.\" 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 "Sunicontopnm User Manual" 1 "23 October 2010" "netpbm documentation"
+
+.SH NAME
+sunicontopnm - convert a Sun icon into a Netpbm image
+
+
+.UN synopsis
+.SH SYNOPSIS
+
+\fBsunicontopnm\fP
+[\fIiconfile\fP]
+
+
+.UN description
+.SH DESCRIPTION
+.PP
+This program is part of
+.BR "Netpbm" (1)\c
+\&.
+.PP
+\fBsunicontopnm\fP reads a Sun icon as input and produces a PBM or PGM
+image as output.
+.PP
+If the input is of the Depth=8 variety, the output is PGM.  Otherwise,
+it is PBM.  Before Netpbm 10.53 (December 2010), the program would not work
+on a Depth=8 icon.
+.PP
+If the input is color, the output is still PGM (the program can't do
+any better because developers haven't figured out how).  If you know the
+palette used by the Sun icon image, you can use \fBpamlookup\fP to
+convert the PGM output to the proper color Netpbm image.
+
+
+.UN options
+.SH OPTIONS
+.PP
+There are no command line options defined specifically
+for \fBsunicontopnm\fP, but it recognizes the options common to all
+programs based on libnetpbm (See 
+.UR index.html#commonoptions
+ Common Options
+.UE
+\&.)
+
+.UN sunicons
+.SH ABOUT SUN ICONS
+.PP
+It seems that this icon format was used in Sunview and was usable in its
+successor Openlook/Openwindows in Sun 4.1.1, which offered backward
+compatibility for Sunview, including the icons.  Sunview's desktop was
+monochrome.  OpenWindows had color icons.  Sun 4 came with OpenWindows.
+OpenWindows appears to have been an X-based gui so presumably the icons were
+mostly XPM files.
+.PP
+So in addition to \fBsunicontopnm\fP, you should try \fBxpmtoppm\fP and
+\fBxbmtopbm\fP on icons from a Sun Workstation.
+
+
+.UN seealso
+.SH SEE ALSO
+.BR "pbmtosunicon" (1)\c
+\&,
+.BR "winicontoppm" (1)\c
+\&,
+.BR "xpmtoppm" (1)\c
+\&,
+.BR "xbmtopbm" (1)\c
+\&,
+.BR "infotopam" (1)\c
+\&,
+.BR "pbm" (1)\c
+\&
+.BR "pgm" (1)\c
+\&
+
+.UN history
+.SH HISTORY
+.PP
+Jef Poskanzer wrote the program under the name \fBicontopbm\fP in 1988.
+.PP
+In October 2010, Prophet Of The Way (afu@wta.att.ne.jp) converted it to use
+the more recent "packed PBM" library functions, thus speeding it up
+.PP
+Netpbm 10.53 (December 2010) renamed the program to \fBsunicontopnm\fP.
+This name reflects the fact that there are lots of kinds of icons in the world
+besides the Sun variety, Windows ones being most popular.  It also takes
+into account the new Depth=8 capability (see below).
+.PP
+Netpbm 10.53 (December 2010) added the ability to work with Depth=8
+icon input and input with 32 bit "items."  Whereas the previous
+program always produced PBM output, the new program produced PGM in the
+Depth=8 case.
+.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/sunicontopnm.html
+.PP
+\ No newline at end of file