about summary refs log tree commit diff
diff options
context:
space:
mode:
authorgiraffedata <giraffedata@9d0c8265-081b-0410-96cb-a4ca84ce46f8>2012-03-05 18:40:06 +0000
committergiraffedata <giraffedata@9d0c8265-081b-0410-96cb-a4ca84ce46f8>2012-03-05 18:40:06 +0000
commit957c8c367c8b8763479963ab0b106a625fa8a7c3 (patch)
tree1bae71d89ba7f7384317c6ee78e5984711424b2d
parentc66acd4437d9554996fca9e87f9dff946e143654 (diff)
downloadnetpbm-mirror-957c8c367c8b8763479963ab0b106a625fa8a7c3.tar.gz
netpbm-mirror-957c8c367c8b8763479963ab0b106a625fa8a7c3.tar.xz
netpbm-mirror-957c8c367c8b8763479963ab0b106a625fa8a7c3.zip
miscellaneous update
git-svn-id: http://svn.code.sf.net/p/netpbm/code/userguide@1659 9d0c8265-081b-0410-96cb-a4ca84ce46f8
-rw-r--r--directory.html3
-rw-r--r--pnmquantall.html72
-rw-r--r--ppmquantall.html65
-rw-r--r--xpmtoppm.html5
4 files changed, 90 insertions, 55 deletions
diff --git a/directory.html b/directory.html
index 8efbe137..0ad7e9ff 100644
--- a/directory.html
+++ b/directory.html
@@ -752,7 +752,7 @@ All of these generate Netpbm format output.
 <DT><B><a href=pnmquant.html>pnmquant</a>      </B>
 <DD>quantize colors/shades in a color or grayscale image down to fewer
 
-<DT><B><a href=ppmquantall.html>ppmquantall</a>   </B>
+<DT><B><a href=pnmquantall.html>pnmquantall</a>   </B>
 <DD>quantize colors on many files
 
 <DT><B><a href=ppmrelief.html>ppmrelief</a>     </B>
@@ -1094,6 +1094,7 @@ programs:
 <LI><B><a href=icontopbm.html>icontopbm</a>     </B>
 <LI><B><a href=pbmtoicon.html>pbmtoicon</a>     </B>
 <LI><B><a href=ppmquant.html>ppmquant</a>      </B>
+<LI><B><a href=ppmquantall.html>ppmquantall</a>      </B>
 </UL>
 
 
diff --git a/pnmquantall.html b/pnmquantall.html
new file mode 100644
index 00000000..be8ef33e
--- /dev/null
+++ b/pnmquantall.html
@@ -0,0 +1,72 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN">
+<HTML><HEAD><TITLE>Pnmquantall User Manual</TITLE></HEAD>
+<BODY>
+<H1>pnmquantall</H1>
+Updated: 05 March 2012
+<BR>
+<A HREF="#index">Table Of Contents</A>
+
+<H2>NAME</H2>
+
+pnmquantall - run Pnmquant on a bunch of files all at once, so they
+share a common colormap
+
+<H2 id="synopsis">SYNOPSIS</H2>
+
+<B>pnmquantall</B>
+
+[<B>-ext</B> <I>extension</I>] <I>ncolors</i> <i>netpbm_file</I>...
+
+<p>Note that the usual syntax rules for Netpbm programs <em>don't apply</em>
+to this program.  For example, you can't abbreviation -ext and you can't put
+it anywhere on the line you want.
+
+
+<H2 id="description">DESCRIPTION</H2>
+
+<p>This program is part of <a href="index.html">Netpbm</a>.
+
+<p><b>pnmquantall</b> takes a bunch of Netpbm image files as input, chooses
+<I>ncolors</I> colors to best represent all of the images, maps the
+existing colors to the new ones, and <strong>overwrites the input
+files</strong> with the new quantized versions.
+
+<P>If you don't want to overwrite your input files, use the
+<B>-ext</B> option.  The output files are then named the same as the
+input files, plus a period and the extension text you specify.
+
+<P>The purpose is this: Let's say you've got a dozen PPMs that you want to
+display on the screen all at the same time.  Your screen can only display 256
+different colors, but the PPMs have a total of a thousand or so different
+colors.  For a single image you solve this problem
+with <b>pnmquant</b>; <b>pnmquantall</b> solves it for multiple images.
+
+<P>Note that another approach to this problem is to pre-select a set
+of colors and then use <b>pnmremap</b> to separately quantize each PPM
+to that set.)
+
+<p>This is a rather simple program that runs <b>pnmcolormap</b> and
+<b>pnmremap</b>.  If you are considering using it in a program of any
+sophistication, you should probably just run those programs directly.
+Even if you are typing it, you may want to do the steps manually because
+it gives you access to the various options of <b>pnmcolormap</b> and
+<b>pnmremap</b> for doing the quantization differently.
+
+
+<H2 id="seealso">SEE ALSO</H2>
+
+<B><A HREF="pnmquant.html">pnmquant</A></B>,
+<B><A HREF="pnmremap.html">pnmremap</A></B>,
+<B><A HREF="pnmcolormap.html">pnmcolormap</A></B>,
+<B><A HREF="pnm.html">pnm</A></B>
+
+<HR>
+<A NAME="index">&nbsp;</A>
+<H2>Table Of Contents</H2>
+<UL>
+<LI><A HREF="#synopsis">SYNOPSIS</A>
+<LI><A HREF="#description">DESCRIPTION</A>
+<LI><A HREF="#seealso">SEE ALSO</A>
+</UL>
+</BODY>
+</HTML>
diff --git a/ppmquantall.html b/ppmquantall.html
index cdb7e674..fc7fc209 100644
--- a/ppmquantall.html
+++ b/ppmquantall.html
@@ -2,72 +2,31 @@
 <HTML><HEAD><TITLE>Ppmquantall User Manual</TITLE></HEAD>
 <BODY>
 <H1>ppmquantall</H1>
-Updated: 27 July 1990
+Updated: 05 March 2012
 <BR>
 <A HREF="#index">Table Of Contents</A>
 
-<A NAME="lbAB">&nbsp;</A>
 <H2>NAME</H2>
 
-ppmquantall - run Pnmquant on a bunch of files all at once, so they
-share a common colormap
+<B>ppmquantall</B> - replaced by pnmquantall
 
-<A NAME="lbAC">&nbsp;</A>
-<H2>SYNOPSIS</H2>
 
-<B>ppmquantall</B>
-
-[<B>-ext</B> <I>extension</I>] <I>ncolors</i> <i>ppmfile</I>...
-
-<A NAME="lbAD">&nbsp;</A>
 <H2>DESCRIPTION</H2>
 
 <p>This program is part of <a href="index.html">Netpbm</a>.
 
-<p><b>ppmquantall</b> takes a bunch of PPM images as input, chooses
-<I>ncolors</I> colors to best represent all of the images, maps the
-existing colors to the new ones, and <strong>overwrites the input
-files</strong> with the new quantized versions.
-
-<P>If you don't want to overwrite your input files, use the
-<B>-ext</B> option.  The output files are then named the same as the
-input files, plus a period and the extension text you specify.
-
-<P>Verbose explanation: Let's say you've got a dozen PPMs that you
-want to display on the screen all at the same time.  Your screen can
-only display 256 different colors, but the PPMs have a total of a
-thousand or so different colors.  For a single PPM you solve this
-problem with <b>pnmquant</b>; <b>ppmquantall</b> solves it for
-multiple PPMs.  All it does is concatenate them together into one big
-PPM, run <b>pnmquant</b> on that, and then split it up into little
-PPMs again.
-
-<P>(Note that another way to solve this problem is to pre-select a set
-of colors and then use <b>pnmremap</b> to separately quantize each PPM
-to that set.)
+<p><b>ppmquantall</b> was obsoleted by <a
+href="pnmquantall.html"><b>pnmquantall</b></a>, introduced with Netpbm 10.58
+(March 2012).  <b>pnmquantall</b> is just a renaming to reflect the fact
+that the program handles all kinds of Netpbm input files, not just
+PPM.  Though this was not always the case, it had been for many years
+before the renaming.
 
-<A NAME="lbAE">&nbsp;</A>
-<H2>SEE ALSO</H2>
+<p>For Netpbm before 10.58, where the program is still named
+<b>ppmquantall</b>, just use the <b>pnmquantall</b> manual.
 
-<B><A HREF="pnmquant.html">pnmquant</A></B>,
-<B><A HREF="pnmremap.html">pnmremap</A></B>,
-<B><A HREF="pnmcolormap.html">pnmcolormap</A></B>,
-<B><A HREF="ppm.html">ppm</A></B>
+</BODY>
+</HTML>
 
-<A NAME="lbAG">&nbsp;</A>
-<H2>AUTHOR</H2>
 
-Copyright (C) 1991 by Jef Poskanzer.
 
-<HR>
-<A NAME="index">&nbsp;</A>
-<H2>Table Of Contents</H2>
-<UL>
-<LI><A HREF="#lbAB">NAME</A>
-<LI><A HREF="#lbAC">SYNOPSIS</A>
-<LI><A HREF="#lbAD">DESCRIPTION</A>
-<LI><A HREF="#lbAE">SEE ALSO</A>
-<LI><A HREF="#lbAG">AUTHOR</A>
-</UL>
-</BODY>
-</HTML>
diff --git a/xpmtoppm.html b/xpmtoppm.html
index dad8dfdc..c7c857bc 100644
--- a/xpmtoppm.html
+++ b/xpmtoppm.html
@@ -2,7 +2,7 @@
 <HTML><HEAD><TITLE>Xpmtoppm User Manual</TITLE></HEAD>
 <BODY>
 <H1>xpmtoppm</H1>
-Updated: 30 December 2011
+Updated: 31 December 2011
 <BR>
 <A HREF="#index">Table Of Contents</A>
 
@@ -70,6 +70,9 @@ comment that begins in Column 1 in the color table part of the file.
 
 <p>There must be for every pixel a default colorname for a color type visual.
 
+<p>Before Netpbm 10.58 (March 2012), zero bytes per pixel causes the program
+to fail with a message about premature EOF on input.
+
 <H2 id="seealso">SEE ALSO</H2>
 
 <B><A HREF="ppmtoxpm.html">ppmtoxpm</A></B>,