summary refs log tree commit diff
path: root/pnmpad.html
diff options
context:
space:
mode:
authorgiraffedata <giraffedata@9d0c8265-081b-0410-96cb-a4ca84ce46f8>2023-11-26 19:57:02 +0000
committergiraffedata <giraffedata@9d0c8265-081b-0410-96cb-a4ca84ce46f8>2023-11-26 19:57:02 +0000
commitecf0ef4f0a678ec5b0c58d086417aaeb0f971148 (patch)
tree4de953a3f4c21561512b1cc75aee282a8f064236 /pnmpad.html
parent0d897de7695b764b2dabd18aab09776b42ee3ec3 (diff)
downloadnetpbm-mirror-ecf0ef4f0a678ec5b0c58d086417aaeb0f971148.tar.gz
netpbm-mirror-ecf0ef4f0a678ec5b0c58d086417aaeb0f971148.tar.xz
netpbm-mirror-ecf0ef4f0a678ec5b0c58d086417aaeb0f971148.zip
miscellaneous update
git-svn-id: http://svn.code.sf.net/p/netpbm/code/userguide@4787 9d0c8265-081b-0410-96cb-a4ca84ce46f8
Diffstat (limited to 'pnmpad.html')
-rw-r--r--pnmpad.html22
1 files changed, 16 insertions, 6 deletions
diff --git a/pnmpad.html b/pnmpad.html
index c48b55f5..f20f7fea 100644
--- a/pnmpad.html
+++ b/pnmpad.html
@@ -2,7 +2,7 @@
 <html><head><title>Pnmpad User Manual</title></head>
 <body>
 <h1>pnmpad</h1>
-Updated: 25 December 2021
+Updated: 14 November 2023
 <br>
 <a href="#index">Table Of Contents</a>
 
@@ -208,11 +208,21 @@ This causes verbose messages.
 
 <h2 id="history">HISTORY</h2>
 
-<p>Before February 2002, <b>pnmpad</b> had a different option syntax
-which was less expressive and not like conventional Netpbm programs.
-That syntax is still understood by <b>pnmpad</b> for backward
-compatibility, but not documented or supported for future use.
-
+<p>The command line syntax was originally more of a traditional Unix syntax,
+  with single-character margin size options <b>-l</b>, <b>-r</b>, <b>-t</b>,
+  and <b>-b</b> that took arguments concatenated to the option name, such
+  as <b>-l50</b>.  This is in contrast to the more modern syntax used by
+  essentially all Netpbm programs, in which an option such as <b>-left</b>
+  (which can still be abbreviated <b>-l</b>) must have its name and value as
+  separate command line arguments (e.g. <b>-l 50</b>).
+
+  The new syntax was accepted and the old syntax deprecated and removed from
+  documentation in Netpbm 9.25 (March 2002), and was no longer accepted in
+  Netpbm 11.05 (December 2023).
+
+  The code was broken for most of that time so that an attempt to use the old
+  syntax would fail anyway.  The bug was discovered only in testing; no user
+  ever reported encountering it.
 
 <h2 id="seealso">SEE ALSO</h2>