doc: Fix indentation in source XML files

2 files changed, 1319 insertions, 1319 deletions

diff --git a/doc/xmlcatalog.xml b/doc/xmlcatalog.xml
index 5d94b3b4..bfc51ac6 100644
--- a/doc/xmlcatalog.xml
+++ b/doc/xmlcatalog.xml
@@ -10,454 +10,454 @@
 <refentry>
 
 <refentryinfo>
-	<title>xmlcatalog Manual</title>
-	<productname>libxml2</productname>
-	<copyright>
-		<year>2001</year>
-		<year>2004</year>
-	</copyright>
-	<author>
-		<firstname>John</firstname>
-		<surname>Fleck</surname>
-		<affiliation>
-			<address>
-				<email>jfleck@inkstain.net</email>
-			</address>
-		</affiliation>
-	</author>
-	<!-- still a bit buggy output, will talk to docbook-xsl upstream to fix this -->
-	<!-- <releaseinfo>This is release 0.3 of the xmlcatalog Manual.</releaseinfo> -->
-	<!-- <edition>0.3</edition> -->
+    <title>xmlcatalog Manual</title>
+    <productname>libxml2</productname>
+    <copyright>
+        <year>2001</year>
+        <year>2004</year>
+    </copyright>
+    <author>
+        <firstname>John</firstname>
+        <surname>Fleck</surname>
+        <affiliation>
+            <address>
+                <email>jfleck@inkstain.net</email>
+            </address>
+        </affiliation>
+    </author>
+    <!-- still a bit buggy output, will talk to docbook-xsl upstream to fix this -->
+    <!-- <releaseinfo>This is release 0.3 of the xmlcatalog Manual.</releaseinfo> -->
+    <!-- <edition>0.3</edition> -->
 </refentryinfo>
 
 <refmeta>
-	<refentrytitle>xmlcatalog</refentrytitle>
-	<manvolnum>1</manvolnum>
+    <refentrytitle>xmlcatalog</refentrytitle>
+    <manvolnum>1</manvolnum>
 </refmeta>
 
 <refnamediv>
-	<refname>xmlcatalog</refname>
-	<refpurpose>
-		Command line tool to parse and manipulate <acronym>XML</acronym>
-		or <acronym>SGML</acronym> catalog files.
-	</refpurpose>
+    <refname>xmlcatalog</refname>
+    <refpurpose>
+        Command line tool to parse and manipulate <acronym>XML</acronym>
+        or <acronym>SGML</acronym> catalog files.
+    </refpurpose>
 </refnamediv>
 
 <refsynopsisdiv>
-	<cmdsynopsis>
-	<command>xmlcatalog</command>
-	<group choice="opt">
-		<arg choice="plain"><option>--sgml</option></arg>
-		<arg choice="plain"><option>--shell</option></arg>
-		<arg choice="plain"><option>--create</option></arg>
-		<arg choice="plain"><option>--del <replaceable>VALUE(S)</replaceable></option></arg>
-		<arg choice="plain">
-			<group choice="opt">
-				<arg choice="plain">
-					<option>--add
-					 <replaceable>TYPE</replaceable>
-					 <replaceable>ORIG</replaceable>
-					 <replaceable>REPLACE</replaceable>
-					</option>
-				</arg>
-				<arg choice="plain"><option>--add <replaceable>FILENAME</replaceable></option></arg>
-			</group>		
-		</arg>
-		<arg choice="plain"><option>--noout</option></arg>
-		<arg choice="plain"><option>--no-super-update</option></arg>
-		<arg choice="plain">
-			<group choice="opt">
-				<arg choice="plain"><option>-v</option></arg>
-				<arg choice="plain"><option>--verbose</option></arg>
-			</group>
-		</arg>
-	</group>
-	<arg choice="req" rep="norepeat"><replaceable>CATALOGFILE</replaceable></arg>
-	<arg choice="req" rep="repeat"><replaceable>ENTITIES</replaceable></arg>
-	</cmdsynopsis>
+    <cmdsynopsis>
+    <command>xmlcatalog</command>
+    <group choice="opt">
+        <arg choice="plain"><option>--sgml</option></arg>
+        <arg choice="plain"><option>--shell</option></arg>
+        <arg choice="plain"><option>--create</option></arg>
+        <arg choice="plain"><option>--del <replaceable>VALUE(S)</replaceable></option></arg>
+        <arg choice="plain">
+            <group choice="opt">
+                <arg choice="plain">
+                    <option>--add
+                     <replaceable>TYPE</replaceable>
+                     <replaceable>ORIG</replaceable>
+                     <replaceable>REPLACE</replaceable>
+                    </option>
+                </arg>
+                <arg choice="plain"><option>--add <replaceable>FILENAME</replaceable></option></arg>
+            </group>
+        </arg>
+        <arg choice="plain"><option>--noout</option></arg>
+        <arg choice="plain"><option>--no-super-update</option></arg>
+        <arg choice="plain">
+            <group choice="opt">
+                <arg choice="plain"><option>-v</option></arg>
+                <arg choice="plain"><option>--verbose</option></arg>
+            </group>
+        </arg>
+    </group>
+    <arg choice="req" rep="norepeat"><replaceable>CATALOGFILE</replaceable></arg>
+    <arg choice="req" rep="repeat"><replaceable>ENTITIES</replaceable></arg>
+    </cmdsynopsis>
 </refsynopsisdiv>
 
 <refsect1 id="description">
-	<title>DESCRIPTION</title>
-	<para>
-		&xmlcatalog; is a command line application allowing users to monitor and
-		manipulate <acronym>XML</acronym> and <acronym>SGML</acronym> catalogs. It
-		is included in <citerefentry>
-			<refentrytitle>libxml</refentrytitle>
-			<manvolnum>3</manvolnum>
-		</citerefentry>.
-	</para>
-	<para>
-		Its functions can be invoked from a single command from the command line,
-		or it can perform multiple functions in interactive mode. It can operate
-		on both <acronym>XML</acronym> and <acronym>SGML</acronym> files.
-	</para>
+    <title>DESCRIPTION</title>
+    <para>
+        &xmlcatalog; is a command line application allowing users to monitor and
+        manipulate <acronym>XML</acronym> and <acronym>SGML</acronym> catalogs. It
+        is included in <citerefentry>
+            <refentrytitle>libxml</refentrytitle>
+            <manvolnum>3</manvolnum>
+        </citerefentry>.
+    </para>
+    <para>
+        Its functions can be invoked from a single command from the command line,
+        or it can perform multiple functions in interactive mode. It can operate
+        on both <acronym>XML</acronym> and <acronym>SGML</acronym> files.
+    </para>
 </refsect1>
 
 <refsect1 id="options">
-	<title>OPTIONS</title>
-	<para>
-		&xmlcatalog; accepts the following options (in alphabetical order):
-	</para>
-	
-	<variablelist>
-
-		<varlistentry>
-	<term>
-		<option>--add
-		 <replaceable>TYPE</replaceable>
-		 <replaceable>ORIG</replaceable>
-		 <replaceable>REPLACE</replaceable>
-		</option>
-	</term>
-	<listitem>
-		<para>
-			Add an entry to <filename>CATALOGFILE</filename>. <replaceable>TYPE</replaceable>
-			indicates the type of entry. Possible types are: <simplelist type="inline">
-				<member><parameter>public</parameter></member>
-				<member><parameter>system</parameter></member>
-				<member><parameter>uri</parameter></member>
-				<member><parameter>rewriteSystem</parameter></member>
-				<member><parameter>rewriteURI</parameter></member>
-				<member><parameter>delegatePublic</parameter></member>
-				<member><parameter>delegateSystem</parameter></member>
-				<member><parameter>delegateURI</parameter></member>
-				<member><parameter>nextCatalog</parameter></member>
-			</simplelist>. <replaceable>ORIG</replaceable> is the original
-			reference to be replaced, and <replaceable>REPLACE</replaceable>
-			is the <acronym>URI</acronym> of the replacement entity to be
-			used. The <option>--add</option> option will not overwrite
-			<filename>CATALOGFILE</filename>, outputting
-			to <filename class="devicefile">stdout</filename>, unless
-			<option>--noout</option> is used. The <option>--add</option> will
-			always take three parameters even if some of the <acronym>XML</acronym>
-			catalog constructs will have only a single argument.
-		</para>
-		<!--
-			FIXME - Is my list of possible types correct? Are SGML types the same?
-		-->
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--add <replaceable>FILENAME</replaceable></option></term>
-	<listitem>
-		<para>
-			If the <option>--add</option> option is used following
-			the <option>--sgml</option> option, only a single argument,
-			a <replaceable>FILENAME</replaceable>, is used. This is used to add
-			the name of a catalog file to an <acronym>SGML</acronym> supercatalog,
-			a file that contains references to other included <acronym>SGML</acronym>
-			catalog files.
-		</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--create</option></term>
-	<listitem>
-		<para>
-			Create a new <acronym>XML</acronym> catalog. Outputs
-			to <filename class="devicefile">stdout</filename>,
-			ignoring <replaceable>filename</replaceable> unless <option>--noout</option> is
-			used, in which case it creates a new catalog
-			file <replaceable>filename</replaceable>.
-		</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--del <replaceable>VALUE(S)</replaceable></option></term>
-	<listitem>
-		<para>
-			Remove entries from <replaceable>CATALOGFILE</replaceable>
-			matching <replaceable>VALUE(S)</replaceable>. The <option>--del</option>
-			option will not overwrite <replaceable>CATALOGFILE</replaceable>,
-			outputting to <filename class="devicefile">stdout</filename>,
-			unless <option>--noout</option> is used.
-		</para>
-	</listitem>
-		</varlistentry>
-		
-		<varlistentry>
-	<term><option>--noout</option></term>
-	<listitem>
-		<para>
-			Save output to the named file rather than outputting
-			to <filename class="devicefile">stdout</filename>.
-		</para>
-	</listitem>
-		</varlistentry>
-		
-		<varlistentry>
-	<term><option>--no-super-update</option></term>
-	<listitem>
-		<para>
-			Do not update the <acronym>SGML</acronym> super catalog.
-		</para>
-	</listitem>
-		</varlistentry>
-		
-		<varlistentry>
-	<term><option>--shell</option></term>
-	<listitem>
-		<para>
-			Run a shell allowing interactive queries on catalog
-			file <replaceable>CATALOGFILE</replaceable>. For the set of available
-			commands see <xref linkend="shell"/>.
-		</para>
-	</listitem>
-		</varlistentry>
-		
-		<varlistentry>
-	<term><option>--sgml</option></term>
-	<listitem>
-		<para>
-			Uses <acronym>SGML</acronym> super catalogs for <option>--add</option>
-			and <option>--del</option> options.
-		</para>
-	</listitem>
-		</varlistentry>
-		
-		<varlistentry>
-	<term><option>-v</option></term>
-	<term><option>--verbose</option></term>
-	<listitem>
-		<para>Output debugging information.</para>
-	</listitem>
-		</varlistentry>
-	
-	</variablelist>
-
-	<para>
-		Invoking &xmlcatalog; non-interactively without a designated action
-		(imposed with options like <option>--add</option>) will result in a lookup
-		of the catalog entry for <replaceable>ENTITIES</replaceable> in the
-		catalog denoted with <replaceable>CATALOGFILE</replaceable>. The
-		corresponding entries will be output to the command line. This mode of
-		operation, together with <option>--shell</option> mode and non-modifying
-		(i.e. without <option>--noout</option>) direct actions, allows for
-		a special shortcut of the void <replaceable>CATALOGFILE</replaceable>
-		specification (possibly expressed as &quot;&quot; in the shell
-		environment) appointing the default system catalog. That simplifies the
-		handling when its exact location is irrelevant but the respective built-in
-		still needs to be consulted.
-	</para>
+    <title>OPTIONS</title>
+    <para>
+        &xmlcatalog; accepts the following options (in alphabetical order):
+    </para>
+
+    <variablelist>
+
+        <varlistentry>
+            <term>
+                <option>--add
+                 <replaceable>TYPE</replaceable>
+                 <replaceable>ORIG</replaceable>
+                 <replaceable>REPLACE</replaceable>
+                </option>
+            </term>
+            <listitem>
+                <para>
+                    Add an entry to <filename>CATALOGFILE</filename>. <replaceable>TYPE</replaceable>
+                    indicates the type of entry. Possible types are: <simplelist type="inline">
+                        <member><parameter>public</parameter></member>
+                        <member><parameter>system</parameter></member>
+                        <member><parameter>uri</parameter></member>
+                        <member><parameter>rewriteSystem</parameter></member>
+                        <member><parameter>rewriteURI</parameter></member>
+                        <member><parameter>delegatePublic</parameter></member>
+                        <member><parameter>delegateSystem</parameter></member>
+                        <member><parameter>delegateURI</parameter></member>
+                        <member><parameter>nextCatalog</parameter></member>
+                    </simplelist>. <replaceable>ORIG</replaceable> is the original
+                    reference to be replaced, and <replaceable>REPLACE</replaceable>
+                    is the <acronym>URI</acronym> of the replacement entity to be
+                    used. The <option>--add</option> option will not overwrite
+                    <filename>CATALOGFILE</filename>, outputting
+                    to <filename class="devicefile">stdout</filename>, unless
+                    <option>--noout</option> is used. The <option>--add</option> will
+                    always take three parameters even if some of the <acronym>XML</acronym>
+                    catalog constructs will have only a single argument.
+                </para>
+                <!--
+                    FIXME - Is my list of possible types correct? Are SGML types the same?
+                -->
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--add <replaceable>FILENAME</replaceable></option></term>
+            <listitem>
+                <para>
+                    If the <option>--add</option> option is used following
+                    the <option>--sgml</option> option, only a single argument,
+                    a <replaceable>FILENAME</replaceable>, is used. This is used to add
+                    the name of a catalog file to an <acronym>SGML</acronym> supercatalog,
+                    a file that contains references to other included <acronym>SGML</acronym>
+                    catalog files.
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--create</option></term>
+            <listitem>
+                <para>
+                    Create a new <acronym>XML</acronym> catalog. Outputs
+                    to <filename class="devicefile">stdout</filename>,
+                    ignoring <replaceable>filename</replaceable> unless <option>--noout</option> is
+                    used, in which case it creates a new catalog
+                    file <replaceable>filename</replaceable>.
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--del <replaceable>VALUE(S)</replaceable></option></term>
+            <listitem>
+                <para>
+                    Remove entries from <replaceable>CATALOGFILE</replaceable>
+                    matching <replaceable>VALUE(S)</replaceable>. The <option>--del</option>
+                    option will not overwrite <replaceable>CATALOGFILE</replaceable>,
+                    outputting to <filename class="devicefile">stdout</filename>,
+                    unless <option>--noout</option> is used.
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--noout</option></term>
+            <listitem>
+                <para>
+                    Save output to the named file rather than outputting
+                    to <filename class="devicefile">stdout</filename>.
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--no-super-update</option></term>
+            <listitem>
+                <para>
+                    Do not update the <acronym>SGML</acronym> super catalog.
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--shell</option></term>
+            <listitem>
+                <para>
+                    Run a shell allowing interactive queries on catalog
+                    file <replaceable>CATALOGFILE</replaceable>. For the set of available
+                    commands see <xref linkend="shell"/>.
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--sgml</option></term>
+            <listitem>
+                <para>
+                    Uses <acronym>SGML</acronym> super catalogs for <option>--add</option>
+                    and <option>--del</option> options.
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>-v</option></term>
+            <term><option>--verbose</option></term>
+            <listitem>
+                <para>Output debugging information.</para>
+            </listitem>
+        </varlistentry>
+
+    </variablelist>
+
+    <para>
+        Invoking &xmlcatalog; non-interactively without a designated action
+        (imposed with options like <option>--add</option>) will result in a lookup
+        of the catalog entry for <replaceable>ENTITIES</replaceable> in the
+        catalog denoted with <replaceable>CATALOGFILE</replaceable>. The
+        corresponding entries will be output to the command line. This mode of
+        operation, together with <option>--shell</option> mode and non-modifying
+        (i.e. without <option>--noout</option>) direct actions, allows for
+        a special shortcut of the void <replaceable>CATALOGFILE</replaceable>
+        specification (possibly expressed as &quot;&quot; in the shell
+        environment) appointing the default system catalog. That simplifies the
+        handling when its exact location is irrelevant but the respective built-in
+        still needs to be consulted.
+    </para>
 </refsect1>
 
 <refsect1 id="shell">
-	<title>SHELL COMMANDS</title>
-	<para>
-		Invoking &xmlcatalog; with
-		the <option>--shell <replaceable>CATALOGFILE</replaceable></option> option opens
-		a command line shell allowing interactive access to the catalog file
-		identified by <replaceable>CATALOGFILE</replaceable>. Invoking the shell
-		provides a command line prompt after which the following commands (described in
-		alphabetical order) can be entered.
-	</para>
-	
-	<variablelist>
-
-		<varlistentry>
-	<term>
-		<option>add
-		 <replaceable>TYPE</replaceable>
-		 <replaceable>ORIG</replaceable>
-		 <replaceable>REPLACE</replaceable>
-		</option>
-	</term>
-	<listitem>
-		<para>
-			Add an entry to the catalog file. <replaceable>TYPE</replaceable>
-			indicates the type of entry. Possible types are: <simplelist type="inline">
-				<member><parameter>public</parameter></member>
-				<member><parameter>system</parameter></member>
-				<member><parameter>uri</parameter></member>
-				<member><parameter>rewriteSystem</parameter></member>
-				<member><parameter>rewriteURI</parameter></member>
-				<member><parameter>delegatePublic</parameter></member>
-				<member><parameter>delegateSystem</parameter></member>
-				<member><parameter>delegateURI</parameter></member>
-				<member><parameter>nextCatalog</parameter></member>
-			</simplelist>. <replaceable>ORIG</replaceable> is the original
-			reference to be replaced, and <replaceable>REPLACE</replaceable>
-			is the <acronym>URI</acronym> of the replacement entity to be
-			used. The <option>--add</option> option will not overwrite
-			<filename>CATALOGFILE</filename>, outputting
-			to <filename class="devicefile">stdout</filename>, unless
-			<option>--noout</option> is used. The <option>--add</option> will
-			always take three parameters even if some of the <acronym>XML</acronym>
-			catalog constructs will have only a single argument.
-		</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>debug</option></term>
-	<listitem>
-		<para>
-			Print debugging statements showing the steps &xmlcatalog; is executing.
-		</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>del <replaceable>VALUE(S)</replaceable></option></term>
-	<listitem>
-		<para>
-			Remove the catalog entry corresponding to <replaceable>VALUE(S)</replaceable>.
-		</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>dump</option></term>
-	<listitem>
-		<para>Print the current catalog.</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>exit</option></term>
-	<listitem>
-		<para>Quit the shell.</para>
-	</listitem>
-		</varlistentry>
-	
-		<varlistentry>
-	<term><option>public <replaceable>PUBLIC-ID</replaceable></option></term>
-	<listitem>
-		<para>
-			Execute a Formal Public Identifier lookup of the catalog entry
-			for <replaceable>PUBLIC-ID</replaceable>. The corresponding entry will be
-			output to the command line.
-		</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>quiet</option></term>
-	<listitem>
-		<para>Stop printing debugging statements.</para>
-	</listitem>
-		</varlistentry>
-		
-		<varlistentry>
-	<term><option>system <replaceable>SYSTEM-ID</replaceable></option></term>
-	<listitem>
-		<para>
-			Execute a Formal Public Identifier lookup of the catalog entry
-			for <replaceable>SYSTEM-ID</replaceable>. The corresponding entry will be
-			output to the command line.
-		</para>
-	</listitem>
-		</varlistentry>
-
-	</variablelist>
+    <title>SHELL COMMANDS</title>
+    <para>
+        Invoking &xmlcatalog; with
+        the <option>--shell <replaceable>CATALOGFILE</replaceable></option> option opens
+        a command line shell allowing interactive access to the catalog file
+        identified by <replaceable>CATALOGFILE</replaceable>. Invoking the shell
+        provides a command line prompt after which the following commands (described in
+        alphabetical order) can be entered.
+    </para>
+
+    <variablelist>
+
+        <varlistentry>
+            <term>
+                <option>add
+                 <replaceable>TYPE</replaceable>
+                 <replaceable>ORIG</replaceable>
+                 <replaceable>REPLACE</replaceable>
+                </option>
+            </term>
+            <listitem>
+                <para>
+                    Add an entry to the catalog file. <replaceable>TYPE</replaceable>
+                    indicates the type of entry. Possible types are: <simplelist type="inline">
+                        <member><parameter>public</parameter></member>
+                        <member><parameter>system</parameter></member>
+                        <member><parameter>uri</parameter></member>
+                        <member><parameter>rewriteSystem</parameter></member>
+                        <member><parameter>rewriteURI</parameter></member>
+                        <member><parameter>delegatePublic</parameter></member>
+                        <member><parameter>delegateSystem</parameter></member>
+                        <member><parameter>delegateURI</parameter></member>
+                        <member><parameter>nextCatalog</parameter></member>
+                    </simplelist>. <replaceable>ORIG</replaceable> is the original
+                    reference to be replaced, and <replaceable>REPLACE</replaceable>
+                    is the <acronym>URI</acronym> of the replacement entity to be
+                    used. The <option>--add</option> option will not overwrite
+                    <filename>CATALOGFILE</filename>, outputting
+                    to <filename class="devicefile">stdout</filename>, unless
+                    <option>--noout</option> is used. The <option>--add</option> will
+                    always take three parameters even if some of the <acronym>XML</acronym>
+                    catalog constructs will have only a single argument.
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>debug</option></term>
+            <listitem>
+                <para>
+                    Print debugging statements showing the steps &xmlcatalog; is executing.
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>del <replaceable>VALUE(S)</replaceable></option></term>
+            <listitem>
+                <para>
+                    Remove the catalog entry corresponding to <replaceable>VALUE(S)</replaceable>.
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>dump</option></term>
+            <listitem>
+                <para>Print the current catalog.</para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>exit</option></term>
+            <listitem>
+                <para>Quit the shell.</para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>public <replaceable>PUBLIC-ID</replaceable></option></term>
+            <listitem>
+                <para>
+                    Execute a Formal Public Identifier lookup of the catalog entry
+                    for <replaceable>PUBLIC-ID</replaceable>. The corresponding entry will be
+                    output to the command line.
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>quiet</option></term>
+            <listitem>
+                <para>Stop printing debugging statements.</para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>system <replaceable>SYSTEM-ID</replaceable></option></term>
+            <listitem>
+                <para>
+                    Execute a Formal Public Identifier lookup of the catalog entry
+                    for <replaceable>SYSTEM-ID</replaceable>. The corresponding entry will be
+                    output to the command line.
+                </para>
+            </listitem>
+        </varlistentry>
+
+    </variablelist>
 </refsect1>
 
 <refsect1 id="environment">
-	<title>ENVIRONMENT</title>
-	<variablelist>
-
-		<varlistentry>
-	<term><envar>XML_CATALOG_FILES</envar></term>
-	<listitem>
-		<para><acronym>XML</acronym> catalog behavior can be changed by redirecting
-			queries to the user's own set of catalogs. This can be done by setting
-			the <envar>XML_CATALOG_FILES</envar> environment variable to a space-separated
-			list of catalogs. Use percent-encoding to escape spaces or other characters.
-			An empty variable should deactivate loading the default <filename>/etc/xml/catalog</filename> catalog.
-		</para>
-	</listitem>
-		</varlistentry>
-
-	</variablelist>	
+    <title>ENVIRONMENT</title>
+    <variablelist>
+
+        <varlistentry>
+            <term><envar>XML_CATALOG_FILES</envar></term>
+            <listitem>
+                <para><acronym>XML</acronym> catalog behavior can be changed by redirecting
+                    queries to the user's own set of catalogs. This can be done by setting
+                    the <envar>XML_CATALOG_FILES</envar> environment variable to a space-separated
+                    list of catalogs. Use percent-encoding to escape spaces or other characters.
+                    An empty variable should deactivate loading the default <filename>/etc/xml/catalog</filename> catalog.
+                </para>
+            </listitem>
+        </varlistentry>
+
+    </variablelist>
 </refsect1>
 
 <refsect1 id="diagnostics">
-	<title>DIAGNOSTICS</title>
-	<para>
-		&xmlcatalog; return codes provide information that can be used when
-		calling it from scripts.
-	</para>
-	<variablelist>
-
-		<varlistentry>
-	<term><errorcode>0</errorcode></term>
-	<listitem>
-		<para>No error</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><errorcode>1</errorcode></term>
-	<listitem>
-		<para>Failed to remove an entry from the catalog</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><errorcode>2</errorcode></term>
-	<listitem>
-		<para>Failed to save to the catalog, check file permissions</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><errorcode>3</errorcode></term>
-	<listitem>
-		<para>Failed to add an entry to the catalog</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><errorcode>4</errorcode></term>
-	<listitem>
-		<para>Failed to look up an entry in the catalog</para>
-	</listitem>
-		</varlistentry>
-
-	</variablelist>
+    <title>DIAGNOSTICS</title>
+    <para>
+        &xmlcatalog; return codes provide information that can be used when
+        calling it from scripts.
+    </para>
+    <variablelist>
+
+        <varlistentry>
+            <term><errorcode>0</errorcode></term>
+            <listitem>
+                <para>No error</para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><errorcode>1</errorcode></term>
+            <listitem>
+                <para>Failed to remove an entry from the catalog</para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><errorcode>2</errorcode></term>
+            <listitem>
+                <para>Failed to save to the catalog, check file permissions</para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><errorcode>3</errorcode></term>
+            <listitem>
+                <para>Failed to add an entry to the catalog</para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><errorcode>4</errorcode></term>
+            <listitem>
+                <para>Failed to look up an entry in the catalog</para>
+            </listitem>
+        </varlistentry>
+
+    </variablelist>
 </refsect1>
 
 <refsect1 id="seealso">
-	<title>SEE ALSO</title>
-	<para><citerefentry>
-			<refentrytitle>libxml</refentrytitle>
-			<manvolnum>3</manvolnum>
-		</citerefentry>
-	</para>
-	<para>
-		More information can be found at
-		<itemizedlist>
-			<listitem>
-				<para><citerefentry>
-						<refentrytitle>libxml</refentrytitle>
-						<manvolnum>3</manvolnum>
-					</citerefentry> web page <ulink url="https://gitlab.gnome.org/GNOME/libxml2"/>
-				</para>
-			</listitem>
-			<listitem>
-				<para><citerefentry>
-						<refentrytitle>libxml</refentrytitle>
-						<manvolnum>3</manvolnum>
-					</citerefentry> catalog support web page
-					at <ulink url="https://gitlab.gnome.org/GNOME/libxml2/-/wikis/Catalog-support"/>
-				</para>
-			</listitem>
-			<listitem>
-				<para>James Clark's <acronym>SGML</acronym> catalog
-					page <ulink url="http://www.jclark.com/sp/catalog.htm"/>
-				</para>
-			</listitem>
-			<listitem>
-				<para><acronym>OASIS</acronym> <acronym>XML</acronym> catalog specification
-					<ulink url="http://www.oasis-open.org/committees/entity/spec.html"/>
-				</para>
-			</listitem>
-		</itemizedlist>
-	</para>
+    <title>SEE ALSO</title>
+    <para><citerefentry>
+            <refentrytitle>libxml</refentrytitle>
+            <manvolnum>3</manvolnum>
+        </citerefentry>
+    </para>
+    <para>
+        More information can be found at
+        <itemizedlist>
+            <listitem>
+                <para><citerefentry>
+                        <refentrytitle>libxml</refentrytitle>
+                        <manvolnum>3</manvolnum>
+                    </citerefentry> web page <ulink url="https://gitlab.gnome.org/GNOME/libxml2"/>
+                </para>
+            </listitem>
+            <listitem>
+                <para><citerefentry>
+                        <refentrytitle>libxml</refentrytitle>
+                        <manvolnum>3</manvolnum>
+                    </citerefentry> catalog support web page
+                    at <ulink url="https://gitlab.gnome.org/GNOME/libxml2/-/wikis/Catalog-support"/>
+                </para>
+            </listitem>
+            <listitem>
+                <para>James Clark's <acronym>SGML</acronym> catalog
+                    page <ulink url="http://www.jclark.com/sp/catalog.htm"/>
+                </para>
+            </listitem>
+            <listitem>
+                <para><acronym>OASIS</acronym> <acronym>XML</acronym> catalog specification
+                    <ulink url="http://www.oasis-open.org/committees/entity/spec.html"/>
+                </para>
+            </listitem>
+        </itemizedlist>
+    </para>
 </refsect1>
 
 </refentry>
diff --git a/doc/xmllint.xml b/doc/xmllint.xml
index 2f5fe8ba..aa615110 100644
--- a/doc/xmllint.xml
+++ b/doc/xmllint.xml
@@ -3,937 +3,937 @@
    href="http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl"?>
 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
     "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
-    
+
     <!ENTITY xmllint "<command>xmllint</command>">
 ]>
 
 <refentry>
 
 <refentryinfo>
-	<title>xmllint Manual</title>
-	<productname>libxml2</productname>
-	<copyright>
-		<year>2001</year>
-		<year>2004</year>
-	</copyright>
-	<authorgroup>
-		<author>
-			<firstname>John</firstname>
-			<surname>Fleck</surname>
-			<affiliation>
-				<address>
-					<email>jfleck@inkstain.net</email>
-				</address>
-			</affiliation>
-		</author>
-		<author>
-			<firstname>Ziying</firstname>
-			<surname>Sherwin</surname>
-			<affiliation>
-				<address>
-					<email>sherwin@nlm.nih.gov</email>
-				</address>
-			</affiliation>
-		</author>
-		<author>
-			<firstname>Heiko</firstname>
-			<surname>Rupp</surname>
-			<affiliation>
-				<address>
-					<email>hwr@pilhuhn.de</email>
-				</address>
-			</affiliation>
-		</author>
-	</authorgroup>
-	<!-- still a bit buggy output, will talk to docbook-xsl upstream to fix this -->
-	<!-- <releaseinfo>This is release 0.5 of the xmllint Manual.</releaseinfo> -->
-	<!-- <edition>0.5</edition> -->
+    <title>xmllint Manual</title>
+    <productname>libxml2</productname>
+    <copyright>
+        <year>2001</year>
+        <year>2004</year>
+    </copyright>
+    <authorgroup>
+        <author>
+            <firstname>John</firstname>
+            <surname>Fleck</surname>
+            <affiliation>
+                <address>
+                    <email>jfleck@inkstain.net</email>
+                </address>
+            </affiliation>
+        </author>
+        <author>
+            <firstname>Ziying</firstname>
+            <surname>Sherwin</surname>
+            <affiliation>
+                <address>
+                    <email>sherwin@nlm.nih.gov</email>
+                </address>
+            </affiliation>
+        </author>
+        <author>
+            <firstname>Heiko</firstname>
+            <surname>Rupp</surname>
+            <affiliation>
+                <address>
+                    <email>hwr@pilhuhn.de</email>
+                </address>
+            </affiliation>
+        </author>
+    </authorgroup>
+    <!-- still a bit buggy output, will talk to docbook-xsl upstream to fix this -->
+    <!-- <releaseinfo>This is release 0.5 of the xmllint Manual.</releaseinfo> -->
+    <!-- <edition>0.5</edition> -->
 </refentryinfo>
 
 <refmeta>
-	<refentrytitle>xmllint</refentrytitle>
-	<manvolnum>1</manvolnum>
+    <refentrytitle>xmllint</refentrytitle>
+    <manvolnum>1</manvolnum>
 </refmeta>
 
 <refnamediv>
-	<refname>xmllint</refname>
-	<refpurpose>command line <acronym>XML</acronym> tool</refpurpose>
+    <refname>xmllint</refname>
+    <refpurpose>command line <acronym>XML</acronym> tool</refpurpose>
 </refnamediv>
 
 <refsynopsisdiv>
-	<cmdsynopsis>
-	<command>xmllint</command>
-		<group choice="opt">
-			<arg choice="plain"><option>--version</option></arg>
-			<arg choice="plain"><option>--debug</option></arg>
-			<arg choice="plain"><option>--quiet</option></arg>
-			<arg choice="plain"><option>--shell</option></arg>
-			<arg choice="plain"><option>--xpath "<replaceable class="option">XPath_expression</replaceable>"</option></arg>
-			<arg choice="plain"><option>--debugent</option></arg>
-			<arg choice="plain"><option>--copy</option></arg>
-			<arg choice="plain"><option>--recover</option></arg>
-			<arg choice="plain"><option>--noent</option></arg>
-			<arg choice="plain"><option>--noout</option></arg>
-			<arg choice="plain"><option>--nonet</option></arg>
-			<arg choice="plain"><option>--path "<replaceable class="option">PATH(S)</replaceable>"</option></arg>
-			<arg choice="plain"><option>--load-trace</option></arg>
-			<arg choice="plain"><option>--htmlout</option></arg>
-			<arg choice="plain"><option>--nowrap</option></arg>
-			<arg choice="plain"><option>--valid</option></arg>
-			<arg choice="plain"><option>--postvalid</option></arg>
-			<arg choice="plain"><option>--dtdvalid <replaceable class="option">URL</replaceable></option></arg>
-			<arg choice="plain"><option>--dtdvalidfpi <replaceable class="option">FPI</replaceable></option></arg>
-			<arg choice="plain"><option>--timing</option></arg>
-			<arg choice="plain"><option>--output <replaceable class="option">FILE</replaceable></option></arg>
-			<arg choice="plain"><option>--repeat</option></arg>
-			<arg choice="plain"><option>--insert</option></arg>
-			<arg choice="plain"><option>--compress</option></arg>
-			<arg choice="plain"><option>--html</option></arg>
-			<arg choice="plain"><option>--xmlout</option></arg>
-			<arg choice="plain"><option>--push</option></arg>
-			<arg choice="plain"><option>--memory</option></arg>
-			<arg choice="plain"><option>--maxmem <replaceable class="option">NBBYTES</replaceable></option></arg>
-			<arg choice="plain"><option>--nowarning</option></arg>
-			<arg choice="plain"><option>--noblanks</option></arg>
-			<arg choice="plain"><option>--nocdata</option></arg>
-			<arg choice="plain"><option>--format</option></arg>
-			<arg choice="plain"><option>--encode <replaceable class="option">ENCODING</replaceable></option></arg>
-			<arg choice="plain"><option>--dropdtd</option></arg>
-			<arg choice="plain"><option>--nsclean</option></arg>
-			<arg choice="plain"><option>--testIO</option></arg>
-			<arg choice="plain"><option>--catalogs</option></arg>
-			<arg choice="plain"><option>--nocatalogs</option></arg>
-			<arg choice="plain"><option>--auto</option></arg>
-			<arg choice="plain"><option>--xinclude</option></arg>
-			<arg choice="plain"><option>--noxincludenode</option></arg>
-			<arg choice="plain"><option>--loaddtd</option></arg>
-			<arg choice="plain"><option>--dtdattr</option></arg>
-			<arg choice="plain"><option>--stream</option></arg>
-			<arg choice="plain"><option>--walker</option></arg>
-			<arg choice="plain"><option>--pattern <replaceable class="option">PATTERNVALUE</replaceable></option></arg>
-			<arg choice="plain"><option>--chkregister</option></arg>
-			<arg choice="plain"><option>--relaxng <replaceable class="option">SCHEMA</replaceable></option></arg>
-			<arg choice="plain"><option>--schema <replaceable class="option">SCHEMA</replaceable></option></arg>
-			<arg choice="plain"><option>--c14n</option></arg>
-		</group>
-		<group choice="req">
-			<arg choice="plain" rep="repeat"><replaceable>XML-FILE(S)</replaceable></arg>
-			<arg choice="plain" rep="norepeat">-</arg>
-		</group>
-	</cmdsynopsis>
-	<cmdsynopsis>
-		<command>xmllint</command>
-		<arg choice="plain"><option>--help</option></arg>
-	</cmdsynopsis>
+    <cmdsynopsis>
+    <command>xmllint</command>
+        <group choice="opt">
+            <arg choice="plain"><option>--version</option></arg>
+            <arg choice="plain"><option>--debug</option></arg>
+            <arg choice="plain"><option>--quiet</option></arg>
+            <arg choice="plain"><option>--shell</option></arg>
+            <arg choice="plain"><option>--xpath "<replaceable class="option">XPath_expression</replaceable>"</option></arg>
+            <arg choice="plain"><option>--debugent</option></arg>
+            <arg choice="plain"><option>--copy</option></arg>
+            <arg choice="plain"><option>--recover</option></arg>
+            <arg choice="plain"><option>--noent</option></arg>
+            <arg choice="plain"><option>--noout</option></arg>
+            <arg choice="plain"><option>--nonet</option></arg>
+            <arg choice="plain"><option>--path "<replaceable class="option">PATH(S)</replaceable>"</option></arg>
+            <arg choice="plain"><option>--load-trace</option></arg>
+            <arg choice="plain"><option>--htmlout</option></arg>
+            <arg choice="plain"><option>--nowrap</option></arg>
+            <arg choice="plain"><option>--valid</option></arg>
+            <arg choice="plain"><option>--postvalid</option></arg>
+            <arg choice="plain"><option>--dtdvalid <replaceable class="option">URL</replaceable></option></arg>
+            <arg choice="plain"><option>--dtdvalidfpi <replaceable class="option">FPI</replaceable></option></arg>
+            <arg choice="plain"><option>--timing</option></arg>
+            <arg choice="plain"><option>--output <replaceable class="option">FILE</replaceable></option></arg>
+            <arg choice="plain"><option>--repeat</option></arg>
+            <arg choice="plain"><option>--insert</option></arg>
+            <arg choice="plain"><option>--compress</option></arg>
+            <arg choice="plain"><option>--html</option></arg>
+            <arg choice="plain"><option>--xmlout</option></arg>
+            <arg choice="plain"><option>--push</option></arg>
+            <arg choice="plain"><option>--memory</option></arg>
+            <arg choice="plain"><option>--maxmem <replaceable class="option">NBBYTES</replaceable></option></arg>
+            <arg choice="plain"><option>--nowarning</option></arg>
+            <arg choice="plain"><option>--noblanks</option></arg>
+            <arg choice="plain"><option>--nocdata</option></arg>
+            <arg choice="plain"><option>--format</option></arg>
+            <arg choice="plain"><option>--encode <replaceable class="option">ENCODING</replaceable></option></arg>
+            <arg choice="plain"><option>--dropdtd</option></arg>
+            <arg choice="plain"><option>--nsclean</option></arg>
+            <arg choice="plain"><option>--testIO</option></arg>
+            <arg choice="plain"><option>--catalogs</option></arg>
+            <arg choice="plain"><option>--nocatalogs</option></arg>
+            <arg choice="plain"><option>--auto</option></arg>
+            <arg choice="plain"><option>--xinclude</option></arg>
+            <arg choice="plain"><option>--noxincludenode</option></arg>
+            <arg choice="plain"><option>--loaddtd</option></arg>
+            <arg choice="plain"><option>--dtdattr</option></arg>
+            <arg choice="plain"><option>--stream</option></arg>
+            <arg choice="plain"><option>--walker</option></arg>
+            <arg choice="plain"><option>--pattern <replaceable class="option">PATTERNVALUE</replaceable></option></arg>
+            <arg choice="plain"><option>--chkregister</option></arg>
+            <arg choice="plain"><option>--relaxng <replaceable class="option">SCHEMA</replaceable></option></arg>
+            <arg choice="plain"><option>--schema <replaceable class="option">SCHEMA</replaceable></option></arg>
+            <arg choice="plain"><option>--c14n</option></arg>
+        </group>
+        <group choice="req">
+            <arg choice="plain" rep="repeat"><replaceable>XML-FILE(S)</replaceable></arg>
+            <arg choice="plain" rep="norepeat">-</arg>
+        </group>
+    </cmdsynopsis>
+    <cmdsynopsis>
+        <command>xmllint</command>
+        <arg choice="plain"><option>--help</option></arg>
+    </cmdsynopsis>
 </refsynopsisdiv>
 
 <refsect1 id="description">
-	<title>DESCRIPTION</title>
-	<para>
-		The &xmllint; program parses one or more <acronym>XML</acronym> files,
-		specified on the command line as <replaceable>XML-FILE</replaceable>
-		(or the standard input if the filename provided
-		is <emphasis role="bold">-</emphasis> ). It prints various types of
-		output, depending upon the options selected. It is useful for detecting
-		errors both in <acronym>XML</acronym> code and in
-		the <acronym>XML</acronym> parser itself.
-	</para>
-	<para>&xmllint; is included in <citerefentry>
-		<refentrytitle>libxml</refentrytitle>
-		<manvolnum>3</manvolnum>
-	</citerefentry>.</para>
+    <title>DESCRIPTION</title>
+    <para>
+        The &xmllint; program parses one or more <acronym>XML</acronym> files,
+        specified on the command line as <replaceable>XML-FILE</replaceable>
+        (or the standard input if the filename provided
+        is <emphasis role="bold">-</emphasis> ). It prints various types of
+        output, depending upon the options selected. It is useful for detecting
+        errors both in <acronym>XML</acronym> code and in
+        the <acronym>XML</acronym> parser itself.
+    </para>
+    <para>&xmllint; is included in <citerefentry>
+        <refentrytitle>libxml</refentrytitle>
+        <manvolnum>3</manvolnum>
+    </citerefentry>.</para>
 </refsect1>
 
 <refsect1 id="options">
-	<title>OPTIONS</title>
-	<para>
-		&xmllint; accepts the following options (in alphabetical order):
-	</para>
-
-	<variablelist>
-
-		<varlistentry>
-	<term><option>--auto</option></term>
-	<listitem>
-		<para>Generate a small document for testing purposes.</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--catalogs</option></term>
-	<listitem>
-		<para>
-			Use the <acronym>SGML</acronym> catalog(s) from <envar>SGML_CATALOG_FILES</envar>.
-			Otherwise <acronym>XML</acronym> catalogs starting
-			from <filename>/etc/xml/catalog</filename> are used by default.
-		</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--chkregister</option></term>
-	<listitem>
-		<para>
-			Turn on node registration. Useful for developers testing <citerefentry>
-		<refentrytitle>libxml</refentrytitle>
-		<manvolnum>3</manvolnum>
-	</citerefentry> node tracking code.
-		</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--compress</option></term>
-	<listitem>
-		<para>
-			Turn on <citerefentry>
-		<refentrytitle>gzip</refentrytitle>
-		<manvolnum>1</manvolnum>
-	</citerefentry> compression of output.
-		</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--copy</option></term>
-	<listitem>
-		<para>Test the internal copy implementation.</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--c14n</option></term>
-	<listitem>
-		<para>
-			Use the W3C <acronym>XML</acronym> Canonicalisation (<acronym>C14N</acronym>) to
-			serialize the result of parsing to <filename class="devicefile">stdout</filename>.
-			It keeps comments in the result.
-		</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--dtdvalid <replaceable class="option">URL</replaceable></option></term>
-	<listitem>
-		<para>
-			Use the <acronym>DTD</acronym> specified by
-			an <replaceable>URL</replaceable> for validation.
-		</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--dtdvalidfpi <replaceable class="option">FPI</replaceable></option></term>
-	<listitem>
-		<para>
-			Use the <acronym>DTD</acronym> specified by a Formal Public
-			Identifier <replaceable>FPI</replaceable> for validation, note that this
-			will require a catalog exporting that Formal Public Identifier to work.
-		</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--debug</option></term>
-	<listitem>
-		<para>
-			Parse a file and output an annotated tree of the
-			in-memory version of the document.
-		</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--debugent</option></term>
-	<listitem>
-		<para>Debug the entities defined in the document.</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--dropdtd</option></term>
-	<listitem>
-		<para>Remove <acronym>DTD</acronym> from output.</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--dtdattr</option></term>
-	<listitem>
-		<para>
-			Fetch external <acronym>DTD</acronym> and populate the tree with
-			inherited attributes.
-		</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--encode <replaceable class="option">ENCODING</replaceable></option></term>
-	<listitem>
-		<para>Output in the given encoding. Note that this works for full document not fragments or result from XPath queries.</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--format</option></term>
-	<listitem>
-		<para>
-			Reformat and reindent the output. The <envar>XMLLINT_INDENT</envar>
-			environment variable controls the indentation. The default value is two
-			spaces &quot;  &quot;).
-		</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--help</option></term>
-	<listitem>
-		<para>Print out a short usage summary for &xmllint;.</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--html</option></term>
-	<listitem>
-		<para>Use the <acronym>HTML</acronym> parser.</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--htmlout</option></term>
-	<listitem>
-		<para>
-			Output results as an <acronym>HTML</acronym> file. This
-			causes &xmllint; to output the necessary <acronym>HTML</acronym>
-			tags surrounding the result tree output so the results can be
-			displayed/viewed in a browser.
-		</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--insert</option></term>
-	<listitem>
-		<para>Test for valid insertions.</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--loaddtd</option></term>
-	<listitem>
-		<para>Fetch an external <acronym>DTD</acronym>.</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--load-trace</option></term>
-	<listitem>
-		<para>
-			Display all the documents loaded during the processing
-			to <filename class="devicefile">stderr</filename>.
-		</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--maxmem <replaceable class="option">NNBYTES</replaceable></option></term>
-	<listitem>
-		<para>
-			Test the parser memory support. <replaceable>NNBYTES</replaceable>
-			is the maximum number of bytes the library is allowed to allocate.
-			This can also be used to make sure batch processing
-			of <acronym>XML</acronym> files will not exhaust the virtual memory
-			of the server running them.
-		</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--memory</option></term>
-	<listitem>
-		<para>Parse from memory.</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--noblanks</option></term>
-	<listitem>
-		<para>Drop ignorable blank spaces.</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--nocatalogs</option></term>
-	<listitem>
-		<para>Do not use any catalogs.</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--nocdata</option></term>
-	<listitem>
-		<para>Substitute CDATA section by equivalent text nodes.</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--noent</option></term>
-	<listitem>
-		<para>
-			Substitute entity values for entity references. By default, &xmllint;
-			leaves entity references in place.
-		</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--nonet</option></term>
-	<listitem>
-		<para>
-			Do not use the Internet to fetch <acronym>DTD</acronym>s or entities.
-		</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--noout</option></term>
-	<listitem>
-		<para>
-			Suppress output. By default, &xmllint; outputs the result tree.
-		</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--nowarning</option></term>
-	<listitem>
-		<para>Do not emit warnings from the parser and/or validator.</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--nowrap</option></term>
-	<listitem>
-		<para>Do not output <acronym>HTML</acronym> doc wrapper.</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--noxincludenode</option></term>
-	<listitem>
-		<para>
-			Do XInclude processing but do not generate XInclude start and end nodes.
-		</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--nsclean</option></term>
-	<listitem>
-		<para>Remove redundant namespace declarations.</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--output <replaceable class="option">FILE</replaceable></option></term>
-	<listitem>
-		<para>
-			Define a file path where &xmllint; will save the result of parsing.
-			Usually the programs build a tree and save it
-			on <filename class="devicefile">stdout</filename>, with this option
-			the result <acronym>XML</acronym> instance will be saved onto a file.
-		</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--path "<replaceable class="option">PATH(S)</replaceable>"</option></term>
-	<listitem>
-		<para>
-			Use the (space- or colon-separated) list of filesystem paths specified
-			by <replaceable>PATHS</replaceable> to load <acronym>DTD</acronym>s or
-			entities. Enclose space-separated lists by quotation marks.
-		</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--pattern <replaceable class="option">PATTERNVALUE</replaceable></option></term>
-	<listitem>
-		<para>
-			Used to exercise the pattern recognition engine, which can be used
-			with the reader interface to the parser. It allows to select some
-			nodes in the document based on an XPath (subset) expression. Used
-			for debugging.
-		</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--postvalid</option></term>
-	<listitem>
-		<para>Validate after parsing has completed.</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--push</option></term>
-	<listitem>
-		<para>Use the push mode of the parser.</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--quiet</option></term>
-	<listitem>
-		<para>Don't print informational messages to stderr.</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--recover</option></term>
-	<listitem>
-		<para>Output any parsable portions of an invalid document.</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--relaxng <replaceable class="option">SCHEMA</replaceable></option></term>
-	<listitem>
-		<para>
-			Use RelaxNG file named <replaceable class="option">SCHEMA</replaceable>
-			for validation.
-		</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--repeat</option></term>
-	<listitem>
-		<para>Repeat 100 times, for timing or profiling.</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--schema <replaceable>SCHEMA</replaceable></option></term>
-	<listitem>
-		<para>
-			Use a W3C <acronym>XML</acronym> Schema file
-			named <replaceable>SCHEMA</replaceable> for validation.
-		</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--shell</option></term>
-	<listitem>
-		<para>
-			Run a navigating shell. Details on available commands in shell mode
-			are below (see <xref linkend="shell"/>).
-		</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--xpath "<replaceable class="option">XPath_expression</replaceable>"</option></term>
-	<listitem>
-		<para>
-			Run an XPath expression given as argument and print the
-			result. In case of a nodeset result, each node in the
-			node set is serialized in full in the output. In case
-			of an empty node set the "XPath set is empty" result
-			will be shown and an error exit code will be returned.
-		</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--stream</option></term>
-	<listitem>
-		<para>
-			Use streaming <acronym>API</acronym> - useful when used in combination
-			with <option>--relaxng</option> or <option>--valid</option> options
-			for validation of files that are too large to be held in memory.
-		</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--testIO</option></term>
-	<listitem>
-		<para>Test user input/output support.</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--timing</option></term>
-	<listitem>
-		<para>
-			Output information about the time it takes &xmllint; to perform the
-			various steps.
-		</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--valid</option></term>
-	<listitem>
-		<para>
-			Determine if the document is a valid instance of the included
-			Document Type Definition (<acronym>DTD</acronym>).
-			A <acronym>DTD</acronym> to be validated against also can be
-			specified at the command line using the <option>--dtdvalid</option>
-			option. By default, &xmllint; also checks to determine if the
-			document is well-formed.
-		</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--version</option></term>
-	<listitem>
-		<para>
-			Display the version of <citerefentry>
-		<refentrytitle>libxml</refentrytitle>
-		<manvolnum>3</manvolnum>
-	</citerefentry> used.
-		</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--walker</option></term>
-	<listitem>
-		<para>
-			Test the walker module, which is a reader interface but for a
-			document tree, instead of using the reader <acronym>API</acronym> on
-			an unparsed document it works on an existing in-memory tree. Used for
-			debugging.
-		</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--xinclude</option></term>
-	<listitem>
-		<para>Do XInclude processing.</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>--xmlout</option></term>
-	<listitem>
-		<para>
-			Used in conjunction with <option>--html</option>. Usually
-			when <acronym>HTML</acronym> is parsed the document is saved with
-			the <acronym>HTML</acronym> serializer. But with this option the
-			resulting document is saved with the <acronym>XML</acronym>
-			serializer. This is primarily used to
-			generate <acronym>XHTML</acronym> from <acronym>HTML</acronym> input.
-		</para>
-	</listitem>
-		</varlistentry>
-
-	</variablelist>
+    <title>OPTIONS</title>
+    <para>
+        &xmllint; accepts the following options (in alphabetical order):
+    </para>
+
+    <variablelist>
+
+        <varlistentry>
+            <term><option>--auto</option></term>
+            <listitem>
+                <para>Generate a small document for testing purposes.</para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--catalogs</option></term>
+            <listitem>
+                <para>
+                    Use the <acronym>SGML</acronym> catalog(s) from <envar>SGML_CATALOG_FILES</envar>.
+                    Otherwise <acronym>XML</acronym> catalogs starting
+                    from <filename>/etc/xml/catalog</filename> are used by default.
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--chkregister</option></term>
+            <listitem>
+                <para>
+                    Turn on node registration. Useful for developers testing <citerefentry>
+                <refentrytitle>libxml</refentrytitle>
+                <manvolnum>3</manvolnum>
+            </citerefentry> node tracking code.
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--compress</option></term>
+            <listitem>
+                <para>
+                    Turn on <citerefentry>
+                <refentrytitle>gzip</refentrytitle>
+                <manvolnum>1</manvolnum>
+            </citerefentry> compression of output.
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--copy</option></term>
+            <listitem>
+                <para>Test the internal copy implementation.</para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--c14n</option></term>
+            <listitem>
+                <para>
+                    Use the W3C <acronym>XML</acronym> Canonicalisation (<acronym>C14N</acronym>) to
+                    serialize the result of parsing to <filename class="devicefile">stdout</filename>.
+                    It keeps comments in the result.
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--dtdvalid <replaceable class="option">URL</replaceable></option></term>
+            <listitem>
+                <para>
+                    Use the <acronym>DTD</acronym> specified by
+                    an <replaceable>URL</replaceable> for validation.
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--dtdvalidfpi <replaceable class="option">FPI</replaceable></option></term>
+            <listitem>
+                <para>
+                    Use the <acronym>DTD</acronym> specified by a Formal Public
+                    Identifier <replaceable>FPI</replaceable> for validation, note that this
+                    will require a catalog exporting that Formal Public Identifier to work.
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--debug</option></term>
+            <listitem>
+                <para>
+                    Parse a file and output an annotated tree of the
+                    in-memory version of the document.
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--debugent</option></term>
+            <listitem>
+                <para>Debug the entities defined in the document.</para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--dropdtd</option></term>
+            <listitem>
+                <para>Remove <acronym>DTD</acronym> from output.</para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--dtdattr</option></term>
+            <listitem>
+                <para>
+                    Fetch external <acronym>DTD</acronym> and populate the tree with
+                    inherited attributes.
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--encode <replaceable class="option">ENCODING</replaceable></option></term>
+            <listitem>
+                <para>Output in the given encoding. Note that this works for full document not fragments or result from XPath queries.</para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--format</option></term>
+            <listitem>
+                <para>
+                    Reformat and reindent the output. The <envar>XMLLINT_INDENT</envar>
+                    environment variable controls the indentation. The default value is two
+                    spaces &quot;  &quot;).
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--help</option></term>
+            <listitem>
+                <para>Print out a short usage summary for &xmllint;.</para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--html</option></term>
+            <listitem>
+                <para>Use the <acronym>HTML</acronym> parser.</para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--htmlout</option></term>
+            <listitem>
+                <para>
+                    Output results as an <acronym>HTML</acronym> file. This
+                    causes &xmllint; to output the necessary <acronym>HTML</acronym>
+                    tags surrounding the result tree output so the results can be
+                    displayed/viewed in a browser.
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--insert</option></term>
+            <listitem>
+                <para>Test for valid insertions.</para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--loaddtd</option></term>
+            <listitem>
+                <para>Fetch an external <acronym>DTD</acronym>.</para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--load-trace</option></term>
+            <listitem>
+                <para>
+                    Display all the documents loaded during the processing
+                    to <filename class="devicefile">stderr</filename>.
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--maxmem <replaceable class="option">NNBYTES</replaceable></option></term>
+            <listitem>
+                <para>
+                    Test the parser memory support. <replaceable>NNBYTES</replaceable>
+                    is the maximum number of bytes the library is allowed to allocate.
+                    This can also be used to make sure batch processing
+                    of <acronym>XML</acronym> files will not exhaust the virtual memory
+                    of the server running them.
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--memory</option></term>
+            <listitem>
+                <para>Parse from memory.</para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--noblanks</option></term>
+            <listitem>
+                <para>Drop ignorable blank spaces.</para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--nocatalogs</option></term>
+            <listitem>
+                <para>Do not use any catalogs.</para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--nocdata</option></term>
+            <listitem>
+                <para>Substitute CDATA section by equivalent text nodes.</para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--noent</option></term>
+            <listitem>
+                <para>
+                    Substitute entity values for entity references. By default, &xmllint;
+                    leaves entity references in place.
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--nonet</option></term>
+            <listitem>
+                <para>
+                    Do not use the Internet to fetch <acronym>DTD</acronym>s or entities.
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--noout</option></term>
+            <listitem>
+                <para>
+                    Suppress output. By default, &xmllint; outputs the result tree.
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--nowarning</option></term>
+            <listitem>
+                <para>Do not emit warnings from the parser and/or validator.</para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--nowrap</option></term>
+            <listitem>
+                <para>Do not output <acronym>HTML</acronym> doc wrapper.</para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--noxincludenode</option></term>
+            <listitem>
+                <para>
+                    Do XInclude processing but do not generate XInclude start and end nodes.
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--nsclean</option></term>
+            <listitem>
+                <para>Remove redundant namespace declarations.</para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--output <replaceable class="option">FILE</replaceable></option></term>
+            <listitem>
+                <para>
+                    Define a file path where &xmllint; will save the result of parsing.
+                    Usually the programs build a tree and save it
+                    on <filename class="devicefile">stdout</filename>, with this option
+                    the result <acronym>XML</acronym> instance will be saved onto a file.
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--path "<replaceable class="option">PATH(S)</replaceable>"</option></term>
+            <listitem>
+                <para>
+                    Use the (space- or colon-separated) list of filesystem paths specified
+                    by <replaceable>PATHS</replaceable> to load <acronym>DTD</acronym>s or
+                    entities. Enclose space-separated lists by quotation marks.
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--pattern <replaceable class="option">PATTERNVALUE</replaceable></option></term>
+            <listitem>
+                <para>
+                    Used to exercise the pattern recognition engine, which can be used
+                    with the reader interface to the parser. It allows to select some
+                    nodes in the document based on an XPath (subset) expression. Used
+                    for debugging.
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--postvalid</option></term>
+            <listitem>
+                <para>Validate after parsing has completed.</para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--push</option></term>
+            <listitem>
+                <para>Use the push mode of the parser.</para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--quiet</option></term>
+            <listitem>
+                <para>Don't print informational messages to stderr.</para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--recover</option></term>
+            <listitem>
+                <para>Output any parsable portions of an invalid document.</para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--relaxng <replaceable class="option">SCHEMA</replaceable></option></term>
+            <listitem>
+                <para>
+                    Use RelaxNG file named <replaceable class="option">SCHEMA</replaceable>
+                    for validation.
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--repeat</option></term>
+            <listitem>
+                <para>Repeat 100 times, for timing or profiling.</para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--schema <replaceable>SCHEMA</replaceable></option></term>
+            <listitem>
+                <para>
+                    Use a W3C <acronym>XML</acronym> Schema file
+                    named <replaceable>SCHEMA</replaceable> for validation.
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--shell</option></term>
+            <listitem>
+                <para>
+                    Run a navigating shell. Details on available commands in shell mode
+                    are below (see <xref linkend="shell"/>).
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--xpath "<replaceable class="option">XPath_expression</replaceable>"</option></term>
+            <listitem>
+                <para>
+                    Run an XPath expression given as argument and print the
+                    result. In case of a nodeset result, each node in the
+                    node set is serialized in full in the output. In case
+                    of an empty node set the "XPath set is empty" result
+                    will be shown and an error exit code will be returned.
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--stream</option></term>
+            <listitem>
+                <para>
+                    Use streaming <acronym>API</acronym> - useful when used in combination
+                    with <option>--relaxng</option> or <option>--valid</option> options
+                    for validation of files that are too large to be held in memory.
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--testIO</option></term>
+            <listitem>
+                <para>Test user input/output support.</para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--timing</option></term>
+            <listitem>
+                <para>
+                    Output information about the time it takes &xmllint; to perform the
+                    various steps.
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--valid</option></term>
+            <listitem>
+                <para>
+                    Determine if the document is a valid instance of the included
+                    Document Type Definition (<acronym>DTD</acronym>).
+                    A <acronym>DTD</acronym> to be validated against also can be
+                    specified at the command line using the <option>--dtdvalid</option>
+                    option. By default, &xmllint; also checks to determine if the
+                    document is well-formed.
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--version</option></term>
+            <listitem>
+                <para>
+                    Display the version of <citerefentry>
+                <refentrytitle>libxml</refentrytitle>
+                <manvolnum>3</manvolnum>
+            </citerefentry> used.
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--walker</option></term>
+            <listitem>
+                <para>
+                    Test the walker module, which is a reader interface but for a
+                    document tree, instead of using the reader <acronym>API</acronym> on
+                    an unparsed document it works on an existing in-memory tree. Used for
+                    debugging.
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--xinclude</option></term>
+            <listitem>
+                <para>Do XInclude processing.</para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>--xmlout</option></term>
+            <listitem>
+                <para>
+                    Used in conjunction with <option>--html</option>. Usually
+                    when <acronym>HTML</acronym> is parsed the document is saved with
+                    the <acronym>HTML</acronym> serializer. But with this option the
+                    resulting document is saved with the <acronym>XML</acronym>
+                    serializer. This is primarily used to
+                    generate <acronym>XHTML</acronym> from <acronym>HTML</acronym> input.
+                </para>
+            </listitem>
+        </varlistentry>
+
+    </variablelist>
 </refsect1>
 
 <refsect1 id="shell">
-	<title>SHELL COMMANDS</title>
-	<para>
-		&xmllint; offers an interactive shell mode invoked with
-		the <option>--shell</option> command. Available commands in shell mode
-		include (in alphabetical order):
-	</para>
-	<variablelist>
-
-		<varlistentry>
-	<term><command>base</command></term>
-	<listitem>
-		<para>Display <acronym>XML</acronym> base of the node.</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><command>bye</command></term>
-	<listitem>
-		<para>Leave the shell.</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><command>cat <replaceable>NODE</replaceable></command></term>
-	<listitem>
-		<para>Display the given node or the current one.</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><command>cd <replaceable>PATH</replaceable></command></term>
-	<listitem>
-		<para>
-			Change the current node to the given path (if unique) or root if no
-			argument is given.
-		</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><command>dir <replaceable>PATH</replaceable></command></term>
-	<listitem>
-		<para>
-			Dumps information about the node (namespace, attributes, content).
-		</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><command>du <replaceable>PATH</replaceable></command></term>
-	<listitem>
-		<para>
-			Show the structure of the subtree under the given path or the current node.
-		</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><command>exit</command></term>
-	<listitem>
-		<para>Leave the shell.</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><command>help</command></term>
-	<listitem>
-		<para>Show this help.</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><command>free</command></term>
-	<listitem>
-		<para>Display memory usage.</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><command>load <replaceable>FILENAME</replaceable></command></term>
-	<listitem>
-		<para>Load a new document with the given filename.</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><command>ls <replaceable>PATH</replaceable></command></term>
-	<listitem>
-		<para>List contents of the given path or the current directory.</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><command>pwd</command></term>
-	<listitem>
-		<para>Display the path to the current node.</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><command>quit</command></term>
-	<listitem>
-		<para>Leave the shell.</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><command>save <replaceable>FILENAME</replaceable></command></term>
-	<listitem>
-		<para>
-			Save the current document to the given filename or to the original name.
-		</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><option>validate</option></term>
-	<listitem>
-		<para>Check the document for errors.</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><command>write <replaceable>FILENAME</replaceable></command></term>
-	<listitem>
-		<para>Write the current node to the given filename.</para>
-	</listitem>
-		</varlistentry>
-
-	</variablelist>
+    <title>SHELL COMMANDS</title>
+    <para>
+        &xmllint; offers an interactive shell mode invoked with
+        the <option>--shell</option> command. Available commands in shell mode
+        include (in alphabetical order):
+    </para>
+    <variablelist>
+
+        <varlistentry>
+            <term><command>base</command></term>
+            <listitem>
+                <para>Display <acronym>XML</acronym> base of the node.</para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><command>bye</command></term>
+            <listitem>
+                <para>Leave the shell.</para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><command>cat <replaceable>NODE</replaceable></command></term>
+            <listitem>
+                <para>Display the given node or the current one.</para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><command>cd <replaceable>PATH</replaceable></command></term>
+            <listitem>
+                <para>
+                    Change the current node to the given path (if unique) or root if no
+                    argument is given.
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><command>dir <replaceable>PATH</replaceable></command></term>
+            <listitem>
+                <para>
+                    Dumps information about the node (namespace, attributes, content).
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><command>du <replaceable>PATH</replaceable></command></term>
+            <listitem>
+                <para>
+                    Show the structure of the subtree under the given path or the current node.
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><command>exit</command></term>
+            <listitem>
+                <para>Leave the shell.</para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><command>help</command></term>
+            <listitem>
+                <para>Show this help.</para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><command>free</command></term>
+            <listitem>
+                <para>Display memory usage.</para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><command>load <replaceable>FILENAME</replaceable></command></term>
+            <listitem>
+                <para>Load a new document with the given filename.</para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><command>ls <replaceable>PATH</replaceable></command></term>
+            <listitem>
+                <para>List contents of the given path or the current directory.</para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><command>pwd</command></term>
+            <listitem>
+                <para>Display the path to the current node.</para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><command>quit</command></term>
+            <listitem>
+                <para>Leave the shell.</para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><command>save <replaceable>FILENAME</replaceable></command></term>
+            <listitem>
+                <para>
+                    Save the current document to the given filename or to the original name.
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><option>validate</option></term>
+            <listitem>
+                <para>Check the document for errors.</para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><command>write <replaceable>FILENAME</replaceable></command></term>
+            <listitem>
+                <para>Write the current node to the given filename.</para>
+            </listitem>
+        </varlistentry>
+
+    </variablelist>
 </refsect1>
 
 <refsect1 id="environment">
-	<title>ENVIRONMENT</title>
-	<variablelist>
-
-		<varlistentry>
-	<term><envar>SGML_CATALOG_FILES</envar></term>
-	<listitem>
-		<para><acronym>SGML</acronym> catalog behavior can be changed by redirecting
-			queries to the user's own set of catalogs. This can be done by setting
-			the <envar>SGML_CATALOG_FILES</envar> environment variable to a list
-			of catalogs. An empty one should deactivate loading the
-			default <filename>/etc/sgml/catalog</filename> catalog.
-		</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><envar>XML_CATALOG_FILES</envar></term>
-	<listitem>
-		<para><acronym>XML</acronym> catalog behavior can be changed by redirecting
-			queries to the user's own set of catalogs. This can be done by setting
-			the <envar>XML_CATALOG_FILES</envar> environment variable to a space-separated
-			list of catalogs. Use percent-encoding to escape spaces or other characters.
-			An empty variable should deactivate loading the default <filename>/etc/xml/catalog</filename> catalog.
-		</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><envar>XML_DEBUG_CATALOG</envar></term>
-	<listitem>
-		<para>Setting the environment variable <envar>XML_DEBUG_CATALOG</envar>
-			to <parameter>non-zero</parameter> using the <command>export</command>
-			command outputs debugging information related to catalog operations.
-		</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><envar>XMLLINT_INDENT</envar></term>
-	<listitem>
-		<para>Setting the environment variable <envar>XMLLINT_INDENT</envar>
-			controls the indentation. The default value is two spaces &quot;  &quot;.
-		</para>
-	</listitem>
-		</varlistentry>
-		
-	</variablelist>
+    <title>ENVIRONMENT</title>
+    <variablelist>
+
+        <varlistentry>
+            <term><envar>SGML_CATALOG_FILES</envar></term>
+            <listitem>
+                <para><acronym>SGML</acronym> catalog behavior can be changed by redirecting
+                    queries to the user's own set of catalogs. This can be done by setting
+                    the <envar>SGML_CATALOG_FILES</envar> environment variable to a list
+                    of catalogs. An empty one should deactivate loading the
+                    default <filename>/etc/sgml/catalog</filename> catalog.
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><envar>XML_CATALOG_FILES</envar></term>
+            <listitem>
+                <para><acronym>XML</acronym> catalog behavior can be changed by redirecting
+                    queries to the user's own set of catalogs. This can be done by setting
+                    the <envar>XML_CATALOG_FILES</envar> environment variable to a space-separated
+                    list of catalogs. Use percent-encoding to escape spaces or other characters.
+                    An empty variable should deactivate loading the default <filename>/etc/xml/catalog</filename> catalog.
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><envar>XML_DEBUG_CATALOG</envar></term>
+            <listitem>
+                <para>Setting the environment variable <envar>XML_DEBUG_CATALOG</envar>
+                    to <parameter>non-zero</parameter> using the <command>export</command>
+                    command outputs debugging information related to catalog operations.
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><envar>XMLLINT_INDENT</envar></term>
+            <listitem>
+                <para>Setting the environment variable <envar>XMLLINT_INDENT</envar>
+                    controls the indentation. The default value is two spaces &quot;  &quot;.
+                </para>
+            </listitem>
+        </varlistentry>
+
+    </variablelist>
 </refsect1>
 
 <refsect1 id="diagnostics">
-	<title>DIAGNOSTICS</title>
-	<para>
-		&xmllint; return codes provide information that can be used when
-		calling it from scripts.
-	</para>
-	<!-- better use segmentedlist element later,
-	     which is currently only supported in snapshots -->
-	<variablelist>
-
-		<varlistentry>
-	<term><errorcode>0</errorcode></term>
-	<listitem>
-		<para>No error</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><errorcode>1</errorcode></term>
-	<listitem>
-		<para>Unclassified</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><errorcode>2</errorcode></term>
-	<listitem>
-		<para>Error in <acronym>DTD</acronym></para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><errorcode>3</errorcode></term>
-	<listitem>
-		<para>Validation error</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><errorcode>4</errorcode></term>
-	<listitem>
-		<para>Validation error</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><errorcode>5</errorcode></term>
-	<listitem>
-		<para>Error in schema compilation</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><errorcode>6</errorcode></term>
-	<listitem>
-		<para>Error writing output</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><errorcode>7</errorcode></term>
-	<listitem>
-		<para>
-			Error in pattern (generated when <option>--pattern</option> option is used)
-		</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><errorcode>8</errorcode></term>
-	<listitem>
-		<para>
-			Error in Reader registration (generated
-			when <option>--chkregister</option> option is used)
-		</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><errorcode>9</errorcode></term>
-	<listitem>
-		<para>Out of memory error</para>
-	</listitem>
-		</varlistentry>
-
-		<varlistentry>
-	<term><errorcode>10</errorcode></term>
-	<listitem>
-		<para>XPath evaluation error</para>
-	</listitem>
-		</varlistentry>
-
-	</variablelist>
+    <title>DIAGNOSTICS</title>
+    <para>
+        &xmllint; return codes provide information that can be used when
+        calling it from scripts.
+    </para>
+    <!-- better use segmentedlist element later,
+         which is currently only supported in snapshots -->
+    <variablelist>
+
+        <varlistentry>
+            <term><errorcode>0</errorcode></term>
+            <listitem>
+                <para>No error</para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><errorcode>1</errorcode></term>
+            <listitem>
+                <para>Unclassified</para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><errorcode>2</errorcode></term>
+            <listitem>
+                <para>Error in <acronym>DTD</acronym></para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><errorcode>3</errorcode></term>
+            <listitem>
+                <para>Validation error</para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><errorcode>4</errorcode></term>
+            <listitem>
+                <para>Validation error</para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><errorcode>5</errorcode></term>
+            <listitem>
+                <para>Error in schema compilation</para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><errorcode>6</errorcode></term>
+            <listitem>
+                <para>Error writing output</para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><errorcode>7</errorcode></term>
+            <listitem>
+                <para>
+                    Error in pattern (generated when <option>--pattern</option> option is used)
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><errorcode>8</errorcode></term>
+            <listitem>
+                <para>
+                    Error in Reader registration (generated
+                    when <option>--chkregister</option> option is used)
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><errorcode>9</errorcode></term>
+            <listitem>
+                <para>Out of memory error</para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term><errorcode>10</errorcode></term>
+            <listitem>
+                <para>XPath evaluation error</para>
+            </listitem>
+        </varlistentry>
+
+    </variablelist>
 </refsect1>
 
 <refsect1 id="seealso">
-	<title>SEE ALSO</title>
-	<para><citerefentry>
-			<refentrytitle>libxml</refentrytitle>
-			<manvolnum>3</manvolnum>
-		</citerefentry>
-	</para>
-	<para>
-		More information can be found at
-		<itemizedlist>
-			<listitem>
-				<para><citerefentry>
-						<refentrytitle>libxml</refentrytitle>
-						<manvolnum>3</manvolnum>
-					</citerefentry> web page <ulink url="https://gitlab.gnome.org/GNOME/libxml2"/>
-				</para>
-			</listitem>
-		</itemizedlist>
-	</para>
+    <title>SEE ALSO</title>
+    <para><citerefentry>
+            <refentrytitle>libxml</refentrytitle>
+            <manvolnum>3</manvolnum>
+        </citerefentry>
+    </para>
+    <para>
+        More information can be found at
+        <itemizedlist>
+            <listitem>
+                <para><citerefentry>
+                        <refentrytitle>libxml</refentrytitle>
+                        <manvolnum>3</manvolnum>
+                    </citerefentry> web page <ulink url="https://gitlab.gnome.org/GNOME/libxml2"/>
+                </para>
+            </listitem>
+        </itemizedlist>
+    </para>
 </refsect1>
 
 </refentry>