preparing release 2.5.6 updated and rebuilt the docs Daniel

* configure.in NEWS: preparing release 2.5.6
* doc/*: updated and rebuilt the docs
Daniel
diff --git a/doc/html/libxml-xpath.html b/doc/html/libxml-xpath.html
index 4a90c88..c2a2155 100644
--- a/doc/html/libxml-xpath.html
+++ b/doc/html/libxml-xpath.html
@@ -515,6 +515,16 @@
 HREF="libxml-xpath.html#XMLXPATHCONTEXTPTR"
 >xmlXPathContextPtr</A
 > ctxt);
+<GTKDOCLINK
+HREF="LONG"
+>long</GTKDOCLINK
+>        <A
+HREF="libxml-xpath.html#XMLXPATHORDERDOCELEMS"
+>xmlXPathOrderDocElems</A
+>           (<A
+HREF="libxml-tree.html#XMLDOCPTR"
+>xmlDocPtr</A
+> doc);
 <A
 HREF="libxml-xpath.html#XMLXPATHOBJECTPTR"
 >xmlXPathObjectPtr</A
@@ -592,7 +602,7 @@
 ><DIV
 CLASS="REFSECT1"
 ><A
-NAME="AEN14387"
+NAME="AEN14390"
 ></A
 ><H2
 >Description</H2
@@ -602,14 +612,14 @@
 ><DIV
 CLASS="REFSECT1"
 ><A
-NAME="AEN14390"
+NAME="AEN14393"
 ></A
 ><H2
 >Details</H2
 ><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN14392"
+NAME="AEN14395"
 ></A
 ><H3
 ><A
@@ -698,7 +708,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN14398"
+NAME="AEN14401"
 ></A
 ><H3
 ><A
@@ -711,7 +721,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN14402"
+NAME="AEN14405"
 ></A
 ><H3
 ><A
@@ -755,7 +765,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN14408"
+NAME="AEN14411"
 ></A
 ><H3
 ><A
@@ -768,7 +778,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN14412"
+NAME="AEN14415"
 ></A
 ><H3
 ><A
@@ -817,7 +827,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN14417"
+NAME="AEN14420"
 ></A
 ><H3
 ><A
@@ -848,7 +858,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN14422"
+NAME="AEN14425"
 ></A
 ><H3
 ><A
@@ -861,7 +871,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN14426"
+NAME="AEN14429"
 ></A
 ><H3
 ><A
@@ -898,7 +908,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN14431"
+NAME="AEN14434"
 ></A
 ><H3
 ><A
@@ -934,7 +944,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN14436"
+NAME="AEN14439"
 ></A
 ><H3
 ><A
@@ -947,7 +957,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN14440"
+NAME="AEN14443"
 ></A
 ><H3
 ><A
@@ -979,7 +989,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN14447"
+NAME="AEN14450"
 ></A
 ><P
 ></P
@@ -1052,7 +1062,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN14464"
+NAME="AEN14467"
 ></A
 ><H3
 ><A
@@ -1081,7 +1091,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN14469"
+NAME="AEN14472"
 ></A
 ><H3
 ><A
@@ -1094,7 +1104,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN14473"
+NAME="AEN14476"
 ></A
 ><H3
 ><A
@@ -1123,7 +1133,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN14478"
+NAME="AEN14481"
 ></A
 ><H3
 ><A
@@ -1136,7 +1146,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN14482"
+NAME="AEN14485"
 ></A
 ><H3
 ><A
@@ -1167,7 +1177,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN14489"
+NAME="AEN14492"
 ></A
 ><P
 ></P
@@ -1222,7 +1232,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN14502"
+NAME="AEN14505"
 ></A
 ><H3
 ><A
@@ -1251,7 +1261,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN14507"
+NAME="AEN14510"
 ></A
 ><H3
 ><A
@@ -1264,7 +1274,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN14511"
+NAME="AEN14514"
 ></A
 ><H3
 ><A
@@ -1303,7 +1313,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN14520"
+NAME="AEN14523"
 ></A
 ><P
 ></P
@@ -1376,7 +1386,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN14537"
+NAME="AEN14540"
 ></A
 ><H3
 ><A
@@ -1405,7 +1415,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN14542"
+NAME="AEN14545"
 ></A
 ><H3
 ><A
@@ -1418,7 +1428,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN14546"
+NAME="AEN14549"
 ></A
 ><H3
 ><A
@@ -1444,7 +1454,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN14551"
+NAME="AEN14554"
 ></A
 ><H3
 ><A
@@ -1457,7 +1467,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN14555"
+NAME="AEN14558"
 ></A
 ><H3
 ><A
@@ -1490,7 +1500,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN14562"
+NAME="AEN14565"
 ></A
 ><P
 ></P
@@ -1545,7 +1555,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN14575"
+NAME="AEN14578"
 ></A
 ><H3
 ><A
@@ -1580,7 +1590,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN14583"
+NAME="AEN14586"
 ></A
 ><P
 ></P
@@ -1636,7 +1646,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN14596"
+NAME="AEN14599"
 ></A
 ><H3
 ><A
@@ -1671,7 +1681,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN14604"
+NAME="AEN14607"
 ></A
 ><P
 ></P
@@ -1727,7 +1737,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN14617"
+NAME="AEN14620"
 ></A
 ><H3
 ><A
@@ -1754,7 +1764,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN14623"
+NAME="AEN14626"
 ></A
 ><P
 ></P
@@ -1792,7 +1802,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN14632"
+NAME="AEN14635"
 ></A
 ><H3
 ><A
@@ -1822,7 +1832,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN14639"
+NAME="AEN14642"
 ></A
 ><P
 ></P
@@ -1877,7 +1887,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN14652"
+NAME="AEN14655"
 ></A
 ><H3
 ><A
@@ -1909,7 +1919,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN14659"
+NAME="AEN14662"
 ></A
 ><P
 ></P
@@ -1947,7 +1957,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN14668"
+NAME="AEN14671"
 ></A
 ><H3
 ><A
@@ -1977,7 +1987,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN14675"
+NAME="AEN14678"
 ></A
 ><P
 ></P
@@ -2015,7 +2025,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN14684"
+NAME="AEN14687"
 ></A
 ><H3
 ><A
@@ -2053,7 +2063,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN14693"
+NAME="AEN14696"
 ></A
 ><P
 ></P
@@ -2109,7 +2119,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN14706"
+NAME="AEN14709"
 ></A
 ><H3
 ><A
@@ -2148,7 +2158,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN14715"
+NAME="AEN14718"
 ></A
 ><P
 ></P
@@ -2186,7 +2196,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN14724"
+NAME="AEN14727"
 ></A
 ><H3
 ><A
@@ -2216,7 +2226,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN14731"
+NAME="AEN14734"
 ></A
 ><P
 ></P
@@ -2254,7 +2264,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN14740"
+NAME="AEN14743"
 ></A
 ><H3
 ><A
@@ -2287,7 +2297,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN14748"
+NAME="AEN14751"
 ></A
 ><P
 ></P
@@ -2343,7 +2353,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN14761"
+NAME="AEN14764"
 ></A
 ><H3
 ><A
@@ -2377,7 +2387,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN14769"
+NAME="AEN14772"
 ></A
 ><P
 ></P
@@ -2450,7 +2460,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN14786"
+NAME="AEN14789"
 ></A
 ><H3
 ><A
@@ -2480,7 +2490,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN14793"
+NAME="AEN14796"
 ></A
 ><P
 ></P
@@ -2536,7 +2546,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN14806"
+NAME="AEN14809"
 ></A
 ><H3
 ><A
@@ -2566,7 +2576,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN14813"
+NAME="AEN14816"
 ></A
 ><P
 ></P
@@ -2622,7 +2632,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN14826"
+NAME="AEN14829"
 ></A
 ><H3
 ><A
@@ -2652,7 +2662,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN14833"
+NAME="AEN14836"
 ></A
 ><P
 ></P
@@ -2708,7 +2718,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN14846"
+NAME="AEN14849"
 ></A
 ><H3
 ><A
@@ -2738,7 +2748,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN14853"
+NAME="AEN14856"
 ></A
 ><P
 ></P
@@ -2794,7 +2804,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN14866"
+NAME="AEN14869"
 ></A
 ><H3
 ><A
@@ -2824,7 +2834,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN14873"
+NAME="AEN14876"
 ></A
 ><P
 ></P
@@ -2880,7 +2890,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN14886"
+NAME="AEN14889"
 ></A
 ><H3
 ><A
@@ -2913,7 +2923,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN14894"
+NAME="AEN14897"
 ></A
 ><P
 ></P
@@ -2969,7 +2979,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN14907"
+NAME="AEN14910"
 ></A
 ><H3
 ><A
@@ -3002,7 +3012,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN14915"
+NAME="AEN14918"
 ></A
 ><P
 ></P
@@ -3058,7 +3068,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN14928"
+NAME="AEN14931"
 ></A
 ><H3
 ><A
@@ -3091,7 +3101,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN14936"
+NAME="AEN14939"
 ></A
 ><P
 ></P
@@ -3147,7 +3157,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN14949"
+NAME="AEN14952"
 ></A
 ><H3
 ><A
@@ -3180,7 +3190,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN14957"
+NAME="AEN14960"
 ></A
 ><P
 ></P
@@ -3236,7 +3246,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN14970"
+NAME="AEN14973"
 ></A
 ><H3
 ><A
@@ -3266,7 +3276,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN14977"
+NAME="AEN14980"
 ></A
 ><P
 ></P
@@ -3322,7 +3332,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN14990"
+NAME="AEN14993"
 ></A
 ><H3
 ><A
@@ -3355,7 +3365,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN14998"
+NAME="AEN15001"
 ></A
 ><P
 ></P
@@ -3411,7 +3421,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN15011"
+NAME="AEN15014"
 ></A
 ><H3
 ><A
@@ -3444,7 +3454,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN15019"
+NAME="AEN15022"
 ></A
 ><P
 ></P
@@ -3500,7 +3510,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN15032"
+NAME="AEN15035"
 ></A
 ><H3
 ><A
@@ -3533,7 +3543,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN15040"
+NAME="AEN15043"
 ></A
 ><P
 ></P
@@ -3589,7 +3599,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN15053"
+NAME="AEN15056"
 ></A
 ><H3
 ><A
@@ -3625,7 +3635,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN15062"
+NAME="AEN15065"
 ></A
 ><P
 ></P
@@ -3681,7 +3691,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN15075"
+NAME="AEN15078"
 ></A
 ><H3
 ><A
@@ -3717,7 +3727,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN15084"
+NAME="AEN15087"
 ></A
 ><P
 ></P
@@ -3773,7 +3783,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN15097"
+NAME="AEN15100"
 ></A
 ><H3
 ><A
@@ -3809,7 +3819,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN15106"
+NAME="AEN15109"
 ></A
 ><P
 ></P
@@ -3865,7 +3875,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN15119"
+NAME="AEN15122"
 ></A
 ><H3
 ><A
@@ -3901,7 +3911,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN15128"
+NAME="AEN15131"
 ></A
 ><P
 ></P
@@ -3957,7 +3967,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN15141"
+NAME="AEN15144"
 ></A
 ><H3
 ><A
@@ -3985,7 +3995,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN15147"
+NAME="AEN15150"
 ></A
 ><H3
 ><A
@@ -4018,7 +4028,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN15155"
+NAME="AEN15158"
 ></A
 ><P
 ></P
@@ -4074,7 +4084,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN15168"
+NAME="AEN15171"
 ></A
 ><H3
 ><A
@@ -4104,7 +4114,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN15175"
+NAME="AEN15178"
 ></A
 ><P
 ></P
@@ -4142,7 +4152,100 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN15184"
+NAME="AEN15187"
+></A
+><H3
+><A
+NAME="XMLXPATHORDERDOCELEMS"
+></A
+>xmlXPathOrderDocElems ()</H3
+><TABLE
+BORDER="0"
+BGCOLOR="#D6E8FF"
+WIDTH="100%"
+CELLPADDING="6"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+><GTKDOCLINK
+HREF="LONG"
+>long</GTKDOCLINK
+>        xmlXPathOrderDocElems           (<A
+HREF="libxml-tree.html#XMLDOCPTR"
+>xmlDocPtr</A
+> doc);</PRE
+></TD
+></TR
+></TABLE
+><P
+>Call this routine to speed up XPath computation on static documents.
+This stamps all the element nodes with the document order
+Like for line information, the order is kept in the element-&gt;content
+field, the value stored is actually - the node number (startting at -1)
+to be able to differenciate from line numbers.</P
+><P
+></P
+><DIV
+CLASS="INFORMALTABLE"
+><A
+NAME="AEN15195"
+></A
+><P
+></P
+><TABLE
+BORDER="0"
+WIDTH="100%"
+BGCOLOR="#FFD0D0"
+CELLSPACING="0"
+CELLPADDING="4"
+CLASS="CALSTABLE"
+><TBODY
+><TR
+><TD
+WIDTH="20%"
+ALIGN="RIGHT"
+VALIGN="TOP"
+><TT
+CLASS="PARAMETER"
+><I
+>doc</I
+></TT
+>&nbsp;:</TD
+><TD
+WIDTH="80%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>&nbsp;</TD
+></TR
+><TR
+><TD
+WIDTH="20%"
+ALIGN="RIGHT"
+VALIGN="TOP"
+><SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>Returns</I
+></SPAN
+> :</TD
+><TD
+WIDTH="80%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>&nbsp;</TD
+></TR
+></TBODY
+></TABLE
+><P
+></P
+></DIV
+></DIV
+><HR><DIV
+CLASS="REFSECT2"
+><A
+NAME="AEN15208"
 ></A
 ><H3
 ><A
@@ -4179,7 +4282,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN15193"
+NAME="AEN15217"
 ></A
 ><P
 ></P
@@ -4252,7 +4355,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN15210"
+NAME="AEN15234"
 ></A
 ><H3
 ><A
@@ -4289,7 +4392,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN15219"
+NAME="AEN15243"
 ></A
 ><P
 ></P
@@ -4362,7 +4465,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN15236"
+NAME="AEN15260"
 ></A
 ><H3
 ><A
@@ -4403,7 +4506,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN15244"
+NAME="AEN15268"
 ></A
 ><P
 ></P
@@ -4476,7 +4579,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN15261"
+NAME="AEN15285"
 ></A
 ><H3
 ><A
@@ -4509,7 +4612,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN15269"
+NAME="AEN15293"
 ></A
 ><P
 ></P
@@ -4565,7 +4668,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN15282"
+NAME="AEN15306"
 ></A
 ><H3
 ><A
@@ -4602,7 +4705,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN15291"
+NAME="AEN15315"
 ></A
 ><P
 ></P
@@ -4675,7 +4778,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN15308"
+NAME="AEN15332"
 ></A
 ><H3
 ><A
@@ -4710,7 +4813,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN15316"
+NAME="AEN15340"
 ></A
 ><P
 ></P