GNOME.org
 

[xslt] Re: [xml] Re: Updated xsltproc manpage, patch attached

Am Donnerstag, den 06.04.2006, 14:25 +0200 schrieb Daniel Leidert:
> Am Donnerstag, den 06.04.2006, 07:41 -0400 schrieb Daniel Veillard:
> > On Thu, Apr 06, 2006 at 01:35:56PM +0200, Daniel Leidert wrote:
> > > Right. But it redirects to the same URL. I thought, that you don't use a
> > 
> >   libxml2/libxslt make can't rely on remote resources, so if it's not
> > in the catalog it will break. It does break on my systems as a result.
> > 
> > > versions. So if you decide to not use the snapshots for the moment, I
> > > have to change back some stuff.
> > 
> >   I think that's premature, sorry :-\
> 
> No problem. Expect the fixed manpages very soon.

[x] Done. Attached are the patches.

I found, that the latest docbook-xsl release does not contain all the
issues I thought. It was a local problem with the catalog, which led to
those issues. So the patches are really easy. They only replace the
segmentedlist element with the old variablelist construct. That should
be fine.

Regards, Daniel

Index: doc/xmlcatalog_man.xml
===================================================================
RCS file: /cvs/gnome/libxml2/doc/xmlcatalog_man.xml,v
retrieving revision 1.12
diff -u -r1.12 xmlcatalog_man.xml
--- doc/xmlcatalog_man.xml	6 Apr 2006 08:22:51 -0000	1.12
+++ doc/xmlcatalog_man.xml	6 Apr 2006 12:43:24 -0000
@@ -232,7 +232,8 @@
 	<listitem>
 		<para>
 			Run a shell allowing interactive queries on catalog
-			file <replaceable>CATALOGFILE</replaceable>.
+			file <replaceable>CATALOGFILE</replaceable>. For the set of available
+			commands see <xref linkend="shell"/>.
 		</para>
 	</listitem>
 		</varlistentry>
@@ -393,31 +394,44 @@
 		&xmlcatalog;'s return codes provide information that can be used when
 		calling it from scripts.
 	</para>
-	<segmentedlist>
-		<!-- <title>Error codes</title> -->
-		<segtitle>Errorcode</segtitle>
-		<segtitle>Error</segtitle>
-		<seglistitem>
-			<seg><errorcode>0</errorcode></seg>
-			<seg>No error</seg>
-		</seglistitem>
-		<seglistitem>
-			<seg><errorcode>1</errorcode></seg>
-			<seg>Failed to remove an entry from the catalog</seg>
-		</seglistitem>
-		<seglistitem>
-			<seg><errorcode>2</errorcode></seg>
-			<seg>Failed to save to the catalog, check file permissions</seg>
-		</seglistitem>
-		<seglistitem>
-			<seg><errorcode>3</errorcode></seg>
-			<seg>Failed to add an entry to the catalog</seg>
-		</seglistitem>
-		<seglistitem>
-			<seg><errorcode>4</errorcode></seg>
-			<seg>Failed to lookup and entry in the catalog</seg>
-		</seglistitem>
-	</segmentedlist>
+	<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 lookup an entry in the catalog</para>
+	</listitem>
+		</varlistentry>
+
+	</variablelist>
 </refsect1>
 
 <refsect1 id="seealso">

Index: doc/xmllint.xml
===================================================================
RCS file: /cvs/gnome/libxml2/doc/xmllint.xml,v
retrieving revision 1.32
diff -u -r1.32 xmllint.xml
--- doc/xmllint.xml	6 Apr 2006 08:22:51 -0000	1.32
+++ doc/xmllint.xml	6 Apr 2006 12:43:11 -0000
@@ -813,51 +813,86 @@
 	<para>
 		On the completion of execution, &xmllint; returns the following error codes:
 	</para>
-	<segmentedlist>
-		<!-- <title>Error codes</title> -->
-		<segtitle>Errorcode</segtitle>
-		<segtitle>Error</segtitle>
-		<seglistitem>
-			<seg><errorcode>0</errorcode></seg>
-			<seg>No error</seg>
-		</seglistitem>
-		<seglistitem>
-			<seg><errorcode>1</errorcode></seg>
-			<seg>Unclassified</seg>
-		</seglistitem>
-		<seglistitem>
-			<seg><errorcode>2</errorcode></seg>
-			<seg>Error in DTD</seg>
-		</seglistitem>
-		<seglistitem>
-			<seg><errorcode>3</errorcode></seg>
-			<seg>Validation error</seg>
-		</seglistitem>
-		<seglistitem>
-			<seg><errorcode>4</errorcode></seg>
-			<seg>Validation error</seg>
-		</seglistitem>
-		<seglistitem>
-			<seg><errorcode>5</errorcode></seg>
-			<seg>Error in schema compilation</seg>
-		</seglistitem>
-		<seglistitem>
-			<seg><errorcode>6</errorcode></seg>
-			<seg>Error writing output</seg>
-		</seglistitem>
-		<seglistitem>
-			<seg><errorcode>7</errorcode></seg>
-			<seg>Error in pattern (generated when <option>--pattern</option> option is used)</seg>
-		</seglistitem>
-		<seglistitem>
-			<seg><errorcode>8</errorcode></seg>
-			<seg>Error in reader registration (generated when <option>--chkregister</option> option is used)</seg>
-		</seglistitem>
-		<seglistitem>
-			<seg><errorcode>9</errorcode></seg>
-			<seg>Out of memory</seg>
-		</seglistitem>
-	</segmentedlist>
+	<!-- 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>
+
+	</variablelist>
 </refsect1>
 
 <refsect1 id="seealso">

Index: doc/xsltproc.xml
===================================================================
RCS file: /cvs/gnome/libxslt/doc/xsltproc.xml,v
retrieving revision 1.23
diff -u -r1.23 xsltproc.xml
--- doc/xsltproc.xml	6 Apr 2006 08:17:32 -0000	1.23
+++ doc/xsltproc.xml	6 Apr 2006 12:41:58 -0000
@@ -439,55 +439,86 @@
 		&xsltproc;'s return codes provide information that can be used when
 		calling it from scripts.
 	</para>
-	<segmentedlist>
-		<!-- <title>Error codes</title> -->
-		<segtitle>Errorcode</segtitle>
-		<segtitle>Error</segtitle>
-		<seglistitem>
-			<seg><errorcode>0</errorcode></seg>
-			<seg>No error</seg>
-		</seglistitem>
-		<seglistitem>
-			<seg><errorcode>1</errorcode></seg>
-			<seg>No argument</seg>
-		</seglistitem>
-		<seglistitem>
-			<seg><errorcode>2</errorcode></seg>
-			<seg>Too many parameters</seg>
-		</seglistitem>
-		<seglistitem>
-			<seg><errorcode>3</errorcode></seg>
-			<seg>Unknown option</seg>
-		</seglistitem>
-		<seglistitem>
-			<seg><errorcode>4</errorcode></seg>
-			<seg>Failed to parse the stylesheet</seg>
-		</seglistitem>
-		<seglistitem>
-			<seg><errorcode>5</errorcode></seg>
-			<seg>Error in the stylesheet</seg>
-		</seglistitem>
-		<seglistitem>
-			<seg><errorcode>6</errorcode></seg>
-			<seg>Error in one of the documents</seg>
-		</seglistitem>
-		<seglistitem>
-			<seg><errorcode>7</errorcode></seg>
-			<seg>Unsupported xsl:output method</seg>
-		</seglistitem>
-		<seglistitem>
-			<seg><errorcode>8</errorcode></seg>
-			<seg>String parameter contains both quote and double-quotes</seg>
-		</seglistitem>
-		<seglistitem>
-			<seg><errorcode>9</errorcode></seg>
-			<seg>Internal processing error</seg>
-		</seglistitem>
-		<seglistitem>
-			<seg><errorcode>10</errorcode></seg>
-			<seg>Processing was stopped by a terminating message</seg>
-		</seglistitem>
-	</segmentedlist>
+	<variablelist>
+
+		<varlistentry>
+	<term><errorcode>0</errorcode></term>
+	<listitem>
+		<para>No error (normal operation)</para>
+	</listitem>
+		</varlistentry>
+
+		<varlistentry>
+	<term><errorcode>1</errorcode></term>
+	<listitem>
+		<para>No argument</para>
+	</listitem>
+		</varlistentry>
+
+		<varlistentry>
+	<term><errorcode>2</errorcode></term>
+	<listitem>
+		<para>Too many parameters</para>
+	</listitem>
+		</varlistentry>
+
+		<varlistentry>
+	<term><errorcode>3</errorcode></term>
+	<listitem>
+		<para>Unknown option</para>
+	</listitem>
+		</varlistentry>
+
+		<varlistentry>
+	<term><errorcode>4</errorcode></term>
+	<listitem>
+		<para>Failed to parse the stylesheet</para>
+	</listitem>
+		</varlistentry>
+
+		<varlistentry>
+	<term><errorcode>5</errorcode></term>
+	<listitem>
+		<para>Error in the stylesheet</para>
+	</listitem>
+		</varlistentry>
+
+		<varlistentry>
+	<term><errorcode>6</errorcode></term>
+	<listitem>
+		<para>Error in one of the documents</para>
+	</listitem>
+		</varlistentry>
+
+		<varlistentry>
+	<term><errorcode>7</errorcode></term>
+	<listitem>
+		<para>Unsupported xsl:output method</para>
+	</listitem>
+		</varlistentry>
+
+		<varlistentry>
+	<term><errorcode>8</errorcode></term>
+	<listitem>
+		<para>String parameter contains both quote and double-quotes</para>
+	</listitem>
+		</varlistentry>
+
+		<varlistentry>
+	<term><errorcode>9</errorcode></term>
+	<listitem>
+		<para>Internal processing error</para>
+	</listitem>
+		</varlistentry>
+
+		<varlistentry>
+	<term><errorcode>10</errorcode></term>
+	<listitem>
+		<para>Processing was stopped by a terminating message</para>
+	</listitem>
+		</varlistentry>
+
+	</variablelist>
 </refsect1>
 
 <refsect1 id="seealso">
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]