RubyGems - rsvg2 - Versions diffs - 1.1.5-x86-mingw32 → 1.1.6-x86-mingw32 - Mend

rsvg2 1.1.5-x86-mingw32 → 1.1.6-x86-mingw32

Files changed (224) hide show

data/vendor/local/share/doc/libxml2-2.9.0/html/tutorial/ar01s08.html ADDED

@@ -0,0 +1,38 @@
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Retrieving Attributes</title><meta name="generator" content="DocBook XSL Stylesheets V1.61.2"><link rel="home" href="index.html" title="Libxml Tutorial"><link rel="up" href="index.html" title="Libxml Tutorial"><link rel="previous" href="ar01s07.html" title="Writing Attribute"><link rel="next" href="ar01s09.html" title="Encoding Conversion"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Retrieving Attributes</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ar01s07.html">Prev</a>�</td><th width="60%" align="center">�</th><td width="20%" align="right">�<a accesskey="n" href="ar01s09.html">Next</a></td></tr></table><hr></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="xmltutorialattribute"></a>Retrieving Attributes</h2></div></div><div></div></div><p><a class="indexterm" name="id2587236"></a>
+Retrieving the value of an attribute is similar to the previous
+    example in which we retrieved a node's text contents. In this case we'll
+      extract the value of the <span class="acronym">URI</span> we added in the previous
+      section. Full code: <a href="apg.html" title="G.�Code for Retrieving Attribute Value Example">Appendix�G, <i>Code for Retrieving Attribute Value Example</i></a>.</p><p>
+      The initial steps for this example are similar to the previous ones: parse
+      the doc, find the element you are interested in, then enter a function to
+      carry out the specific task required. In this case, we call
+      <tt class="function">getReference</tt>:
+      </p><pre class="programlisting">
+void
+getReference (xmlDocPtr doc, xmlNodePtr cur) {
+	xmlChar *uri;
+	cur = cur-&gt;xmlChildrenNode;
+	while (cur != NULL) {
+	    if ((!xmlStrcmp(cur-&gt;name, (const xmlChar *)"reference"))) {
+		   <a name="getattributevalue"></a><img src="images/callouts/1.png" alt="1" border="0"> uri = xmlGetProp(cur, "uri");
+		    printf("uri: %s\n", uri);
+		    xmlFree(uri);
+	    }
+	    cur = cur-&gt;next;
+	}
+	return;
+}
+      </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
+      <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>
+	  If you are using a <span class="acronym">DTD</span> that declares a fixed or
+	  default value for the attribute, this function will retrieve it.
+	</p></td></tr></table></div><p>
+	  </p></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="ar01s07.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="ar01s09.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Writing Attribute�</td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top">�Encoding Conversion</td></tr></table></div></body></html>

data/vendor/local/share/doc/libxml2-2.9.0/html/tutorial/ar01s09.html ADDED

@@ -0,0 +1,63 @@
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Encoding Conversion</title><meta name="generator" content="DocBook XSL Stylesheets V1.61.2"><link rel="home" href="index.html" title="Libxml Tutorial"><link rel="up" href="index.html" title="Libxml Tutorial"><link rel="previous" href="ar01s08.html" title="Retrieving Attributes"><link rel="next" href="apa.html" title="A.�Compilation"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Encoding Conversion</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ar01s08.html">Prev</a>�</td><th width="60%" align="center">�</th><td width="20%" align="right">�<a accesskey="n" href="apa.html">Next</a></td></tr></table><hr></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="xmltutorialconvert"></a>Encoding Conversion</h2></div></div><div></div></div><p><a class="indexterm" name="id2587348"></a>
+Data encoding compatibility problems are one of the most common
+      difficulties encountered by programmers new to <span class="acronym">XML</span> in
+      general and <span class="application">libxml</span> in particular. Thinking
+      through the design of your application in light of this issue will help
+      avoid difficulties later. Internally, <span class="application">libxml</span>
+      stores and manipulates data in the UTF-8 format. Data used by your program
+      in other formats, such as the commonly used ISO-8859-1 encoding, must be
+      converted to UTF-8 before passing it to <span class="application">libxml</span>
+      functions. If you want your program's output in an encoding other than
+      UTF-8, you also must convert it.</p><p><span class="application">Libxml</span> uses
+      <span class="application">iconv</span> if it is available to convert
+    data. Without <span class="application">iconv</span>, only UTF-8, UTF-16 and
+    ISO-8859-1 can be used as external formats. With
+    <span class="application">iconv</span>, any format can be used provided
+    <span class="application">iconv</span> is able to convert it to and from
+    UTF-8. Currently <span class="application">iconv</span> supports about 150
+    different character formats with ability to convert from any to any. While
+    the actual number of supported formats varies between implementations, every
+    <span class="application">iconv</span> implementation is almost guaranteed to
+    support every format anyone has ever heard of.</p><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="images/warning.png"></td><th align="left">Warning</th></tr><tr><td colspan="2" align="left" valign="top"><p>A common mistake is to use different formats for the internal data
+	in different parts of one's code. The most common case is an application
+	that assumes ISO-8859-1 to be the internal data format, combined with
+	<span class="application">libxml</span>, which assumes UTF-8 to be the
+	internal data format. The result is an application that treats internal
+	data differently, depending on which code section is executing. The one or
+	the other part of code will then, naturally, misinterpret the data.
+      </p></td></tr></table></div><p>This example constructs a simple document, then adds content provided
+    at the command line to the document's root element and outputs the results
+    to <tt class="filename">stdout</tt> in the proper encoding. For this example, we
+    use ISO-8859-1 encoding. The encoding of the string input at the command
+    line is converted from ISO-8859-1 to UTF-8. Full code: <a href="aph.html" title="H.�Code for Encoding Conversion Example">Appendix�H, <i>Code for Encoding Conversion Example</i></a></p><p>The conversion, encapsulated in the example code in the
+      <tt class="function">convert</tt> function, uses
+      <span class="application">libxml's</span>
+    <tt class="function">xmlFindCharEncodingHandler</tt> function:
+      </p><pre class="programlisting">
+	<a name="handlerdatatype"></a><img src="images/callouts/1.png" alt="1" border="0">xmlCharEncodingHandlerPtr handler;
+        <a name="calcsize"></a><img src="images/callouts/2.png" alt="2" border="0">size = (int)strlen(in)+1;
+        out_size = size*2-1;
+        out = malloc((size_t)out_size);
+&#8230;
+	<a name="findhandlerfunction"></a><img src="images/callouts/3.png" alt="3" border="0">handler = xmlFindCharEncodingHandler(encoding);
+&#8230;
+	<a name="callconversionfunction"></a><img src="images/callouts/4.png" alt="4" border="0">handler-&gt;input(out, &amp;out_size, in, &amp;temp);
+&#8230;
+	<a name="outputencoding"></a><img src="images/callouts/5.png" alt="5" border="0">xmlSaveFormatFileEnc("-", doc, encoding, 1);
+      </pre><p>
+      </p><div class="calloutlist"><table border="0" summary="Callout list"><tr><td width="5%" valign="top" align="left"><a href="#handlerdatatype"><img src="images/callouts/1.png" alt="1" border="0"></a> </td><td valign="top" align="left"><p><tt class="varname">handler</tt> is declared as a pointer to an
+	    <tt class="function">xmlCharEncodingHandler</tt> function.</p></td></tr><tr><td width="5%" valign="top" align="left"><a href="#calcsize"><img src="images/callouts/2.png" alt="2" border="0"></a> </td><td valign="top" align="left"><p>The <tt class="function">xmlCharEncodingHandler</tt> function needs
+	  to be given the size of the input and output strings, which are
+	    calculated here for strings <tt class="varname">in</tt> and
+	  <tt class="varname">out</tt>.</p></td></tr><tr><td width="5%" valign="top" align="left"><a href="#findhandlerfunction"><img src="images/callouts/3.png" alt="3" border="0"></a> </td><td valign="top" align="left"><p><tt class="function">xmlFindCharEncodingHandler</tt> takes as its
+	    argument the data's initial encoding and searches
+	    <span class="application">libxml's</span> built-in set of conversion
+	    handlers, returning a pointer to the function or NULL if none is
+	    found.</p></td></tr><tr><td width="5%" valign="top" align="left"><a href="#callconversionfunction"><img src="images/callouts/4.png" alt="4" border="0"></a> </td><td valign="top" align="left"><p>The conversion function identified by <tt class="varname">handler</tt>
+	  requires as its arguments pointers to the input and output strings,
+	  along with the length of each. The lengths must be determined
+	  separately by the application.</p></td></tr><tr><td width="5%" valign="top" align="left"><a href="#outputencoding"><img src="images/callouts/5.png" alt="5" border="0"></a> </td><td valign="top" align="left"><p>To output in a specified encoding rather than UTF-8, we use
+	    <tt class="function">xmlSaveFormatFileEnc</tt>, specifying the
+	    encoding.</p></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="ar01s08.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="apa.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Retrieving Attributes�</td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top">�A.�Compilation</td></tr></table></div></body></html>

data/vendor/local/share/doc/libxml2-2.9.0/html/tutorial/images/blank.png ADDED

Binary file

data/vendor/local/share/doc/libxml2-2.9.0/html/tutorial/images/callouts/1.png ADDED

Binary file

data/vendor/local/share/doc/libxml2-2.9.0/html/tutorial/images/callouts/10.png ADDED

Binary file

data/vendor/local/share/doc/libxml2-2.9.0/html/tutorial/images/callouts/2.png ADDED

Binary file

data/vendor/local/share/doc/libxml2-2.9.0/html/tutorial/images/callouts/3.png ADDED

Binary file

data/vendor/local/share/doc/libxml2-2.9.0/html/tutorial/images/callouts/4.png ADDED

Binary file

data/vendor/local/share/doc/libxml2-2.9.0/html/tutorial/images/callouts/5.png ADDED

Binary file

data/vendor/local/share/doc/libxml2-2.9.0/html/tutorial/images/callouts/6.png ADDED

Binary file

data/vendor/local/share/doc/libxml2-2.9.0/html/tutorial/images/callouts/7.png ADDED

Binary file

data/vendor/local/share/doc/libxml2-2.9.0/html/tutorial/images/callouts/8.png ADDED

Binary file

data/vendor/local/share/doc/libxml2-2.9.0/html/tutorial/images/callouts/9.png ADDED

Binary file

data/vendor/local/share/doc/libxml2-2.9.0/html/tutorial/images/caution.png ADDED

Binary file

data/vendor/local/share/doc/libxml2-2.9.0/html/tutorial/images/draft.png ADDED

Binary file

data/vendor/local/share/doc/libxml2-2.9.0/html/tutorial/images/home.png ADDED

Binary file

data/vendor/local/share/doc/libxml2-2.9.0/html/tutorial/images/important.png ADDED

Binary file

data/vendor/local/share/doc/libxml2-2.9.0/html/tutorial/images/next.png ADDED

Binary file

data/vendor/local/share/doc/libxml2-2.9.0/html/tutorial/images/note.png ADDED

Binary file

data/vendor/local/share/doc/libxml2-2.9.0/html/tutorial/images/prev.png ADDED

Binary file

data/vendor/local/share/doc/libxml2-2.9.0/html/tutorial/images/tip.png ADDED

Binary file

data/vendor/local/share/doc/libxml2-2.9.0/html/tutorial/images/toc-blank.png ADDED

Binary file

data/vendor/local/share/doc/libxml2-2.9.0/html/tutorial/images/toc-minus.png ADDED

Binary file

data/vendor/local/share/doc/libxml2-2.9.0/html/tutorial/images/toc-plus.png ADDED

Binary file

data/vendor/local/share/doc/libxml2-2.9.0/html/tutorial/images/up.png ADDED

Binary file

data/vendor/local/share/doc/libxml2-2.9.0/html/tutorial/images/warning.png ADDED

Binary file

data/vendor/local/share/doc/libxml2-2.9.0/html/tutorial/includeaddattribute.c ADDED

@@ -0,0 +1,64 @@
+<![CDATA[
+#include <stdio.h>
+#include <string.h>
+#include <stdlib.h>
+#include <libxml/xmlmemory.h>
+#include <libxml/parser.h>
+xmlDocPtr
+parseDoc(char *docname, char *uri) {
+	xmlDocPtr doc;
+	xmlNodePtr cur;
+	xmlNodePtr newnode;
+	xmlAttrPtr newattr;
+	doc = xmlParseFile(docname);
+	if (doc == NULL ) {
+		fprintf(stderr,"Document not parsed successfully. \n");
+		return (NULL);
+	}
+	cur = xmlDocGetRootElement(doc);
+	if (cur == NULL) {
+		fprintf(stderr,"empty document\n");
+		xmlFreeDoc(doc);
+		return (NULL);
+	}
+	if (xmlStrcmp(cur->name, (const xmlChar *) "story")) {
+		fprintf(stderr,"document of the wrong type, root node != story");
+		xmlFreeDoc(doc);
+		return (NULL);
+	}
+	newnode = xmlNewTextChild (cur, NULL, "reference", NULL);
+	newattr = xmlNewProp (newnode, "uri", uri);
+	return(doc);
+}
+int
+main(int argc, char **argv) {
+	char *docname;
+	char *uri;
+	xmlDocPtr doc;
+	if (argc <= 2) {
+		printf("Usage: %s docname, uri\n", argv[0]);
+		return(0);
+	}
+	docname = argv[1];
+	uri = argv[2];
+	doc = parseDoc (docname, uri);
+	if (doc != NULL) {
+		xmlSaveFormatFile (docname, doc, 1);
+		xmlFreeDoc(doc);
+	}
+	return (1);
+}
+]]>

data/vendor/local/share/doc/libxml2-2.9.0/html/tutorial/includeaddkeyword.c ADDED

@@ -0,0 +1,75 @@
+<![CDATA[
+#include <stdio.h>
+#include <string.h>
+#include <stdlib.h>
+#include <libxml/xmlmemory.h>
+#include <libxml/parser.h>
+void
+parseStory (xmlDocPtr doc, xmlNodePtr cur, char *keyword) {
+	xmlNewTextChild (cur, NULL, "keyword", keyword);
+    return;
+}
+xmlDocPtr
+parseDoc(char *docname, char *keyword) {
+	xmlDocPtr doc;
+	xmlNodePtr cur;
+	doc = xmlParseFile(docname);
+	if (doc == NULL ) {
+		fprintf(stderr,"Document not parsed successfully. \n");
+		return (NULL);
+	}
+	cur = xmlDocGetRootElement(doc);
+	if (cur == NULL) {
+		fprintf(stderr,"empty document\n");
+		xmlFreeDoc(doc);
+		return (NULL);
+	}
+	if (xmlStrcmp(cur->name, (const xmlChar *) "story")) {
+		fprintf(stderr,"document of the wrong type, root node != story");
+		xmlFreeDoc(doc);
+		return (NULL);
+	}
+	cur = cur->xmlChildrenNode;
+	while (cur != NULL) {
+		if ((!xmlStrcmp(cur->name, (const xmlChar *)"storyinfo"))){
+			parseStory (doc, cur, keyword);
+		}
+	cur = cur->next;
+	}
+	return(doc);
+}
+int
+main(int argc, char **argv) {
+	char *docname;
+	char *keyword;
+	xmlDocPtr doc;
+	if (argc <= 2) {
+		printf("Usage: %s docname, keyword\n", argv[0]);
+		return(0);
+	}
+	docname = argv[1];
+	keyword = argv[2];
+	doc = parseDoc (docname, keyword);
+	if (doc != NULL) {
+		xmlSaveFormatFile (docname, doc, 0);
+		xmlFreeDoc(doc);
+	}
+	return (1);
+}
+]]>

data/vendor/local/share/doc/libxml2-2.9.0/html/tutorial/includeconvert.c ADDED

@@ -0,0 +1,73 @@
+<![CDATA[
+#include <string.h>
+#include <libxml/parser.h>
+unsigned char*
+convert (unsigned char *in, char *encoding)
+{
+	unsigned char *out;
+        int ret,size,out_size,temp;
+        xmlCharEncodingHandlerPtr handler;
+        size = (int)strlen(in)+1;
+        out_size = size*2-1;
+        out = malloc((size_t)out_size);
+        if (out) {
+                handler = xmlFindCharEncodingHandler(encoding);
+                if (!handler) {
+                        free(out);
+                        out = NULL;
+                }
+        }
+        if (out) {
+                temp=size-1;
+                ret = handler->input(out, &out_size, in, &temp);
+                if (ret || temp-size+1) {
+                        if (ret) {
+                                printf("conversion wasn't successful.\n");
+                        } else {
+                                printf("conversion wasn't successful. converted: %i octets.\n",temp);
+                        }
+                        free(out);
+                        out = NULL;
+                } else {
+                        out = realloc(out,out_size+1);
+                        out[out_size]=0; /*null terminating out*/
+                }
+        } else {
+                printf("no mem\n");
+        }
+        return (out);
+}
+int
+main(int argc, char **argv) {
+	unsigned char *content, *out;
+	xmlDocPtr doc;
+	xmlNodePtr rootnode;
+	char *encoding = "ISO-8859-1";
+	if (argc <= 1) {
+		printf("Usage: %s content\n", argv[0]);
+		return(0);
+	}
+	content = argv[1];
+	out = convert(content, encoding);
+	doc = xmlNewDoc ("1.0");
+	rootnode = xmlNewDocNode(doc, NULL, (const xmlChar*)"root", out);
+	xmlDocSetRootElement(doc, rootnode);
+	xmlSaveFormatFileEnc("-", doc, encoding, 1);
+	return (1);
+}
+]]>

data/vendor/local/share/doc/libxml2-2.9.0/html/tutorial/includegetattribute.c ADDED

@@ -0,0 +1,72 @@
+<![CDATA[
+#include <stdio.h>
+#include <string.h>
+#include <stdlib.h>
+#include <libxml/xmlmemory.h>
+#include <libxml/parser.h>
+void
+getReference (xmlDocPtr doc, xmlNodePtr cur) {
+	xmlChar *uri;
+	cur = cur->xmlChildrenNode;
+	while (cur != NULL) {
+	    if ((!xmlStrcmp(cur->name, (const xmlChar *)"reference"))) {
+		    uri = xmlGetProp(cur, "uri");
+		    printf("uri: %s\n", uri);
+		    xmlFree(uri);
+	    }
+	    cur = cur->next;
+	}
+	return;
+}
+void
+parseDoc(char *docname) {
+	xmlDocPtr doc;
+	xmlNodePtr cur;
+	doc = xmlParseFile(docname);
+	if (doc == NULL ) {
+		fprintf(stderr,"Document not parsed successfully. \n");
+		return;
+	}
+	cur = xmlDocGetRootElement(doc);
+	if (cur == NULL) {
+		fprintf(stderr,"empty document\n");
+		xmlFreeDoc(doc);
+		return;
+	}
+	if (xmlStrcmp(cur->name, (const xmlChar *) "story")) {
+		fprintf(stderr,"document of the wrong type, root node != story");
+		xmlFreeDoc(doc);
+		return;
+	}
+	getReference (doc, cur);
+	xmlFreeDoc(doc);
+	return;
+}
+int
+main(int argc, char **argv) {
+	char *docname;
+	if (argc <= 1) {
+		printf("Usage: %s docname\n", argv[0]);
+		return(0);
+	}
+	docname = argv[1];
+	parseDoc (docname);
+	return (1);
+}
+]]>

data/vendor/local/share/doc/libxml2-2.9.0/html/tutorial/includekeyword.c ADDED

@@ -0,0 +1,79 @@
+<![CDATA[
+#include <stdio.h>
+#include <string.h>
+#include <stdlib.h>
+#include <libxml/xmlmemory.h>
+#include <libxml/parser.h>
+void
+parseStory (xmlDocPtr doc, xmlNodePtr cur) {
+	xmlChar *key;
+	cur = cur->xmlChildrenNode;
+	while (cur != NULL) {
+	    if ((!xmlStrcmp(cur->name, (const xmlChar *)"keyword"))) {
+		    key = xmlNodeListGetString(doc, cur->xmlChildrenNode, 1);
+		    printf("keyword: %s\n", key);
+		    xmlFree(key);
+ 	    }
+	cur = cur->next;
+	}
+    return;
+}
+static void
+parseDoc(char *docname) {
+	xmlDocPtr doc;
+	xmlNodePtr cur;
+	doc = xmlParseFile(docname);
+	if (doc == NULL ) {
+		fprintf(stderr,"Document not parsed successfully. \n");
+		return;
+	}
+	cur = xmlDocGetRootElement(doc);
+	if (cur == NULL) {
+		fprintf(stderr,"empty document\n");
+		xmlFreeDoc(doc);
+		return;
+	}
+	if (xmlStrcmp(cur->name, (const xmlChar *) "story")) {
+		fprintf(stderr,"document of the wrong type, root node != story");
+		xmlFreeDoc(doc);
+		return;
+	}
+	cur = cur->xmlChildrenNode;
+	while (cur != NULL) {
+		if ((!xmlStrcmp(cur->name, (const xmlChar *)"storyinfo"))){
+			parseStory (doc, cur);
+		}
+	cur = cur->next;
+	}
+	xmlFreeDoc(doc);
+	return;
+}
+int
+main(int argc, char **argv) {
+	char *docname;
+	if (argc <= 1) {
+		printf("Usage: %s docname\n", argv[0]);
+		return(0);
+	}
+	docname = argv[1];
+	parseDoc (docname);
+	return (1);
+}
+]]>