diff options
author | Nick Wellnhofer <wellnhofer@aevum.de> | 2022-02-13 22:52:53 +0100 |
---|---|---|
committer | Nick Wellnhofer <wellnhofer@aevum.de> | 2022-02-13 23:10:00 +0100 |
commit | 1089111142e7df96e14b2113235860cc4e7fa54e (patch) | |
tree | fb6f04ae2efc156046338fd2a352b83d05baa1e1 /doc/tutorial | |
parent | 4f2693a1efb499c18d909149b8141f40c190fc2f (diff) | |
download | libxml2-1089111142e7df96e14b2113235860cc4e7fa54e.tar.gz |
Redirect links to xmlsoft.org
Documentation and releases are now available on gitlab.gnome.org.
Diffstat (limited to 'doc/tutorial')
-rw-r--r-- | doc/tutorial/ar01s02.html | 10 | ||||
-rw-r--r-- | doc/tutorial/ar01s04.html | 4 | ||||
-rw-r--r-- | doc/tutorial/ar01s05.html | 2 | ||||
-rw-r--r-- | doc/tutorial/ar01s06.html | 2 | ||||
-rw-r--r-- | doc/tutorial/ar01s07.html | 2 | ||||
-rw-r--r-- | doc/tutorial/ar01s08.html | 2 | ||||
-rw-r--r-- | doc/tutorial/index.html | 2 | ||||
-rw-r--r-- | doc/tutorial/xmltutorial.xml | 28 |
8 files changed, 26 insertions, 26 deletions
diff --git a/doc/tutorial/ar01s02.html b/doc/tutorial/ar01s02.html index 1e30a98b..8aebcec3 100644 --- a/doc/tutorial/ar01s02.html +++ b/doc/tutorial/ar01s02.html @@ -2,13 +2,13 @@ will encounter repeatedly, hiding the messy stuff so you do not have to deal with it unless you have some specific need.</p><p> </p><div class="variablelist"><dl><dt><span class="term"><a class="indexterm" name="id2526186"></a> -<a href="http://xmlsoft.org/html/libxml-tree.html#XMLCHAR" target="_top">xmlChar</a></span></dt><dd><p>A basic replacement for char, a byte in a UTF-8 encoded +<a href="https://gnome.pages.gitlab.gnome.org/libxml2/devhelp/libxml2-tree.html#XMLCHAR" target="_top">xmlChar</a></span></dt><dd><p>A basic replacement for char, a byte in a UTF-8 encoded string. If your data uses another encoding, it must be converted to UTF-8 for use with <span class="application">libxml's</span> - functions. More information on encoding is available on the <a href="http://www.xmlsoft.org/encoding.html" target="_top"><span class="application">libxml</span> encoding support web page</a>.</p></dd><dt><span class="term"><a class="indexterm" name="id2526232"></a> - <a href="http://xmlsoft.org/html/libxml-tree.html#XMLDOC" target="_top">xmlDoc</a></span></dt><dd><p>A structure containing the tree created by a parsed doc. <a href="http://xmlsoft.org/html/libxml-tree.html#XMLDOCPTR" target="_top">xmlDocPtr</a> + functions. More information on encoding is available on the <a href="https://gitlab.gnome.org/GNOME/libxml2/-/wikis/Encodings-support" target="_top"><span class="application">libxml</span> encoding support web page</a>.</p></dd><dt><span class="term"><a class="indexterm" name="id2526232"></a> + <a href="https://gnome.pages.gitlab.gnome.org/libxml2/devhelp/libxml2-tree.html#XMLDOC" target="_top">xmlDoc</a></span></dt><dd><p>A structure containing the tree created by a parsed doc. <a href="https://gnome.pages.gitlab.gnome.org/libxml2/devhelp/libxml2-tree.html#XMLDOCPTR" target="_top">xmlDocPtr</a> is a pointer to the structure.</p></dd><dt><span class="term"><a class="indexterm" name="id2526266"></a> -<a href="http://xmlsoft.org/html/libxml-tree.html#XMLNODEPTR" target="_top">xmlNodePtr</a> - and <a href="http://xmlsoft.org/html/libxml-tree.html#XMLNODE" target="_top">xmlNode</a></span></dt><dd><p>A structure containing a single node. <a href="http://xmlsoft.org/html/libxml-tree.html#XMLNODEPTR" target="_top">xmlNodePtr</a> +<a href="https://gnome.pages.gitlab.gnome.org/libxml2/devhelp/libxml2-tree.html#XMLNODEPTR" target="_top">xmlNodePtr</a> + and <a href="https://gnome.pages.gitlab.gnome.org/libxml2/devhelp/libxml2-tree.html#XMLNODE" target="_top">xmlNode</a></span></dt><dd><p>A structure containing a single node. <a href="https://gnome.pages.gitlab.gnome.org/libxml2/devhelp/libxml2-tree.html#XMLNODEPTR" target="_top">xmlNodePtr</a> is a pointer to the structure, and is used in traversing the document tree.</p></dd></dl></div><p> </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="index.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="index.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ar01s03.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Libxml Tutorial </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Parsing the file</td></tr></table></div></body></html> diff --git a/doc/tutorial/ar01s04.html b/doc/tutorial/ar01s04.html index 11492ebf..1acad38e 100644 --- a/doc/tutorial/ar01s04.html +++ b/doc/tutorial/ar01s04.html @@ -23,7 +23,7 @@ Retrieving the content of an element involves traversing the document is the element that will contain the "keywords" we are looking for. It uses the <span class="application">libxml</span> string comparison - function, <tt class="function"><a href="http://xmlsoft.org/html/libxml-parser.html#XMLSTRCMP" target="_top">xmlStrcmp</a></tt>. If there is a match, it calls the function <tt class="function">parseStory</tt>.</p></td></tr></table></div><p> + function, <tt class="function"><a href="https://gnome.pages.gitlab.gnome.org/libxml2/devhelp/libxml2-parser.html#XMLSTRCMP" target="_top">xmlStrcmp</a></tt>. If there is a match, it calls the function <tt class="function">parseStory</tt>.</p></td></tr></table></div><p> </p><p> </p><pre class="programlisting"> void @@ -48,7 +48,7 @@ parseStory (xmlDocPtr doc, xmlNodePtr cur) { its contents. Remember that in <span class="acronym">XML</span>, the text contained within an element is a child node of that element, so we turn to <tt class="varname">cur->xmlChildrenNode</tt>. To retrieve it, we - use the function <tt class="function"><a href="http://xmlsoft.org/html/libxml-tree.html#XMLNODELISTGETSTRING" target="_top">xmlNodeListGetString</a></tt>, which also takes the <tt class="varname">doc</tt> pointer as an argument. In this case, we just print it out.</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="images/note.png"></td><th align="left">Note</th></tr><tr><td colspan="2" align="left" valign="top"><p>Because <tt class="function">xmlNodeListGetString</tt> allocates + use the function <tt class="function"><a href="https://gnome.pages.gitlab.gnome.org/libxml2/devhelp/libxml2-tree.html#XMLNODELISTGETSTRING" target="_top">xmlNodeListGetString</a></tt>, which also takes the <tt class="varname">doc</tt> pointer as an argument. In this case, we just print it out.</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="images/note.png"></td><th align="left">Note</th></tr><tr><td colspan="2" align="left" valign="top"><p>Because <tt class="function">xmlNodeListGetString</tt> allocates memory for the string it returns, you must use <tt class="function">xmlFree</tt> to free it.</p></td></tr></table></div></td></tr></table></div><p> </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ar01s03.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="index.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ar01s05.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Parsing the file </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Using XPath to Retrieve Element Content</td></tr></table></div></body></html> diff --git a/doc/tutorial/ar01s05.html b/doc/tutorial/ar01s05.html index 1c409252..919d4544 100644 --- a/doc/tutorial/ar01s05.html +++ b/doc/tutorial/ar01s05.html @@ -2,7 +2,7 @@ <span class="application">Libxml2</span> includes support for use of <span class="application">XPath</span> expressions to retrieve sets of nodes that match a specified criteria. Full documentation of the - <span class="application">XPath</span> <span class="acronym">API</span> is <a href="http://xmlsoft.org/html/libxml-xpath.html" target="_top">here</a>. + <span class="application">XPath</span> <span class="acronym">API</span> is <a href="https://gnome.pages.gitlab.gnome.org/libxml2/devhelp/libxml2-xpath.html" target="_top">here</a>. </p><p><span class="application">XPath</span> allows searching through a document for nodes that match specified criteria. In the example below we search through a document for the contents of all <tt class="varname">keyword</tt> diff --git a/doc/tutorial/ar01s06.html b/doc/tutorial/ar01s06.html index c09e6efb..c710b98a 100644 --- a/doc/tutorial/ar01s06.html +++ b/doc/tutorial/ar01s06.html @@ -16,7 +16,7 @@ parseStory (xmlDocPtr doc, xmlNodePtr cur, char *keyword) { return; } </pre><p> - </p><div class="calloutlist"><table border="0" summary="Callout list"><tr><td width="5%" valign="top" align="left"><a href="#addkeyword"><img src="images/callouts/1.png" alt="1" border="0"></a> </td><td valign="top" align="left"><p>The <tt class="function"><a href="http://xmlsoft.org/html/libxml-tree.html#XMLNEWTEXTCHILD" target="_top">xmlNewTextChild</a></tt> + </p><div class="calloutlist"><table border="0" summary="Callout list"><tr><td width="5%" valign="top" align="left"><a href="#addkeyword"><img src="images/callouts/1.png" alt="1" border="0"></a> </td><td valign="top" align="left"><p>The <tt class="function"><a href="https://gnome.pages.gitlab.gnome.org/libxml2/devhelp/libxml2-tree.html#XMLNEWTEXTCHILD" target="_top">xmlNewTextChild</a></tt> function adds a new child element at the current node pointer's location in the tree, specified by <tt class="varname">cur</tt>.</p></td></tr></table></div><p> diff --git a/doc/tutorial/ar01s07.html b/doc/tutorial/ar01s07.html index fd5c4dd9..89e0bdbd 100644 --- a/doc/tutorial/ar01s07.html +++ b/doc/tutorial/ar01s07.html @@ -25,6 +25,6 @@ Writing an attribute is similar to writing text to a new element. In <a name="addattributenode"></a><img src="images/callouts/2.png" alt="2" border="0"> newattr = xmlNewProp (newnode, "uri", uri); </pre><p> </p><div class="calloutlist"><table border="0" summary="Callout list"><tr><td width="5%" valign="top" align="left"><a href="#addreferencenode"><img src="images/callouts/1.png" alt="1" border="0"></a> </td><td valign="top" align="left"><p>First we add a new node at the location of the current node - pointer, <tt class="varname">cur.</tt> using the <a href="http://xmlsoft.org/html/libxml-tree.html#XMLNEWTEXTCHILD" target="_top">xmlNewTextChild</a> function.</p></td></tr></table></div><p> + pointer, <tt class="varname">cur.</tt> using the <a href="https://gnome.pages.gitlab.gnome.org/libxml2/devhelp/libxml2-tree.html#XMLNEWTEXTCHILD" target="_top">xmlNewTextChild</a> function.</p></td></tr></table></div><p> </p><p>Once the node is added, the file is written to disk just as in the previous example in which we added an element with text content.</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ar01s06.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="index.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ar01s08.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Writing element content </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Retrieving Attributes</td></tr></table></div></body></html> diff --git a/doc/tutorial/ar01s08.html b/doc/tutorial/ar01s08.html index 758f8116..d0f227e5 100644 --- a/doc/tutorial/ar01s08.html +++ b/doc/tutorial/ar01s08.html @@ -26,7 +26,7 @@ getReference (xmlDocPtr doc, xmlNodePtr cur) { </pre><p> </p><div class="calloutlist"><table border="0" summary="Callout list"><tr><td width="5%" valign="top" align="left"><a href="#getattributevalue"><img src="images/callouts/1.png" alt="1" border="0"></a> </td><td valign="top" align="left"><p> - The key function is <tt class="function"><a href="http://xmlsoft.org/html/libxml-tree.html#XMLGETPROP" target="_top">xmlGetProp</a></tt>, which returns an + The key function is <tt class="function"><a href="https://gnome.pages.gitlab.gnome.org/libxml2/devhelp/libxml2-tree.html#XMLGETPROP" target="_top">xmlGetProp</a></tt>, which returns an <tt class="varname">xmlChar</tt> containing the attribute's value. In this case, we just print it out. </p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="images/note.png"></td><th align="left">Note</th></tr><tr><td colspan="2" align="left" valign="top"><p> diff --git a/doc/tutorial/index.html b/doc/tutorial/index.html index 51fd4818..8fb5897d 100644 --- a/doc/tutorial/index.html +++ b/doc/tutorial/index.html @@ -2,7 +2,7 @@ <span class="acronym">XML</span>, portable across a large number of platforms. This tutorial provides examples of its basic functions.</p></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="introduction"></a>Introduction</h2></div></div><div></div></div><p>Libxml is a C language library implementing functions for reading, creating and manipulating <span class="acronym">XML</span> data. This tutorial - provides example code and explanations of its basic functionality.</p><p>Libxml and more details about its use are available on <a href="http://www.xmlsoft.org/" target="_top">the project home page</a>. Included there is complete <a href="http://xmlsoft.org/html/libxml-lib.html" target="_top"> + provides example code and explanations of its basic functionality.</p><p>Libxml and more details about its use are available on <a href="https://gitlab.gnome.org/GNOME/libxml2" target="_top">the project home page</a>. Included there is complete <a href="https://gnome.pages.gitlab.gnome.org/libxml2/devhelp/general.html" target="_top"> <span class="acronym">API</span> documentation</a>. This tutorial is not meant to substitute for that complete documentation, but to illustrate the functions needed to use the library to perform basic operations. diff --git a/doc/tutorial/xmltutorial.xml b/doc/tutorial/xmltutorial.xml index c8edecb9..08bcd5be 100644 --- a/doc/tutorial/xmltutorial.xml +++ b/doc/tutorial/xmltutorial.xml @@ -85,7 +85,7 @@ creating and manipulating <acronym>XML</acronym> data. This tutorial provides example code and explanations of its basic functionality.</para> <para>Libxml and more details about its use are available on <ulink - url="http://www.xmlsoft.org/">the project home page</ulink>. Included there is complete <ulink url="http://xmlsoft.org/html/libxml-lib.html"> + url="https://gitlab.gnome.org/GNOME/libxml2">the project home page</ulink>. Included there is complete <ulink url="https://gnome.pages.gitlab.gnome.org/libxml2/devhelp/general.html"> <acronym>API</acronym> documentation</ulink>. This tutorial is not meant to substitute for that complete documentation, but to illustrate the functions needed to use the library to perform basic operations. @@ -132,23 +132,23 @@ <primary>xmlChar</primary> </indexterm> <ulink - url="http://xmlsoft.org/html/libxml-tree.html#XMLCHAR">xmlChar</ulink></term> + url="https://gnome.pages.gitlab.gnome.org/libxml2/devhelp/libxml2-tree.html#XMLCHAR">xmlChar</ulink></term> <listitem> <para>A basic replacement for char, a byte in a UTF-8 encoded string. If your data uses another encoding, it must be converted to UTF-8 for use with <application>libxml's</application> functions. More information on encoding is available on the <ulink - url="http://www.xmlsoft.org/encoding.html"><application>libxml</application> encoding support web page</ulink>.</para> + url="https://gitlab.gnome.org/GNOME/libxml2/-/wikis/Encodings-support"><application>libxml</application> encoding support web page</ulink>.</para> </listitem> </varlistentry> <varlistentry> <term><indexterm> <primary>xmlDoc</primary> </indexterm> - <ulink url="http://xmlsoft.org/html/libxml-tree.html#XMLDOC">xmlDoc</ulink></term> + <ulink url="https://gnome.pages.gitlab.gnome.org/libxml2/devhelp/libxml2-tree.html#XMLDOC">xmlDoc</ulink></term> <listitem> <para>A structure containing the tree created by a parsed doc. <ulink - url="http://xmlsoft.org/html/libxml-tree.html#XMLDOCPTR">xmlDocPtr</ulink> + url="https://gnome.pages.gitlab.gnome.org/libxml2/devhelp/libxml2-tree.html#XMLDOCPTR">xmlDocPtr</ulink> is a pointer to the structure.</para> </listitem> </varlistentry> @@ -157,11 +157,11 @@ <primary>xmlNodePtr</primary> </indexterm> <ulink - url="http://xmlsoft.org/html/libxml-tree.html#XMLNODEPTR">xmlNodePtr</ulink> - and <ulink url="http://xmlsoft.org/html/libxml-tree.html#XMLNODE">xmlNode</ulink></term> + url="https://gnome.pages.gitlab.gnome.org/libxml2/devhelp/libxml2-tree.html#XMLNODEPTR">xmlNodePtr</ulink> + and <ulink url="https://gnome.pages.gitlab.gnome.org/libxml2/devhelp/libxml2-tree.html#XMLNODE">xmlNode</ulink></term> <listitem> <para>A structure containing a single node. <ulink - url="http://xmlsoft.org/html/libxml-tree.html#XMLNODEPTR">xmlNodePtr</ulink> + url="https://gnome.pages.gitlab.gnome.org/libxml2/devhelp/libxml2-tree.html#XMLNODEPTR">xmlNodePtr</ulink> is a pointer to the structure, and is used in traversing the document tree.</para> </listitem> </varlistentry> @@ -288,7 +288,7 @@ Retrieving the content of an element involves traversing the document looking for. It uses the <application>libxml</application> string comparison function, <function><ulink - url="http://xmlsoft.org/html/libxml-parser.html#XMLSTRCMP">xmlStrcmp</ulink></function>. If there is a match, it calls the function <function>parseStory</function>.</para> + url="https://gnome.pages.gitlab.gnome.org/libxml2/devhelp/libxml2-parser.html#XMLSTRCMP">xmlStrcmp</ulink></function>. If there is a match, it calls the function <function>parseStory</function>.</para> </callout> </calloutlist> </para> @@ -326,7 +326,7 @@ parseStory (xmlDocPtr doc, xmlNodePtr cur) { contained within an element is a child node of that element, so we turn to <varname>cur->xmlChildrenNode</varname>. To retrieve it, we use the function <function><ulink - url="http://xmlsoft.org/html/libxml-tree.html#XMLNODELISTGETSTRING">xmlNodeListGetString</ulink></function>, which also takes the <varname>doc</varname> pointer as an argument. In this case, we just print it out.</para> + url="https://gnome.pages.gitlab.gnome.org/libxml2/devhelp/libxml2-tree.html#XMLNODELISTGETSTRING">xmlNodeListGetString</ulink></function>, which also takes the <varname>doc</varname> pointer as an argument. In this case, we just print it out.</para> <note> <para>Because <function>xmlNodeListGetString</function> allocates memory for the string it returns, you must use @@ -344,7 +344,7 @@ parseStory (xmlDocPtr doc, xmlNodePtr cur) { use of <application>XPath</application> expressions to retrieve sets of nodes that match a specified criteria. Full documentation of the <application>XPath</application> <acronym>API</acronym> is <ulink - url="http://xmlsoft.org/html/libxml-xpath.html">here</ulink>. + url="https://gnome.pages.gitlab.gnome.org/libxml2/devhelp/libxml2-xpath.html">here</ulink>. </para> <para><application>XPath</application> allows searching through a document for nodes that match specified criteria. In the example below we search @@ -452,7 +452,7 @@ parseStory (xmlDocPtr doc, xmlNodePtr cur, char *keyword) { <calloutlist> <callout arearefs="addkeyword"> <para>The <function><ulink - url="http://xmlsoft.org/html/libxml-tree.html#XMLNEWTEXTCHILD">xmlNewTextChild</ulink></function> + url="https://gnome.pages.gitlab.gnome.org/libxml2/devhelp/libxml2-tree.html#XMLNEWTEXTCHILD">xmlNewTextChild</ulink></function> function adds a new child element at the current node pointer's location in the tree, specified by <varname>cur</varname>.</para> @@ -515,7 +515,7 @@ Writing an attribute is similar to writing text to a new element. In <callout arearefs="addreferencenode"> <para>First we add a new node at the location of the current node pointer, <varname>cur.</varname> using the <ulink - url="http://xmlsoft.org/html/libxml-tree.html#XMLNEWTEXTCHILD">xmlNewTextChild</ulink> function.</para> + url="https://gnome.pages.gitlab.gnome.org/libxml2/devhelp/libxml2-tree.html#XMLNEWTEXTCHILD">xmlNewTextChild</ulink> function.</para> </callout> </calloutlist> </para> @@ -562,7 +562,7 @@ getReference (xmlDocPtr doc, xmlNodePtr cur) { <callout arearefs="getattributevalue"> <para> The key function is <function><ulink - url="http://xmlsoft.org/html/libxml-tree.html#XMLGETPROP">xmlGetProp</ulink></function>, which returns an + url="https://gnome.pages.gitlab.gnome.org/libxml2/devhelp/libxml2-tree.html#XMLGETPROP">xmlGetProp</ulink></function>, which returns an <varname>xmlChar</varname> containing the attribute's value. In this case, we just print it out. <note> |