revuilt the API and docs Daniel

* doc/libxslt-api.xml doc/* doc/html/*: revuilt the API and docs
Daniel

ChangeLog

@@ -1,3 +1,7 @@
+Mon Aug  4 22:43:05 CEST 2003 Daniel Veillard <daniel@veillard.com>
+
+	* doc/libxslt-api.xml doc/* doc/html/*: revuilt the API and docs
+
 Sun Aug  3 21:34:44 EDT 2003 Daniel Veillard <daniel@veillard.com>
 
 	* tests/docs/Makefile.am tests/docs/bug-127.*

doc/html/index.sgml

@@ -65,6 +65,7 @@
 <ANCHOR id="xsltIf" href="libxslt/libxslt-transform.html#xsltIf">
 <ANCHOR id="xsltForEach" href="libxslt/libxslt-transform.html#xsltForEach">
 <ANCHOR id="xsltRegisterAllElement" href="libxslt/libxslt-transform.html#xsltRegisterAllElement">
+<ANCHOR id="xsltCopyTextString" href="libxslt/libxslt-transform.html#xsltCopyTextString">
 <ANCHOR id="xslHandleDebugger" href="libxslt/libxslt-transform.html#xslHandleDebugger">
 <ANCHOR id="XSLT-TODO-CAPS" href="libxslt/libxslt-xsltutils.html#XSLT-TODO-CAPS">
 <ANCHOR id="XSLT-STRANGE-CAPS" href="libxslt/libxslt-xsltutils.html#XSLT-STRANGE-CAPS">
@@ -150,6 +151,7 @@
 <ANCHOR id="xsltFreeCtxtExts" href="libxslt/libxslt-extensions.html#xsltFreeCtxtExts">
 <ANCHOR id="xsltFreeExts" href="libxslt/libxslt-extensions.html#xsltFreeExts">
 <ANCHOR id="xsltPreComputeExtModuleElement" href="libxslt/libxslt-extensions.html#xsltPreComputeExtModuleElement">
+<ANCHOR id="xsltGetExtInfo" href="libxslt/libxslt-extensions.html#xsltGetExtInfo">
 <ANCHOR id="xsltRegisterTestModule" href="libxslt/libxslt-extensions.html#xsltRegisterTestModule">
 <ANCHOR id="xsltDebugDumpExtensions" href="libxslt/libxslt-extensions.html#xsltDebugDumpExtensions">
 <ANCHOR id="xsltNamespaceAlias" href="libxslt/libxslt-namespaces.html#xsltNamespaceAlias">

doc/html/libxslt-extensions.html

@@ -122,6 +122,8 @@ void        <a href="libxslt-extensions.html#xsltFreeExts">xsltFreeExts</a>
 <a href="libxslt-xsltInternals.html#xsltElemPreCompPtr">xsltElemPreCompPtr</a> <a href="libxslt-extensions.html#xsltPreComputeExtModuleElement">xsltPreComputeExtModuleElement</a>
                                             (<a href="libxslt-xsltInternals.html#xsltStylesheetPtr">xsltStylesheetPtr</a> style,
                                              <GTKDOCLINK xmlns="http://www.w3.org/TR/xhtml1/transitional" HREF="xmlNodePtr">xmlNodePtr</GTKDOCLINK> inst);
+<GTKDOCLINK xmlns="http://www.w3.org/TR/xhtml1/transitional" HREF="xmlHashTablePtr">xmlHashTablePtr</GTKDOCLINK> <a href="libxslt-extensions.html#xsltGetExtInfo">xsltGetExtInfo</a>              (<a href="libxslt-xsltInternals.html#xsltStylesheetPtr">xsltStylesheetPtr</a> style,
+                                             const <GTKDOCLINK xmlns="http://www.w3.org/TR/xhtml1/transitional" HREF="xmlChar">xmlChar</GTKDOCLINK> *URI);
 void        <a href="libxslt-extensions.html#xsltRegisterTestModule">xsltRegisterTestModule</a>          (void);
 void        <a href="libxslt-extensions.html#xsltDebugDumpExtensions">xsltDebugDumpExtensions</a>         (<GTKDOCLINK xmlns="http://www.w3.org/TR/xhtml1/transitional" HREF="FILE-CAPS">FILE</GTKDOCLINK> *output);
 </pre></div><div class="refsect1" lang="en"><h2>Description</h2><p>
@@ -405,6 +407,13 @@ Precomputes an extension module element</p><p>
 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>style</tt></i><EFBFBD>:</span></td><td>  the stylesheet
 </td></tr><tr><td><span class="term"><i><tt>inst</tt></i><EFBFBD>:</span></td><td>  the element node
 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>the precomputed data
+</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xsltGetExtInfo"></a>xsltGetExtInfo ()</h3><pre class="programlisting"><GTKDOCLINK xmlns="http://www.w3.org/TR/xhtml1/transitional" HREF="xmlHashTablePtr">xmlHashTablePtr</GTKDOCLINK> xsltGetExtInfo              (<a href="libxslt-xsltInternals.html#xsltStylesheetPtr">xsltStylesheetPtr</a> style,
+                                             const <GTKDOCLINK xmlns="http://www.w3.org/TR/xhtml1/transitional" HREF="xmlChar">xmlChar</GTKDOCLINK> *URI);</pre><p>
+looks up URI in extInfos of the stylesheet</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>style</tt></i><EFBFBD>:</span></td><td>  pointer to a stylesheet
+</td></tr><tr><td><span class="term"><i><tt>URI</tt></i><EFBFBD>:</span></td><td>    the namespace URI desired
+</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>a pointer to the hash table if found, else NULL
 </td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xsltRegisterTestModule"></a>xsltRegisterTestModule ()</h3><pre class="programlisting">void        xsltRegisterTestModule          (void);</pre><p>
 Registers the test module</p><p>
 

doc/html/libxslt-transform.html

@@ -141,6 +141,10 @@ void        <a href="libxslt-transform.html#xsltForEach">xsltForEach</a>
                                              <GTKDOCLINK xmlns="http://www.w3.org/TR/xhtml1/transitional" HREF="xmlNodePtr">xmlNodePtr</GTKDOCLINK> inst,
                                              <a href="libxslt-xsltInternals.html#xsltStylePreCompPtr">xsltStylePreCompPtr</a> comp);
 void        <a href="libxslt-transform.html#xsltRegisterAllElement">xsltRegisterAllElement</a>          (<a href="libxslt-xsltInternals.html#xsltTransformContextPtr">xsltTransformContextPtr</a> ctxt);
+<GTKDOCLINK xmlns="http://www.w3.org/TR/xhtml1/transitional" HREF="xmlNodePtr">xmlNodePtr</GTKDOCLINK>  <a href="libxslt-transform.html#xsltCopyTextString">xsltCopyTextString</a>              (<a href="libxslt-xsltInternals.html#xsltTransformContextPtr">xsltTransformContextPtr</a> ctxt,
+                                             <GTKDOCLINK xmlns="http://www.w3.org/TR/xhtml1/transitional" HREF="xmlNodePtr">xmlNodePtr</GTKDOCLINK> target,
+                                             const <GTKDOCLINK xmlns="http://www.w3.org/TR/xhtml1/transitional" HREF="xmlChar">xmlChar</GTKDOCLINK> *string,
+                                             int noescape);
 void        <a href="libxslt-transform.html#xslHandleDebugger">xslHandleDebugger</a>               (<GTKDOCLINK xmlns="http://www.w3.org/TR/xhtml1/transitional" HREF="xmlNodePtr">xmlNodePtr</GTKDOCLINK> cur,
                                              <GTKDOCLINK xmlns="http://www.w3.org/TR/xhtml1/transitional" HREF="xmlNodePtr">xmlNodePtr</GTKDOCLINK> node,
                                              <a href="libxslt-xsltInternals.html#xsltTemplatePtr">xsltTemplatePtr</a> templ,
@@ -456,6 +460,17 @@ Process the xslt for-each node on the source node</p><p>
 Registers all default XSLT elements in this context</p><p>
 
 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i><EFBFBD>:</span></td><td>  the XPath context
+</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xsltCopyTextString"></a>xsltCopyTextString ()</h3><pre class="programlisting"><GTKDOCLINK xmlns="http://www.w3.org/TR/xhtml1/transitional" HREF="xmlNodePtr">xmlNodePtr</GTKDOCLINK>  xsltCopyTextString              (<a href="libxslt-xsltInternals.html#xsltTransformContextPtr">xsltTransformContextPtr</a> ctxt,
+                                             <GTKDOCLINK xmlns="http://www.w3.org/TR/xhtml1/transitional" HREF="xmlNodePtr">xmlNodePtr</GTKDOCLINK> target,
+                                             const <GTKDOCLINK xmlns="http://www.w3.org/TR/xhtml1/transitional" HREF="xmlChar">xmlChar</GTKDOCLINK> *string,
+                                             int noescape);</pre><p>
+Create a text node</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i><EFBFBD>:</span></td><td>  a XSLT process context
+</td></tr><tr><td><span class="term"><i><tt>target</tt></i><EFBFBD>:</span></td><td>  the element where the text will be attached
+</td></tr><tr><td><span class="term"><i><tt>string</tt></i><EFBFBD>:</span></td><td>  the text string
+</td></tr><tr><td><span class="term"><i><tt>noescape</tt></i><EFBFBD>:</span></td><td>  should disable-escaping be activated for this text node.
+</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> a new xmlNodePtr, or NULL in case of error.
 </td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xslHandleDebugger"></a>xslHandleDebugger ()</h3><pre class="programlisting">void        xslHandleDebugger               (<GTKDOCLINK xmlns="http://www.w3.org/TR/xhtml1/transitional" HREF="xmlNodePtr">xmlNodePtr</GTKDOCLINK> cur,
                                              <GTKDOCLINK xmlns="http://www.w3.org/TR/xhtml1/transitional" HREF="xmlNodePtr">xmlNodePtr</GTKDOCLINK> node,
                                              <a href="libxslt-xsltInternals.html#xsltTemplatePtr">xsltTemplatePtr</a> templ,

doc/html/libxslt-xsltInternals.html

@@ -277,6 +277,13 @@ Data structure associated to a parsed document.</p><p>
     xmlDocPtr       tmpRVT;		/* list of RVT without persistance */
     xmlDocPtr       persistRVT;		/* list of persistant RVTs */
     int             ctxtflags;          /* context processing flags */
+
+    /*
+     * Speed optimization when coalescing text nodes
+     */
+    const xmlChar  *lasttext;		/* last text node content */
+    unsigned int    lasttsize;		/* last text node size */
+    unsigned int    lasttuse;		/* last text node use */
 };
 </pre><p>
 

doc/libxslt-api.xml

@@ -246,6 +246,7 @@
      <exports symbol='xsltComment'/>
      <exports symbol='xsltCopy'/>
      <exports symbol='xsltCopyOf'/>
+     <exports symbol='xsltCopyTextString'/>
      <exports symbol='xsltDocumentElem'/>
      <exports symbol='xsltElement'/>
      <exports symbol='xsltForEach'/>
@@ -284,6 +285,7 @@
      <exports symbol='xsltFreeCtxtExts'/>
      <exports symbol='xsltFreeExts'/>
      <exports symbol='xsltGetExtData'/>
+     <exports symbol='xsltGetExtInfo'/>
      <exports symbol='xsltInitCtxtExts'/>
      <exports symbol='xsltInitElemPreComp'/>
      <exports symbol='xsltNewElemPreComp'/>
@@ -751,7 +753,11 @@ informations are stored'/>
 *'/>
       <field name='tmpRVT' type='xmlDocPtr' info=' list of RVT without persistance'/>
       <field name='persistRVT' type='xmlDocPtr' info=' list of persistant RVTs'/>
-      <field name='ctxtflags' type='int' info=' context processing flags'/>
+      <field name='ctxtflags' type='int' info='* Speed optimization when coalescing text nodes
+*'/>
+      <field name='lasttext' type='const xmlChar *' info=' last text node content'/>
+      <field name='lasttsize' type='unsigned int' info=' last text node size'/>
+      <field name='lasttuse' type='unsigned int' info=' last text node use'/>
     </struct>
     <typedef name='xsltTransformContextPtr' file='xsltInternals' type='xsltTransformContext *'/>
     <typedef name='xsltTransformState' file='xsltInternals' type='enum'/>
@@ -1017,6 +1023,14 @@ informations are stored'/>
       <arg name='inst' type='xmlNodePtr' info='the xslt copy-of node'/>
       <arg name='comp' type='xsltStylePreCompPtr' info='precomputed information'/>
     </function>
+    <function name='xsltCopyTextString' file='transform'>
+      <info>Create a text node</info>
+      <return type='xmlNodePtr' info='a new xmlNodePtr, or NULL in case of error.'/>
+      <arg name='ctxt' type='xsltTransformContextPtr' info='a XSLT process context'/>
+      <arg name='target' type='xmlNodePtr' info='the element where the text will be attached'/>
+      <arg name='string' type='const xmlChar *' info='the text string'/>
+      <arg name='noescape' type='int' info='should disable-escaping be activated for this text node.'/>
+    </function>
     <function name='xsltCreateRVT' file='xsltInternals'>
       <info>Create a result value tree</info>
       <return type='xmlDocPtr' info='the result value tree or NULL in case of error'/>
@@ -1373,6 +1387,12 @@ informations are stored'/>
       <arg name='ctxt' type='xsltTransformContextPtr' info='an XSLT transformation context'/>
       <arg name='URI' type='const xmlChar *' info='the URI associated to the exension module'/>
     </function>
+    <function name='xsltGetExtInfo' file='extensions'>
+      <info>looks up URI in extInfos of the stylesheet</info>
+      <return type='xmlHashTablePtr' info='a pointer to the hash table if found, else NULL'/>
+      <arg name='style' type='xsltStylesheetPtr' info='pointer to a stylesheet'/>
+      <arg name='URI' type='const xmlChar *' info='the namespace URI desired'/>
+    </function>
     <function name='xsltGetKey' file='keys'>
       <info>Lookup a key</info>
       <return type='xmlNodeSetPtr' info='the nodeset resulting from the query or NULL'/>

doc/libxslt-decl.txt

@@ -330,6 +330,11 @@ xsltStylesheetPtr style
 xsltStylesheetPtr style,xmlNodePtr inst
 </FUNCTION>
 <FUNCTION>
+<NAME>xsltGetExtInfo</NAME>
+<RETURNS>xmlHashTablePtr  </RETURNS>
+xsltStylesheetPtr style, const xmlChar *URI
+</FUNCTION>
+<FUNCTION>
 <NAME>xsltRegisterTestModule</NAME>
 <RETURNS>void 	</RETURNS>
 void
@@ -820,6 +825,11 @@ xsltTransformContextPtr ctxt,xmlNodePtr node,xmlNodePtr inst,xsltStylePreCompPtr
 xsltTransformContextPtr ctxt
 </FUNCTION>
 <FUNCTION>
+<NAME>xsltCopyTextString</NAME>
+<RETURNS>xmlNodePtr 	</RETURNS>
+xsltTransformContextPtr ctxt,xmlNodePtr target,const xmlChar *string,int noescape
+</FUNCTION>
+<FUNCTION>
 <NAME>xslHandleDebugger</NAME>
 <RETURNS>void 	</RETURNS>
 xmlNodePtr cur,xmlNodePtr node,xsltTemplatePtr templ,xsltTransformContextPtr ctxt
@@ -1753,6 +1763,13 @@ struct xsltTransformContext {
     xmlDocPtr       tmpRVT;		/* list of RVT without persistance */
     xmlDocPtr       persistRVT;		/* list of persistant RVTs */
     int             ctxtflags;          /* context processing flags */
+
+    /*
+     * Speed optimization when coalescing text nodes
+     */
+    const xmlChar  *lasttext;		/* last text node content */
+    unsigned int    lasttsize;		/* last text node size */
+    unsigned int    lasttuse;		/* last text node use */
 };
 </STRUCT>
 <MACRO>

doc/libxslt-sections.txt

@@ -81,6 +81,7 @@ xsltInitCtxtExts
 xsltFreeCtxtExts
 xsltFreeExts
 xsltPreComputeExtModuleElement
+xsltGetExtInfo
 xsltRegisterTestModule
 xsltDebugDumpExtensions
 </SECTION>
@@ -212,6 +213,7 @@ xsltChoose
 xsltIf
 xsltForEach
 xsltRegisterAllElement
+xsltCopyTextString
 xslHandleDebugger
 </SECTION>