miscellaneous update

git-svn-id: http://svn.code.sf.net/p/netpbm/code/userguide@3897 9d0c8265-081b-0410-96cb-a4ca84ce46f8
author: giraffedata <giraffedata@9d0c8265-081b-0410-96cb-a4ca84ce46f8> 2020-07-19 22:02:52 +0000
committer: giraffedata <giraffedata@9d0c8265-081b-0410-96cb-a4ca84ce46f8> 2020-07-19 22:02:52 +0000
commit: fabc39e7f3bf78fbbc4e2923a0b9e53a829a9a26 (patch)
tree: 7ee41d7ab7ba81f235bb7bcb46018e91b44d6b0f /pnmpad.html
parent: 9fc68abf70747a4a4e78a3a43945b40a69de5d32 (diff)
download: netpbm-mirror-fabc39e7f3bf78fbbc4e2923a0b9e53a829a9a26.tar.gz
netpbm-mirror-fabc39e7f3bf78fbbc4e2923a0b9e53a829a9a26.tar.xz
netpbm-mirror-fabc39e7f3bf78fbbc4e2923a0b9e53a829a9a26.zip
1 files changed, 93 insertions, 88 deletions
diff --git a/pnmpad.html b/pnmpad.html
index 37acffa0..5b9208b4 100644
--- a/pnmpad.html
+++ b/pnmpad.html
@@ -1,50 +1,50 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN">
-<HTML><HEAD><TITLE>Pnmpad User Manual</TITLE></HEAD>
-<BODY>
-<H1>pnmpad</H1>
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.3//EN">
+<html><head><title>Pnmpad User Manual</title></head>
+<body>
+<h1>pnmpad</h1>
 Updated: 05 October 2019
-<BR>
-<A HREF="#index">Table Of Contents</A>
+<br>
+<a href="#index">Table Of Contents</a>
 
-<H2>NAME</H2>
+<h2>NAME</h2>
 
 pnmpad - add borders to a PNM image
 
-<H2 id="synopsis">SYNOPSIS</H2>
-
-<B>pnmpad </B>
-[<B>-white</B>|<B>-black</B>]
-<BR>
-[<B>-width=</B><I>pixels</I>]
-[<B>-halign=</B><I>ratio</I>]
-[<B>-mwidth=</B><I>pixels</I>]
-<BR>
-[<B>-left=</B><I>pixels</I>]
-[<B>-right=</B><I>pixels</I>]
-<BR>
-[<B>-height=</B><I>pixels</I>]
-[<B>-valign=</B><I>ratio</I>]
-[<B>-mheight=</B><I>pixels</I>]
-<BR>
-[<B>-top=</B><I>pixels</I>]
-[<B>-bottom=</B><I>pixels</I>]
-<BR>
+<h2 id="synopsis">SYNOPSIS</h2>
+
+<b>pnmpad </b>
+[<b>-white</b>|<b>-black</b>]
+<br>
+[<b>-width=</b><i>pixels</i>]
+[<b>-halign=</b><i>ratio</i>]
+[<b>-mwidth=</b><i>pixels</i>]
+<br>
+[<b>-left=</b><i>pixels</i>]
+[<b>-right=</b><i>pixels</i>]
+<br>
+[<b>-height=</b><i>pixels</i>]
+[<b>-valign=</b><i>ratio</i>]
+[<b>-mheight=</b><i>pixels</i>]
+<br>
+[<b>-top=</b><i>pixels</i>]
+[<b>-bottom=</b><i>pixels</i>]
+<br>
 [<b>-reportonly</b>]
-[<B>-verbose</B>]
-<BR>
-[<I>pnmfile</I>]
+[<b>-verbose</b>]
+<br>
+[<i>pnmfile</i>]
 
 
-<H2 id="description">DESCRIPTION</H2>
+<h2 id="description">DESCRIPTION</h2>
 
 <p>This program is part of <a href="index.html">Netpbm</a>.
 
-<P><b>pnmpad</b> reads a PNM image as input and outputs a PNM image
+<p><b>pnmpad</b> reads a PNM image as input and outputs a PNM image
 that is the input image plus black or white borders of the sizes
 specified.
 
-<P>If you just need to convert an image to a certain size regardless
-of the original dimensions, <B>pamcut</B> with the <B>-pad</B> option
+<p>If you just need to convert an image to a certain size regardless
+of the original dimensions, <b>pamcut</b> with the <b>-pad</b> option
 may be a better choice.
 
 <p><b>pnmmargin</b> does essentially the same thing, but allows you to
@@ -58,24 +58,29 @@ size.
   to insert your 100x100 image into the center of it.
   
 
-<H2 id="options">OPTIONS</H2>
+<h2 id="options">OPTIONS</h2>
 
-<P>All options can be abbreviated to their shortest unique prefix.  You
+<p>In addition to the options common to all programs based on libnetpbm
+(most notably <b>-quiet</b>, see <a href="index.html#commonoptions">
+Common Options</a>), <b>pnmpad</b> recognizes the following
+command line options:
+
+<p>All options can be abbreviated to their shortest unique prefix.  You
 may use two hyphens instead of one to designate an option.  You may
 use either white space or an equals sign between an option name and
 its value.
 
-<DL>
-<dt><B>-white</B>
-<dt><B>-black</B>
+<dl>
+<dt><b>-white</b>
+<dt><b>-black</b>
 
 <dd>Set pad color.  Default is <b>-black</b>.
 
-<dt><B>-left=</B><I>pixels</I>
-<dt><B>-right=</B><I>pixels</I>
-<dt><B>-width=</B><I>width</I>
-<dt><B>-halign=</B><I>ratio</I>
-<dt><B>-mwidth=</B><I>pixels</I>
+<dt><b>-left=</b><i>pixels</i>
+<dt><b>-right=</b><i>pixels</i>
+<dt><b>-width=</b><i>width</i>
+<dt><b>-halign=</b><i>ratio</i>
+<dt><b>-mwidth=</b><i>pixels</i>
 
 <dd>Specify amount of left and right padding in pixels.
 
@@ -102,13 +107,13 @@ already at least as wide as <b>-width</b> specifies, <b>pnmpad</b>
 adds no padding.
 
 <p>Common values for <b>-halign</b> are:
-<DL COMPACT>
-<DT><B>0.0</B> <DD>left aligned
+<dl compact>
+<dt><b>0.0</b> <dd>left aligned
 
-<DT><B>0.5</B> <DD>center aligned (default)
+<dt><b>0.5</b> <dd>center aligned (default)
 
-<DT><B>1.0</B> <DD>right aligned
-</DL>
+<dt><b>1.0</b> <dd>right aligned
+</dl>
 
 <p><b>-mwidth=</b><i>pixels</i> says to pad to a multiple of
 <i>pixels</i> pixels.  E.g. if <i>pixels</i> is 10, the output image width
@@ -125,11 +130,11 @@ on the left and 25 on the right.
 
 <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>
-<dt><B>-valign=</B><I>ratio</I>
-<dt><B>-mheight=</B><I>pixels</I>
+<dt><b>-top=</b><i>pixels</i>
+<dt><b>-bottom=</b><i>pixels</i>
+<dt><b>-height=</b><i>height</i>
+<dt><b>-valign=</b><i>ratio</i>
+<dt><b>-mheight=</b><i>pixels</i>
 
 <dd>
 These options determine the vertical padding.  They are analogous to the
@@ -144,20 +149,20 @@ horizontal padding options above.
 
 <p>This option was new in Netpbm 10.89 (December 2019).
 
-<DT><B>-verbose</B>
+<dt><b>-verbose</b>
 
-<DD>
+<dd>
 This causes verbose messages.
 
 </dl>
 
 <h2 id="reportonly">REPORT ONLY</h2>
 
-<p>When you specify <b>-reportonly</b>, <B>pnmpad</B> does not produce an
+<p>When you specify <b>-reportonly</b>, <b>pnmpad</b> does not produce an
   output image.  Instead, it writes to Standard Output a description of the
   padding it would have done without <b>-reportonly</b>.
 
-<P>That description is one line of text, containing 6 decimal numbers of
+<p>That description is one line of text, containing 6 decimal numbers of
   pixels, separated by spaces:
 
 <ol>
@@ -171,12 +176,12 @@ This causes verbose messages.
 
 <p>Example:
   <pre>
-    <tt>
+    <span style="font-family: monospace">
       4 3 0 2 100 100
-    </tt>
+    </span>
   </pre>
 
-<P>One use for this is to make padding which is fancier than the black and
+<p>One use for this is to make padding which is fancier than the black and
   white that <b>pnmpad</b> can do.
 
 <p>In the following example, we pad an image with 10 pixels of gray all
@@ -187,33 +192,33 @@ This causes verbose messages.
 <p>The example uses shell arrays, such as exist in Bash, but not Dash.
   
   <pre>
-    <tt>
+    <kbd>
       pad=($(pnmpad -reportonly -left=10 -right=10 -top=10 -bottom=10))
       pbmmake -gray 10 10 | pnmpaste input.ppm ${pad[0]} ${pad[2]} -
-    </tt>
+    </kbd>
   </pre>
     
 
-<H2 id="history">HISTORY</H2>
+<h2 id="history">HISTORY</h2>
 
-<p>Before February 2002, <B>pnmpad</B> had a different option syntax
+<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
+That syntax is still understood by <b>pnmpad</b> for backward
 compatibility, but not documented or supported for future use.
 
 
-<H2 id="seealso">SEE ALSO</H2>
+<h2 id="seealso">SEE ALSO</h2>
 
-<B><A HREF="pbmmake.html">pbmmake</A></B>,
-<B><A HREF="pnmpaste.html">pnmpaste</A></B>,
-<B><A HREF="pamcut.html">pamcut</A></B>,
-<B><A HREF="pnmcrop.html">pnmcrop</A></B>,
-<B><A HREF="pamcomp.html">pamcomp</A></B>,
-<B><A HREF="pnmmargin.html">pnmmargin</A></B>,
-<B><A HREF="pbm.html">pbm</A></B>
+<b><a href="pbmmake.html">pbmmake</a></b>,
+<b><a href="pnmpaste.html">pnmpaste</a></b>,
+<b><a href="pamcut.html">pamcut</a></b>,
+<b><a href="pnmcrop.html">pnmcrop</a></b>,
+<b><a href="pamcomp.html">pamcomp</a></b>,
+<b><a href="pnmmargin.html">pnmmargin</a></b>,
+<b><a href="pbm.html">pbm</a></b>
 
 
-<H2 id="author">AUTHOR</H2>
+<h2 id="author">AUTHOR</h2>
 
 <p>Copyright (C) 2002 by Martin van Beilen
 
@@ -221,23 +226,23 @@ compatibility, but not documented or supported for future use.
 
 <p>Copyright (C) 1989 by Jef Poskanzer.
 
-<P>Permission to use, copy, modify, and distribute this software and
+<p>Permission to use, copy, modify, and distribute this software and
 its documentation for any purpose and without fee is hereby granted,
 provided that the above copyright notice appear in all copies and that
 both that copyright notice and this permission notice appear in
 supporting documentation.  This software is provided "as is"
 without express or implied warranty.
 
-<HR>
-<H2 id="index">Table Of Contents</H2>
-<UL>
-<LI><A HREF="#synopsis">SYNOPSIS</A>
-<LI><A HREF="#description">DESCRIPTION</A>
-<LI><A HREF="#options">OPTIONS</A>
-<LI><A HREF="#reportonly">REPORT ONLY</A>
-<LI><A HREF="#history">HISTORY</A>
-<LI><A HREF="#seealso">SEE ALSO</A>
-<LI><A HREF="#author">AUTHOR</A>
-</UL>
-</BODY>
-</HTML>
+<hr>
+<h2 id="index">Table Of Contents</h2>
+<ul>
+<li><a href="#synopsis">SYNOPSIS</a>
+<li><a href="#description">DESCRIPTION</a>
+<li><a href="#options">OPTIONS</a>
+<li><a href="#reportonly">REPORT ONLY</a>
+<li><a href="#history">HISTORY</a>
+<li><a href="#seealso">SEE ALSO</a>
+<li><a href="#author">AUTHOR</a>
+</ul>
+</body>
+</html>
author	giraffedata <giraffedata@9d0c8265-081b-0410-96cb-a4ca84ce46f8>	2020-07-19 22:02:52 +0000
committer	giraffedata <giraffedata@9d0c8265-081b-0410-96cb-a4ca84ce46f8>	2020-07-19 22:02:52 +0000
commit	fabc39e7f3bf78fbbc4e2923a0b9e53a829a9a26 (patch)
tree	7ee41d7ab7ba81f235bb7bcb46018e91b44d6b0f /pnmpad.html
parent	9fc68abf70747a4a4e78a3a43945b40a69de5d32 (diff)
download	netpbm-mirror-fabc39e7f3bf78fbbc4e2923a0b9e53a829a9a26.tar.gz netpbm-mirror-fabc39e7f3bf78fbbc4e2923a0b9e53a829a9a26.tar.xz netpbm-mirror-fabc39e7f3bf78fbbc4e2923a0b9e53a829a9a26.zip