summary refs log tree commit diff
diff options
context:
space:
mode:
authorgiraffedata <giraffedata@9d0c8265-081b-0410-96cb-a4ca84ce46f8>2021-12-25 19:59:15 +0000
committergiraffedata <giraffedata@9d0c8265-081b-0410-96cb-a4ca84ce46f8>2021-12-25 19:59:15 +0000
commit1feb4eb4d9783d530653f6e6ac8bc4264732501d (patch)
treee7aab65ab7e61039efd7d2e73b032f6a93d115dc
parente2cf136cedb87e91fea3ddb9f9a5ae01c1656bcb (diff)
downloadnetpbm-mirror-1feb4eb4d9783d530653f6e6ac8bc4264732501d.tar.gz
netpbm-mirror-1feb4eb4d9783d530653f6e6ac8bc4264732501d.tar.xz
netpbm-mirror-1feb4eb4d9783d530653f6e6ac8bc4264732501d.zip
miscellaneous update
git-svn-id: http://svn.code.sf.net/p/netpbm/code/userguide@4217 9d0c8265-081b-0410-96cb-a4ca84ce46f8
-rw-r--r--pamexec.html21
-rw-r--r--pnmpad.html14
2 files changed, 21 insertions, 14 deletions
diff --git a/pamexec.html b/pamexec.html
index 579a018a..95a432c1 100644
--- a/pamexec.html
+++ b/pamexec.html
@@ -2,7 +2,7 @@
 <html><head><title>Pamexec User Manual</title></head>
 <body>
 <h1>pamexec</h1>
-Updated: 11 August 2011
+Updated: 21 December 2021
 <br>
 <a href="#index">Table Of Contents</a>
 
@@ -35,13 +35,13 @@ Input (with a pipe).
 <p><i>netpbmfile</i> is the file name of the input file, or
 <b>-</b> to indicate Standard Input.  The default is Standard Input.
 
-<p>Many Netpbm programs understand multimage Netpbm streams themselves,
-so you don't need to use <b>pamexec</b> to run the program on the images
-in the stream.  Ideally, all Netpbm programs would have that capability,
-but multi-image streams are a relatively recent invention, so older Netpbm
-programs just process the first image in the stream and then stop.  Even
-recently written Netpbm programs work that way, since the authors aren't
-aware of the multi-image possibility.
+<p>Many Netpbm programs understand multimage Netpbm streams themselves, so you
+don't need to use <b>pamexec</b> to run the program on the images in the
+stream.  Ideally, all Netpbm programs would have that capability, but
+multi-image streams are a relatively recent invention, so older Netpbm
+programs just process the first image in the stream and then stop.  Even many
+recently written Netpbm programs work that way, since the authors aren't aware
+of the multi-image possibility.
 
 <p>Another way to process a multi-image stream is to use <b>pamsplit</b> to
 explode it into multiple files, one image per file.  You can then process
@@ -81,11 +81,12 @@ To make an animated GIF movie:
 
 <p><b>pamexec</b> assumes all commands consume all of Standard Input.
 If yours doesn't (perhaps it just exits when it's seen enough),
-you can buffer through a temporary file like this:
+  you can buffer through a temporary file like this, which copies the
+  first 3 lines of every image (the PPM header) to Standard Output:
 
 <pre>
 <kbd>
-    pamexec "cat &gt;/tmp/x; head -3 x" myvideo.ppm  
+    pamexec "cat &gt;/tmp/x; head --lines=3 x" myvideo.ppm  
 </kbd>
 </pre>
 
diff --git a/pnmpad.html b/pnmpad.html
index 7847a502..c48b55f5 100644
--- a/pnmpad.html
+++ b/pnmpad.html
@@ -2,7 +2,7 @@
 <html><head><title>Pnmpad User Manual</title></head>
 <body>
 <h1>pnmpad</h1>
-Updated: 05 October 2019
+Updated: 25 December 2021
 <br>
 <a href="#index">Table Of Contents</a>
 
@@ -123,13 +123,19 @@ between the left and right sides of the image to maintain the ratio the other
 options produce.  E.g. if you say <b>-left=10 -right=10 -mwidth=50</b> with a
 100-pixel image, you end up with a 150-pixel image with the extra padding
 split evenly between left and right for a total of 25 pixels of padding
-on the left and 25 on the right.
+on the left and 25 on the right.  If the other options indicate no
+padding, <b>pnmpad</b> adds padding in the ratio specified by <b>-halign</b>
+and if <b>-halign</b> is not specified, equally on both sides.
+
+<p>Before Netpbm 10.97 (December 2021), <b>pnmpad</b> does not allow
+<b>-halign</b> with <b>-mwidth</b> and adds padding only on the right
+when <b>-mwidth</b> is specified and the other options indicate no padding.
+  
+<p>Before Netpbm 10.72 (September 2015), there is no <b>-mwidth</b>.
 
 <p>Before Netpbm 10.23 (July 2004), <b>pnmpad</b> did not allow the
 <b>-left</b> or <b>-right</b> option together with <b>-width</b>.
 
-<p>Before Netpbm 10.72 (September 2015), there is no <b>-mwidth</b>.
-
 <dt><b>-top=</b><i>pixels</i>
 <dt><b>-bottom=</b><i>pixels</i>
 <dt><b>-height=</b><i>height</i>