generated an index based on comments content similar to libxml2 one The

* doc/API*.html doc/parsedecl.py doc/*.xsl parsedecl.py: generated
  an index based on comments content similar to libxml2 one
  The code need more specific comments.
* doc/*: rebuilt the web site with the new references
Daniel

1 files changed, 66 insertions, 95 deletions

diff --git a/doc/html/libxslt-templates.html b/doc/html/libxslt-templates.html
index f6c9d30a..465fb4f5 100644
--- a/doc/html/libxslt-templates.html
+++ b/doc/html/libxslt-templates.html
@@ -123,7 +123,7 @@ NAME="LIBXSLT-TEMPLATES"
 ><DIV
 CLASS="REFNAMEDIV"
 ><A
-NAME="AEN626"
+NAME="AEN588"
 ></A
 ><H2
 >Name</H2
@@ -131,7 +131,7 @@ NAME="AEN626"
 ><DIV
 CLASS="REFSYNOPSISDIV"
 ><A
-NAME="AEN629"
+NAME="AEN591"
 ></A
 ><H2
 >Synopsis</H2
@@ -310,7 +310,7 @@ HREF="XMLCHAR"
 ><DIV
 CLASS="REFSECT1"
 ><A
-NAME="AEN675"
+NAME="AEN637"
 ></A
 ><H2
 >Description</H2
@@ -320,20 +320,20 @@ NAME="AEN675"
 ><DIV
 CLASS="REFSECT1"
 ><A
-NAME="AEN678"
+NAME="AEN640"
 ></A
 ><H2
 >Details</H2
 ><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN680"
+NAME="AEN642"
 ></A
 ><H3
 ><A
 NAME="XSLTEVALXPATHPREDICATE"
 ></A
->xsltEvalXPathPredicate ()</H3
+>&#62;xsltEvalXPathPredicate ()</H3
 ><TABLE
 BORDER="0"
 BGCOLOR="#D6E8FF"
@@ -360,14 +360,11 @@ HREF="XMLNSPTR"
 ></TR
 ></TABLE
 ><P
->Process the expression using XPath and evaluate the result as
-an XPath predicate</P
-><P
 ></P
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN689"
+NAME="AEN650"
 ></A
 ><P
 ></P
@@ -394,7 +391,7 @@ CLASS="PARAMETER"
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->  the XSLT transformation context</TD
+>&nbsp;</TD
 ></TR
 ><TR
 ><TD
@@ -411,7 +408,7 @@ CLASS="PARAMETER"
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->  the XPath compiled expression</TD
+>&nbsp;</TD
 ></TR
 ><TR
 ><TD
@@ -428,7 +425,7 @@ CLASS="PARAMETER"
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->  the namespaces in scope</TD
+>&nbsp;</TD
 ></TR
 ><TR
 ><TD
@@ -445,7 +442,7 @@ CLASS="PARAMETER"
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->  the number of namespaces in scope</TD
+>&nbsp;</TD
 ></TR
 ><TR
 ><TD
@@ -460,7 +457,7 @@ CLASS="EMPHASIS"
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->1 is the predicate was true, 0 otherwise</TD
+>&nbsp;</TD
 ></TR
 ></TBODY
 ></TABLE
@@ -471,13 +468,13 @@ VALIGN="TOP"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN714"
+NAME="AEN675"
 ></A
 ><H3
 ><A
 NAME="XSLTEVALTEMPLATESTRING"
 ></A
->xsltEvalTemplateString ()</H3
+>&#62;xsltEvalTemplateString ()</H3
 ><TABLE
 BORDER="0"
 BGCOLOR="#D6E8FF"
@@ -506,15 +503,11 @@ HREF="XMLNODEPTR"
 ></TR
 ></TABLE
 ><P
->Evaluate a template string value, i.e. the parent list is interpreter
-as template content and the resulting tree string value is returned
-This is needed for example by xsl:comment and xsl:processing-instruction</P
-><P
 ></P
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN724"
+NAME="AEN684"
 ></A
 ><P
 ></P
@@ -541,7 +534,7 @@ CLASS="PARAMETER"
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->  the XSLT transformation context</TD
+>&nbsp;</TD
 ></TR
 ><TR
 ><TD
@@ -558,7 +551,7 @@ CLASS="PARAMETER"
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->  the stylesheet node</TD
+>&nbsp;</TD
 ></TR
 ><TR
 ><TD
@@ -575,7 +568,7 @@ CLASS="PARAMETER"
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->  the content parent</TD
+>&nbsp;</TD
 ></TR
 ><TR
 ><TD
@@ -590,8 +583,7 @@ CLASS="EMPHASIS"
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->the computed string value or NULL, must be deallocated by the
-caller.</TD
+>&nbsp;</TD
 ></TR
 ></TBODY
 ></TABLE
@@ -602,13 +594,13 @@ caller.</TD
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN745"
+NAME="AEN705"
 ></A
 ><H3
 ><A
 NAME="XSLTEVALATTRVALUETEMPLATE"
 ></A
->xsltEvalAttrValueTemplate ()</H3
+>&#62;xsltEvalAttrValueTemplate ()</H3
 ><TABLE
 BORDER="0"
 BGCOLOR="#D6E8FF"
@@ -641,15 +633,11 @@ HREF="XMLCHAR"
 ></TR
 ></TABLE
 ><P
->Evaluate a attribute value template, i.e. the attribute value can
-contain expressions contained in curly braces ({}) and those are
-substituted by they computed value.</P
-><P
 ></P
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN756"
+NAME="AEN715"
 ></A
 ><P
 ></P
@@ -676,7 +664,7 @@ CLASS="PARAMETER"
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->  the XSLT transformation context</TD
+>&nbsp;</TD
 ></TR
 ><TR
 ><TD
@@ -693,7 +681,7 @@ CLASS="PARAMETER"
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->  the stylesheet node</TD
+>&nbsp;</TD
 ></TR
 ><TR
 ><TD
@@ -710,7 +698,7 @@ CLASS="PARAMETER"
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->  the attribute QName</TD
+>&nbsp;</TD
 ></TR
 ><TR
 ><TD
@@ -727,7 +715,7 @@ CLASS="PARAMETER"
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->  the attribute namespace URI</TD
+>&nbsp;</TD
 ></TR
 ><TR
 ><TD
@@ -742,8 +730,7 @@ CLASS="EMPHASIS"
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->the computed string value or NULL, must be deallocated by the
-caller.</TD
+>&nbsp;</TD
 ></TR
 ></TBODY
 ></TABLE
@@ -754,13 +741,13 @@ caller.</TD
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN781"
+NAME="AEN740"
 ></A
 ><H3
 ><A
 NAME="XSLTEVALSTATICATTRVALUETEMPLATE"
 ></A
->xsltEvalStaticAttrValueTemplate ()</H3
+>&#62;xsltEvalStaticAttrValueTemplate ()</H3
 ><TABLE
 BORDER="0"
 BGCOLOR="#D6E8FF"
@@ -794,14 +781,11 @@ HREF="XMLCHAR"
 ></TR
 ></TABLE
 ><P
->Check if an attribute value template has a static value, i.e. the
-attribute value does not contain expressions contained in curly braces ({})</P
-><P
 ></P
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN792"
+NAME="AEN750"
 ></A
 ><P
 ></P
@@ -828,7 +812,7 @@ CLASS="PARAMETER"
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->  the XSLT stylesheet</TD
+>&nbsp;</TD
 ></TR
 ><TR
 ><TD
@@ -845,7 +829,7 @@ CLASS="PARAMETER"
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->  the stylesheet node</TD
+>&nbsp;</TD
 ></TR
 ><TR
 ><TD
@@ -862,7 +846,7 @@ CLASS="PARAMETER"
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->  the attribute Name</TD
+>&nbsp;</TD
 ></TR
 ><TR
 ><TD
@@ -879,7 +863,7 @@ CLASS="PARAMETER"
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->  the attribute namespace URI</TD
+>&nbsp;</TD
 ></TR
 ><TR
 ><TD
@@ -896,7 +880,7 @@ CLASS="PARAMETER"
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->  indicator whether the attribute is present</TD
+>&nbsp;</TD
 ></TR
 ><TR
 ><TD
@@ -911,8 +895,7 @@ CLASS="EMPHASIS"
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->the static string value or NULL, must be deallocated by the
-caller.</TD
+>&nbsp;</TD
 ></TR
 ></TBODY
 ></TABLE
@@ -923,13 +906,13 @@ caller.</TD
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN821"
+NAME="AEN779"
 ></A
 ><H3
 ><A
 NAME="XSLTEVALXPATHSTRING"
 ></A
->xsltEvalXPathString ()</H3
+>&#62;xsltEvalXPathString ()</H3
 ><TABLE
 BORDER="0"
 BGCOLOR="#D6E8FF"
@@ -954,13 +937,11 @@ HREF="XMLXPATHCOMPEXPRPTR"
 ></TR
 ></TABLE
 ><P
->Process the expression using XPath and get a string</P
-><P
 ></P
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN830"
+NAME="AEN787"
 ></A
 ><P
 ></P
@@ -987,7 +968,7 @@ CLASS="PARAMETER"
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->  the XSLT transformation context</TD
+>&nbsp;</TD
 ></TR
 ><TR
 ><TD
@@ -1004,7 +985,7 @@ CLASS="PARAMETER"
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->  the compiled XPath expression</TD
+>&nbsp;</TD
 ></TR
 ><TR
 ><TD
@@ -1019,8 +1000,7 @@ CLASS="EMPHASIS"
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->the computed string value or NULL, must be deallocated by the
-caller.</TD
+>&nbsp;</TD
 ></TR
 ></TBODY
 ></TABLE
@@ -1031,13 +1011,13 @@ caller.</TD
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN847"
+NAME="AEN804"
 ></A
 ><H3
 ><A
 NAME="XSLTTEMPLATEPROCESS"
 ></A
->xsltTemplateProcess ()</H3
+>&#62;xsltTemplateProcess ()</H3
 ><TABLE
 BORDER="0"
 BGCOLOR="#D6E8FF"
@@ -1062,13 +1042,11 @@ HREF="XMLNODEPTR"
 ></TR
 ></TABLE
 ><P
->Process the given node and return the new string value.</P
-><P
 ></P
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN856"
+NAME="AEN812"
 ></A
 ><P
 ></P
@@ -1095,7 +1073,7 @@ CLASS="PARAMETER"
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->  the XSLT transformation context</TD
+>&nbsp;</TD
 ></TR
 ><TR
 ><TD
@@ -1112,7 +1090,7 @@ CLASS="PARAMETER"
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->  the attribute template node</TD
+>&nbsp;</TD
 ></TR
 ><TR
 ><TD
@@ -1127,7 +1105,7 @@ CLASS="EMPHASIS"
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->the computed tree replacement</TD
+>&nbsp;</TD
 ></TR
 ></TBODY
 ></TABLE
@@ -1138,13 +1116,13 @@ VALIGN="TOP"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN873"
+NAME="AEN829"
 ></A
 ><H3
 ><A
 NAME="XSLTATTRLISTTEMPLATEPROCESS"
 ></A
->xsltAttrListTemplateProcess ()</H3
+>&#62;xsltAttrListTemplateProcess ()</H3
 ><TABLE
 BORDER="0"
 BGCOLOR="#D6E8FF"
@@ -1173,13 +1151,11 @@ HREF="XMLATTRPTR"
 ></TR
 ></TABLE
 ><P
->Do a copy of an attribute list with attribute template processing</P
-><P
 ></P
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN883"
+NAME="AEN838"
 ></A
 ><P
 ></P
@@ -1206,7 +1182,7 @@ CLASS="PARAMETER"
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->  the XSLT transformation context</TD
+>&nbsp;</TD
 ></TR
 ><TR
 ><TD
@@ -1223,7 +1199,7 @@ CLASS="PARAMETER"
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->  the element where the attributes will be grafted</TD
+>&nbsp;</TD
 ></TR
 ><TR
 ><TD
@@ -1240,7 +1216,7 @@ CLASS="PARAMETER"
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->  the first attribute</TD
+>&nbsp;</TD
 ></TR
 ><TR
 ><TD
@@ -1255,7 +1231,7 @@ CLASS="EMPHASIS"
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
-> a new xmlAttrPtr, or NULL in case of error.</TD
+>&nbsp;</TD
 ></TR
 ></TBODY
 ></TABLE
@@ -1266,13 +1242,13 @@ VALIGN="TOP"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN904"
+NAME="AEN859"
 ></A
 ><H3
 ><A
 NAME="XSLTATTRTEMPLATEPROCESS"
 ></A
->xsltAttrTemplateProcess ()</H3
+>&#62;xsltAttrTemplateProcess ()</H3
 ><TABLE
 BORDER="0"
 BGCOLOR="#D6E8FF"
@@ -1301,13 +1277,11 @@ HREF="XMLATTRPTR"
 ></TR
 ></TABLE
 ><P
->Process the given attribute and return the new processed copy.</P
-><P
 ></P
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN914"
+NAME="AEN868"
 ></A
 ><P
 ></P
@@ -1334,7 +1308,7 @@ CLASS="PARAMETER"
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->  the XSLT transformation context</TD
+>&nbsp;</TD
 ></TR
 ><TR
 ><TD
@@ -1351,7 +1325,7 @@ CLASS="PARAMETER"
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->  the result node</TD
+>&nbsp;</TD
 ></TR
 ><TR
 ><TD
@@ -1383,7 +1357,7 @@ CLASS="EMPHASIS"
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->the attribute replacement.</TD
+>&nbsp;</TD
 ></TR
 ></TBODY
 ></TABLE
@@ -1394,13 +1368,13 @@ VALIGN="TOP"
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN935"
+NAME="AEN889"
 ></A
 ><H3
 ><A
 NAME="XSLTATTRTEMPLATEVALUEPROCESS"
 ></A
->xsltAttrTemplateValueProcess ()</H3
+>&#62;xsltAttrTemplateValueProcess ()</H3
 ><TABLE
 BORDER="0"
 BGCOLOR="#D6E8FF"
@@ -1425,13 +1399,11 @@ HREF="XMLCHAR"
 ></TR
 ></TABLE
 ><P
->Process the given node and return the new string value.</P
-><P
 ></P
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN944"
+NAME="AEN897"
 ></A
 ><P
 ></P
@@ -1458,7 +1430,7 @@ CLASS="PARAMETER"
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->  the XSLT transformation context</TD
+>&nbsp;</TD
 ></TR
 ><TR
 ><TD
@@ -1490,8 +1462,7 @@ CLASS="EMPHASIS"
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->the computed string value or NULL, must be deallocated by the
-caller.</TD
+>&nbsp;</TD
 ></TR
 ></TBODY
 ></TABLE