revuilt the API and docs Daniel

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

diff --git a/ChangeLog b/ChangeLog
index 5d3d515..b9194ed 100644 (file)
--- a/ChangeLog
+++ b/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.*

diff --git a/doc/html/index.sgml b/doc/html/index.sgml
index 993ba1b..d8035fb 100644 (file)
--- a/doc/html/index.sgml
+++ b/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">

diff --git a/doc/html/libxslt-extensions.html b/doc/html/libxslt-extensions.html
index 5d54890..4dad519 100644 (file)
--- a/doc/html/libxslt-extensions.html
+++ b/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> :</span></td><td>  the stylesheet
 </td></tr><tr><td><span class="term"><i><tt>inst</tt></i> :</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> :</span></td><td>  pointer to a stylesheet
+</td></tr><tr><td><span class="term"><i><tt>URI</tt></i> :</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>
 

diff --git a/doc/html/libxslt-transform.html b/doc/html/libxslt-transform.html
index e3a9bbb..3f9e21f 100644 (file)
--- a/doc/html/libxslt-transform.html
+++ b/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> :</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> :</span></td><td>  a XSLT process context
+</td></tr><tr><td><span class="term"><i><tt>target</tt></i> :</span></td><td>  the element where the text will be attached
+</td></tr><tr><td><span class="term"><i><tt>string</tt></i> :</span></td><td>  the text string
+</td></tr><tr><td><span class="term"><i><tt>noescape</tt></i> :</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,

diff --git a/doc/html/libxslt-xsltInternals.html b/doc/html/libxslt-xsltInternals.html
index 4971f18..097c40f 100644 (file)
--- a/doc/html/libxslt-xsltInternals.html
+++ b/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>
 

diff --git a/doc/libxslt-api.xml b/doc/libxslt-api.xml
index 7df912c..660dcb5 100644 (file)
--- a/doc/libxslt-api.xml
+++ b/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'/>

diff --git a/doc/libxslt-decl.txt b/doc/libxslt-decl.txt
index 6388b5c..d6fd6ba 100644 (file)
--- a/doc/libxslt-decl.txt
+++ b/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>

diff --git a/doc/libxslt-sections.txt b/doc/libxslt-sections.txt
index 92920a6..2add42e 100644 (file)
--- a/doc/libxslt-sections.txt
+++ b/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>