miscellaneous update

git-svn-id: http://svn.code.sf.net/p/netpbm/code/userguide@4473 9d0c8265-081b-0410-96cb-a4ca84ce46f8

5 files changed, 49 insertions, 27 deletions

diff --git a/directory.html b/directory.html
index e09a6927..10d25a66 100644
--- a/directory.html
+++ b/directory.html
@@ -593,6 +593,12 @@ convert Palm Pilot Image Viewer format to Netpbm formats.
 <dt><b><a href="pbmtozinc.html">pbmtozinc</a></b>
 <dd>convert PBM to Zinc Interface Library icon
 
+<dt><b><a href="pamtoqoi.html">pamtoqoi</a></b>
+<dd>convert from Netpbm formats to Quite OK Image format
+
+<dt><b><a href="qoitopam.html">qoitopam</a></b>
+<dd>convert from Quite OK Image format to PAM
+  
 <dt><b><a href="rawtopgm.html">rawtopgm</a></b>
 <dd>convert raw grayscale bytes to PGM
 
@@ -886,7 +892,8 @@ a color map containing all possible colors of given maxval
 <dd>rubber sheet deforming, distortion, stretching of an image
 
 <dt><b><a href="pamhomography.html">pamhomography</a></b>
-<dd>map one arbitrary quadrilateral image region to another
+<dd>stretch/shrink a quadrilateral region of an image to
+another quadrilateral shape
 
 <dt><b><a href="pamaddnoise.html">pamaddnoise</a></b>
 <dd>add noise to an image
@@ -916,12 +923,6 @@ a color map containing all possible colors of given maxval
 <dt><b><a href="pamundice.html">pamundice</a></b>
 <dd>assemble an image from tiles (opposite of <b>pamdice</b>)
 
-<dt><b><a href="ppmtorgb3.html">ppmtorgb3</a></b>
-<dd>separate a PPM into three PGMs
-
-<dt><b><a href="rgb3toppm.html">rgb3toppm</a></b>
-<dd>combine three PGMs into one PPM
-
 <dt><b><a href="pammixinterlace.html">pammixinterlace</a></b>
 
 <dd>mix adjacent lines to merge interlaced images
@@ -951,6 +952,9 @@ a color map containing all possible colors of given maxval
 <dt><b><a href="ppmfade.html">ppmfade</a></b>
 <dd>produce series of images fading from one to another
 
+<dt><b><a href="pamshuffle.html">pamshuffle</a></b>
+<dd>move pixels around randomly
+
 <dt><b><a href="pamoil.html">pamoil</a></b>
 <dd>turn a PNM or PAM image into an oil painting
 
@@ -1034,12 +1038,21 @@ These all work on the Netpbm formats as input.
 <dt><b><a href="pamstack.html">pamstack</a></b>
 <dd>stack the planes of multiple PAM images into a single output image
 
+<dt><b><a href="ppmtorgb3.html">ppmtorgb3</a></b>
+<dd>separate a PPM into three PGMs
+
+<dt><b><a href="rgb3toppm.html">rgb3toppm</a></b>
+<dd>combine three PGMs into one PPM
+
 <dt><b><a href="pampick.html">pampick</a></b>
 <dd>pick images out of a multi-image Netpbm image stream
 
 <dt><b><a href="pamsplit.html">pamsplit</a></b>
 <dd>split a multi-image Netpbm file into multiple 1-image files
 
+<dt><b><a href="pamrestack.html">pamrestack</a></b>
+<dd>rearrange (reflow) pixels into different size rows
+
 <dt><b><a href="pamexec.html">pamexec</a></b>
 <dd>run a shell command on each image of a multi-image stream
 
diff --git a/pamhomography.html b/pamhomography.html
index a20a5c5e..843c9c05 100644
--- a/pamhomography.html
+++ b/pamhomography.html
@@ -11,14 +11,15 @@
 
 <h1>pamhomography</h1>
 
-Updated: 03 January 2021
+Updated: 04 December 2022
 <br>
 <a href="#index">Table of Contents</a>
 
 
 <h2>NAME</h2>
 
-<p>pamhomography - map one arbitrary quadrilateral image region to another</p>
+<p>pamhomography - stretch/shrink a quadrilateral region of an image to
+  another quadrilateral shape</p>
 
 
 <h2 id="SYNOPSIS">SYNOPSIS</h2>
@@ -29,6 +30,7 @@ Updated: 03 January 2021
   [<b>-mapfile</b>=<i>map_file</i>]
   [<b>-view</b>=<i>coords</i>]
   [<b>-fill</b>=<i>color</i>]
+  [<b>-verbose</b>
   [<i>pam_file</i>]
 
 <p>You can abbreviate any option to its shortest unique prefix. You can use
@@ -41,8 +43,9 @@ from its value with whitespace instead of <code>=</code>.</p>
 <p>This program is part
 of <a href="http://netpbm.sourceforge.net/">Netpbm</a>.</p>
 
-<p><b>pamhomography</b> transforms a quadrilateral&mdash;not necessarily
-rectangular&mdash;region of an image, producing a new image.
+<p><b>pamhomography</b> stretches and shrinks an arbitrary quadrilateral
+portion of an input image you specify (not necessarily rectangular), into a
+new quadrilateral shape you specify, producing a new image.
 
 <p>You can do any
 <a href="https://en.wikipedia.org/wiki/Affine_transformation#Image_transformation">affine image transformation</a>: translation, reflection, scaling,
@@ -67,20 +70,18 @@ options:</p>
 <dd>
 
 <p>This defines the source quadrilateral. <i>coords</i> is a list of four
-  integer-valued (<i>x</i>, <i>y</i>) coordinates. If you do not
-  specify <b>-from</b>, the source quadrilateral is taken to be the four
-  corners of the input image in clockwise order, starting from the upper
-  left.</p>
+  integer-valued (<i>x</i>, <i>y</i>) coordinates. If you do not specify the
+  source with either <b>-from</b> or <b>-mapfile</b>, the source quadrilateral
+  is the entire input image.
 
 </dd>
 <dt><b>-to</b>=<i>coords</i></dt>
 <dd>
 
 <p>This defines the target quadrilateral. <i>coords</i> is a list of four
-integer-valued (<i>x</i>, <i>y</i>) coordinates. If you do not
-specify <b>-to</b>, the target quadrilateral is taken to be the four corners
-of the input image in clockwise order, starting from the upper left.</p>
-
+integer-valued (<i>x</i>, <i>y</i>) coordinates. If you do not specify the
+target with either <b>-to</b> or <b>-mapfile</b>, the target quadrilateral is
+the same as the entire input image.
 </dd>
 <dt><b>-mapfile</b>=<i>map_file</i></dt>
 <dd>
@@ -94,6 +95,9 @@ coordinates. In the latter case, the source quadrilateral is taken to be the
 four corners of the input image in clockwise order, starting from the upper
 left.</p>
 
+<p>Anything you specify with <b>-to</b> or <b>-from</b> overrides what is in
+  this file.
+
 </dd>
 <dt><b>-view</b>=<i>coords</i></dt>
 <dd>
@@ -116,18 +120,21 @@ argument of the pnm_parsecolor() library routine</a>.
 <p>The default is black, and for images with a transparency plane, transparent.
 
 </dd>
+
+<dt><b>-verbose</b>
+<dd>
+This makes the program issue some informational messages about what it is
+doing.
+
 </dl>
 
+
+
 <p>Cooordinates should normally be specified in clockwise order. The syntax is
 fairly flexible: all characters other than the plus sign, minus sign, and
 digits are treated as separators. Although coordinates need to be integers,
 they may lie outside the image's boundary.</p>
 
-<p>If you specify <b>-mapfile</b> along with <b>-from</b> and/or <b>-to</b>,
-<b>-from</b> and <b>-to</b> override the quadrilaterals specified
-by <i>map_file</i>.</p>
-
-
 <h2 id="PARAMETERS">PARAMETERS</h2>
 
 <p><b>pamhomography</b>'s only parameter, <i>pam_file</i>, is the name of the
diff --git a/pamrestack.html b/pamrestack.html
index 008eabbd..9d513cfa 100644
--- a/pamrestack.html
+++ b/pamrestack.html
@@ -91,11 +91,11 @@ Print information about the processing to Standard Error.
 <p><b>pamrestack</b> is a general editor with many possible uses.
 <ul>
   <li>
-    <b>pamrestack</b> can rearrange into rectangles single-dimention images
+    <b>pamrestack</b> can rearrange into rectangles single-dimension images
     produced by programs such as <b>ppmhist</b> and <b>pamseq</b>.  This makes
     the output easier to examine with a viewer.  Conversely, <b>pamrestack</b>
     can be used to convert a normal rectangular image into one wide row or one
-    tall column if that is desireable for compression, conversion, or analysis.
+    tall column if that is desirable for compression, conversion, or analysis.
 
   <li>
     <b>pamrestack</b> can repair images corrupted by an incorrect width value
@@ -147,6 +147,7 @@ pnmcat -leftright oddrows.ppm evenrows.ppm | pamrestack -width=600
 <b><a href="pamseq.html">pamseq</a></b>,
 <b><a href="ppmhist.html">ppmhist</a></b>,
 <b><a href="pnmshear.html">pnmshear</a></b>,
+<b><a href="pamscale.html">pamscale</a></b>,
 <b><a href="pamdeinterlace.html">pamdeinterlace</a></b>,
 <b><a href="pamdice.html">pamdice</a></b>,
 <b><a href="pamundice.html">pamundice</a></b>,
diff --git a/pamshuffle.html b/pamshuffle.html
index e6646b7f..5895e331 100644
--- a/pamshuffle.html
+++ b/pamshuffle.html
@@ -74,7 +74,7 @@ pixels.
 <p>Use this to ensure you get the same image on separate invocations.
 
 <p>By default, <b>pamshuffle</b> uses a seed derived from the time of day
-and process ID, which gives you fairly uncorrelated results in multiple
+and process ID, which gives you quite uncorrelated results in multiple
 invocations.
 </dl>
 
diff --git a/pnmshear.html b/pnmshear.html
index cfeaa149..0c384133 100644
--- a/pnmshear.html
+++ b/pnmshear.html
@@ -108,6 +108,7 @@ in the input, you also must consider the background color.  See the
 <a href="pamflip.html">pamflip</a>,
 <a href="pamhomography.html">pamhomography</a>,
 <a href="pnmquant.html">pnmquant</a>,
+<a href="pamrestack.html">pamrestack</a>,
 <a href="pnm.html">pnm</a>