added documentation about Catalog support, misses an API description

* doc/catalog.html doc/xml.html: added documentation about
  Catalog support, misses an API description
* doc/html/*: reextracted the API pages
Daniel
diff --git a/doc/html/libxml-debugxml.html b/doc/html/libxml-debugxml.html
index 869ba95..6f9e5c4 100644
--- a/doc/html/libxml-debugxml.html
+++ b/doc/html/libxml-debugxml.html
@@ -122,7 +122,7 @@
 ><DIV
 CLASS="REFNAMEDIV"
 ><A
-NAME="AEN22337"
+NAME="AEN23127"
 ></A
 ><H2
 >Name</H2
@@ -130,7 +130,7 @@
 ><DIV
 CLASS="REFSYNOPSISDIV"
 ><A
-NAME="AEN22340"
+NAME="AEN23130"
 ></A
 ><H2
 >Synopsis</H2
@@ -311,7 +311,7 @@
 ><DIV
 CLASS="REFSECT1"
 ><A
-NAME="AEN22384"
+NAME="AEN23174"
 ></A
 ><H2
 >Description</H2
@@ -321,14 +321,14 @@
 ><DIV
 CLASS="REFSECT1"
 ><A
-NAME="AEN22387"
+NAME="AEN23177"
 ></A
 ><H2
 >Details</H2
 ><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN22389"
+NAME="AEN23179"
 ></A
 ><H3
 ><A
@@ -362,7 +362,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN22397"
+NAME="AEN23187"
 ></A
 ><P
 ></P
@@ -417,7 +417,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN22410"
+NAME="AEN23200"
 ></A
 ><H3
 ><A
@@ -452,7 +452,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN22418"
+NAME="AEN23208"
 ></A
 ><P
 ></P
@@ -524,7 +524,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN22435"
+NAME="AEN23225"
 ></A
 ><H3
 ><A
@@ -559,7 +559,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN22443"
+NAME="AEN23233"
 ></A
 ><P
 ></P
@@ -631,7 +631,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN22460"
+NAME="AEN23250"
 ></A
 ><H3
 ><A
@@ -666,7 +666,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN22468"
+NAME="AEN23258"
 ></A
 ><P
 ></P
@@ -738,7 +738,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN22485"
+NAME="AEN23275"
 ></A
 ><H3
 ><A
@@ -773,7 +773,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN22493"
+NAME="AEN23283"
 ></A
 ><P
 ></P
@@ -845,7 +845,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN22510"
+NAME="AEN23300"
 ></A
 ><H3
 ><A
@@ -880,7 +880,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN22518"
+NAME="AEN23308"
 ></A
 ><P
 ></P
@@ -952,7 +952,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN22535"
+NAME="AEN23325"
 ></A
 ><H3
 ><A
@@ -986,7 +986,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN22543"
+NAME="AEN23333"
 ></A
 ><P
 ></P
@@ -1041,7 +1041,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN22556"
+NAME="AEN23346"
 ></A
 ><H3
 ><A
@@ -1075,7 +1075,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN22564"
+NAME="AEN23354"
 ></A
 ><P
 ></P
@@ -1130,7 +1130,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN22577"
+NAME="AEN23367"
 ></A
 ><H3
 ><A
@@ -1164,7 +1164,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN22585"
+NAME="AEN23375"
 ></A
 ><P
 ></P
@@ -1219,7 +1219,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN22598"
+NAME="AEN23388"
 ></A
 ><H3
 ><A
@@ -1253,7 +1253,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN22606"
+NAME="AEN23396"
 ></A
 ><P
 ></P
@@ -1308,7 +1308,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN22619"
+NAME="AEN23409"
 ></A
 ><H3
 ><A
@@ -1329,11 +1329,13 @@
 ></TR
 ></TABLE
 ><P
+>This is a generic signature for the XML shell input function</P
+><P
 ></P
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN22624"
+NAME="AEN23415"
 ></A
 ><P
 ></P
@@ -1360,7 +1362,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  a string prompt</TD
 ></TR
 ><TR
 ><TD
@@ -1375,7 +1377,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>a string which will be freed by the Shell</TD
 ></TR
 ></TBODY
 ></TABLE
@@ -1386,7 +1388,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN22637"
+NAME="AEN23428"
 ></A
 ><H3
 ><A
@@ -1415,12 +1417,15 @@
 ></TR
 ></TABLE
 ><P
+>A debugging shell context
+TODO: add the defined function tables.</P
+><P
 ></P
 ></DIV
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN22642"
+NAME="AEN23434"
 ></A
 ><H3
 ><A
@@ -1446,7 +1451,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN22647"
+NAME="AEN23439"
 ></A
 ><H3
 ><A
@@ -1479,11 +1484,13 @@
 ></TR
 ></TABLE
 ><P
+>This is a generic signature for the XML shell functions</P
+><P
 ></P
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN22655"
+NAME="AEN23448"
 ></A
 ><P
 ></P
@@ -1510,7 +1517,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  a shell context</TD
 ></TR
 ><TR
 ><TD
@@ -1527,7 +1534,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  a string argument</TD
 ></TR
 ><TR
 ><TD
@@ -1544,7 +1551,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  a first node</TD
 ></TR
 ><TR
 ><TD
@@ -1561,7 +1568,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  a second node</TD
 ></TR
 ><TR
 ><TD
@@ -1576,7 +1583,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>an int, negative returns indicating errors</TD
 ></TR
 ></TBODY
 ></TABLE
@@ -1587,7 +1594,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN22680"
+NAME="AEN23473"
 ></A
 ><H3
 ><A
@@ -1628,7 +1635,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN22689"
+NAME="AEN23482"
 ></A
 ><P
 ></P