SGML conversion.

diff --git a/imgsizer.xml b/imgsizer.xml
index eeb4ec77954b703ed21f791b00257bcb906eaf37..5b9b4863ec85ababf3ee8e862a07b8726b187740 100644 (file)
--- a/imgsizer.xml
+++ b/imgsizer.xml
@@ -1,94 +1,150 @@
-.TH IMGSIZER 1 "6 Sep 2001"
-.AT 3
-.SH NAME
-imgsizer \- automatically splice in height and width params for HTML IMG tags
-.SH SYNOPSIS
-.B imgsizer [OPTIONS] [HTML File]
-.PP
-.SH OPTIONS
-.TP
-.B \-V, \-\-version
-Display version information and exit.
-.TP
-.B \-h, \-\-help
-Display usage information.
-.TP
-.B \-d <directory>, \-\-document\-root <directory>
-Directory where aboslute image filenames (i.e, ones which contain
-a leading "/") may be found.
-.TP
-.B \-n, \-\-no-overwwrite
-.TP
-.SH DESCRIPTION
-The 
-.B imgsizer
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
+<!ENTITY % ISOnum PUBLIC "ISO 8879:1986//ENTITIES Numeric and Special Graphic//EN">
+%ISOnum;
+]>
+<refentry id='imgsizer.man'>
+<refmeta>
+<refentrytitle>imgsizer</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='date'>6 Sep 2001</refmiscinfo>
+</refmeta>
+<refnamediv id='name'>
+<refname>imgsizer</refname>
+<refpurpose>automatically splice in height and width params for HTML IMG tags</refpurpose>
+</refnamediv>
+<refsynopsisdiv id='synopsis'>
+
+<cmdsynopsis>
+  <!--  <command>imgsizer</command>  [ OPTIONS ]   [ HTML File ]  -->
+  <command>imgsizer</command>  <arg choice='opt'><replaceable>OPTIONS</replaceable></arg>
+  <arg choice='opt'><replaceable>HTMLFile</replaceable></arg>
+</cmdsynopsis>
+
+</refsynopsisdiv>
+
+<refsect1 id='options'><title>OPTIONS</title>
+<variablelist remap='TP'>
+<varlistentry>
+<term>
+<cmdsynopsis>
+  <arg choice='plain'>-V, </arg>
+  <arg choice='plain'>--version </arg>
+</cmdsynopsis>
+</term>
+<listitem>
+<para>Display version information and exit.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<cmdsynopsis>
+  <arg choice='plain'>-h, </arg>
+  <arg choice='plain'>--help </arg>
+</cmdsynopsis>
+</term>
+<listitem>
+<para>Display usage information.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<cmdsynopsis>
+  <arg choice='plain'>-d <replaceable>&lt;directory&gt;,</replaceable></arg>
+  <arg choice='plain'>--document-root <replaceable>&lt;directory&gt;</replaceable></arg>
+</cmdsynopsis>
+</term>
+<listitem>
+<para>Directory where aboslute image filenames (i.e, ones which contain
+a leading "/") may be found.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><emphasis remap='B'>-n, --no-overwwrite</emphasis></term>
+<term>
+.SH DESCRIPTION</term>
+<listitem>
+<para>The 
+<command>imgsizer</command>
 script automates away the tedious task of creating and updating the
 extension HEIGHT and WIDTH parameters in HTML IMG tags.  These
 parameters help many browsers (including Netscape) to multi-thread
 image loading, instead of having to load images in strict sequence in
 order to have each one's dimensions available so the next can be
 placed.  This generally allows text on the remainder of the page
-to load much faster.
-.PP
-This script will try create such attributes for any IMG tag that lacks
+to load much faster.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+
+<para>This script will try create such attributes for any IMG tag that lacks
 them.  It will correct existing HEIGHT and WIDTH tags unless either
-contains a percent (%) sign, in which case the existing dimensuions
-are presumed to be relative and left unaltered.
-.PP
-This script may be called with no arguments.  In this mode, it filters
+contains a percent (%) sign, in which case the existing dimensions
+are presumed to be relative and left unaltered.</para>
+
+<para>This script may be called with no arguments.  In this mode, it filters
 HTML presented on stdin to HTML (unaltered except for added or
 corrected HEIGHT and WIDTH attributes) on stdout.  If called with file
 arguments, it will attempt to transform each file in place.  Each
 argument file is not actually modified until the script completes a
-successful conversion pass.
-.PP
-The \-d <directory> option sets the DocumentRoot, which images with an
+successful conversion pass.</para>
+
+<para>The <option>-d</option> &lt;directory&gt; option sets the DocumentRoot, which images with an
 absolute filename (i.e., ones which contain a leading "/") may be found.
 If none is specified, the DocumentRoot defaults to the current working
-directory.
-.PP
-The \-n (no-overwrite) opion prevents the program from overwriting 
-existing width and height tags if both are present.
-.PP
-Additional options may also be specified in the environmental variable
-"IMGSIZER".  For example, to avoid typing "imgsizer -d /var/www/docs" each
-time imgsizer is invoked, you might tell sh (or one of its descendants):
-.PP
-.RS
-IMGSIZER="\-d /var/www/docs"; export IMGSIZER
-.RE
-.PP
-or, if you use csh:
-.PP
-.RS
-setenv IMGSIZER "\-d /var/www/docs"
-.RE
-.PP
-This script is written in Python, and thus requires a Python interpreter
+directory.</para>
+
+<para>The -n (no-overwrite) opion prevents the program from overwriting 
+existing width and height tags if both are present.</para>
+
+<para>Additional options may also be specified in the environmental variable
+"IMGSIZER".  For example, to avoid typing "imgsizer <option>-d</option> /var/www/docs" each
+time <command>imgsizer</command> is invoked, you might tell sh (or one of its descendants):</para>
+
+<para remap='RS'>
+IMGSIZER="-d /var/www/docs"; export IMGSIZER
+</para> <!-- RE -->
+
+<para>or, if you use csh:</para>
+
+<para remap='RS'>
+setenv IMGSIZER "-d /var/www/docs"
+</para> <!-- RE -->
+
+<para>This script is written in Python, and thus requires a Python interpreter
 on the host system.  It also requires either the 
-.IR identify (1)
+<citerefentry><refentrytitle>identify</refentrytitle><manvolnum>1</manvolnum></citerefentry>
 utility distributed in the open-source ImageMagick suite of image-display
 and manipulation tools, or a modern
 version of
-.IR file (1)
+<citerefentry><refentrytitle>file</refentrytitle><manvolnum>1</manvolnum></citerefentry>
 and 
-.IR rdjpgcom (1).
+<citerefentry><refentrytitle>rdjpgcom</refentrytitle><manvolnum>1</manvolnum></citerefentry>.
 These  utilities are used to extract sizes from the images;
-.B imgsizer
+<command>imgsizer</command>
 itself has no knowledge of graphics formats.  The script will handle any
 image format known to 
-.IR identify (1)
+<citerefentry><refentrytitle>identify</refentrytitle><manvolnum>1</manvolnum></citerefentry>
 including PNG, GIF, JPEG, XBM, XPM, PostScript, BMP, TIFF, and anything else
-even remotely likely to show up as an inline image.
-.PP
-.SH NOTE
-The -q, -l, and -m options of the 1.0 versions are gone.  What they
-used to do has been made unnecessary by smarter logic.
-.SH AUTHOR
-Originally created by Eric\ S.\ Raymond\ <esr@thyrsus.com>.  Additional code
-contributed by Erik\ Rossen and Michael\ C.\ Toren\ <michael@toren.net>.
-For updates, see <http://www.tuxedo.org/~esr>
-.SH SEE ALSO
-.IR identify (1),
-.IR file (1),
-.IR rdjpgcom(1).
+even remotely likely to show up as an inline image.</para>
+
+</refsect1>
+
+<refsect1 id='note'><title>NOTE</title>
+<para>The -q, -l, and -m options of the 1.0 versions are gone.  What they
+used to do has been made unnecessary by smarter logic.</para>
+</refsect1>
+
+<refsect1 id='author'><title>AUTHOR</title>
+<para>Originally created by Eric&nbsp;S.&nbsp;Raymond&nbsp;&lt;esr@thyrsus.com&gt;.  Additional code
+contributed by Erik&nbsp;Rossen and Michael&nbsp;C.&nbsp;Toren&nbsp;&lt;michael@toren.net&gt;.
+For updates, see &lt;<ulink url='http://www.tuxedo.org/~esr'>http://www.tuxedo.org/~esr</ulink>&gt;</para>
+</refsect1>
+
+<refsect1 id='see_also'><title>SEE ALSO</title>
+<para><citerefentry><refentrytitle>identify</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>file</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<emphasis remap='I'>rdjpgcom(1).</emphasis></para>
+</refsect1>
+</refentry>
+