doc/xml.html (and, by implication, FAQ.html) added UTF-8 conversaion FAQ


2002-10-31  John Fleck  <jfleck@inkstain.net>

	* doc/xml.html (and, by implication, FAQ.html)
	added UTF-8 conversaion FAQ from Marcus Labib Iskander
diff --git a/ChangeLog b/ChangeLog
index ec90705..753a33f 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2002-10-31  John Fleck  <jfleck@inkstain.net>
+
+	* doc/xml.html (and, by implication, FAQ.html)
+	added UTF-8 conversaion FAQ from Marcus Labib Iskander
+
 Tue Oct 29 18:32:33 CET 2002 Igor Zlatkovic <igor@stud.fh-frankfurt.de>
 
 	* configure.in: removed xmlwin32version.h
diff --git a/doc/DOM.html b/doc/DOM.html
index 285c8e8..ec5d856 100644
--- a/doc/DOM.html
+++ b/doc/DOM.html
@@ -1,7 +1,7 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
 <html>
 <head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type">
 <link rel="SHORTCUT ICON" href="/favicon.ico">
 <style type="text/css"><!--
 TD {font-family: Verdana,Arial,Helvetica}
diff --git a/doc/FAQ.html b/doc/FAQ.html
index 2863dd8..b6be54b 100644
--- a/doc/FAQ.html
+++ b/doc/FAQ.html
@@ -1,7 +1,7 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
 <html>
 <head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type">
 <link rel="SHORTCUT ICON" href="/favicon.ico">
 <style type="text/css"><!--
 TD {font-family: Verdana,Arial,Helvetica}
@@ -357,6 +357,13 @@
         else xmlAddPrevSibling(doc-&gt;children, (xmlNodePtr)dtd);
           </pre>
   </li>
+      <li>So what is this funky &quot;xmlChar&quot; used all the time?
+    <p>It is a null terminated sequence of utf-8 characters. And only utf-8! You
+    need to convert strings encoded in different ways to utf-8 before passing
+    them to the API.  This can be accomplished with the iconv library for
+    instance.</p>
+  </li>
+
   <li>etc ...</li>
 </ol>
 <p>
diff --git a/doc/XMLinfo.html b/doc/XMLinfo.html
index 994a052..eb9437d 100644
--- a/doc/XMLinfo.html
+++ b/doc/XMLinfo.html
@@ -1,7 +1,7 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
 <html>
 <head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type">
 <link rel="SHORTCUT ICON" href="/favicon.ico">
 <style type="text/css"><!--
 TD {font-family: Verdana,Arial,Helvetica}
diff --git a/doc/XSLT.html b/doc/XSLT.html
index f1b70f1..9570a37 100644
--- a/doc/XSLT.html
+++ b/doc/XSLT.html
@@ -1,7 +1,7 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
 <html>
 <head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type">
 <link rel="SHORTCUT ICON" href="/favicon.ico">
 <style type="text/css"><!--
 TD {font-family: Verdana,Arial,Helvetica}
diff --git a/doc/architecture.html b/doc/architecture.html
index bced3b9..512b751 100644
--- a/doc/architecture.html
+++ b/doc/architecture.html
@@ -1,7 +1,7 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
 <html>
 <head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type">
 <link rel="SHORTCUT ICON" href="/favicon.ico">
 <style type="text/css"><!--
 TD {font-family: Verdana,Arial,Helvetica}
diff --git a/doc/bugs.html b/doc/bugs.html
index d18ca27..21fac05 100644
--- a/doc/bugs.html
+++ b/doc/bugs.html
@@ -1,7 +1,7 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
 <html>
 <head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type">
 <link rel="SHORTCUT ICON" href="/favicon.ico">
 <style type="text/css"><!--
 TD {font-family: Verdana,Arial,Helvetica}
diff --git a/doc/catalog.html b/doc/catalog.html
index 2bac13a..26272c1 100644
--- a/doc/catalog.html
+++ b/doc/catalog.html
@@ -1,7 +1,7 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
 <html>
 <head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type">
 <link rel="SHORTCUT ICON" href="/favicon.ico">
 <style type="text/css"><!--
 TD {font-family: Verdana,Arial,Helvetica}
diff --git a/doc/contribs.html b/doc/contribs.html
index 0cb439d..42d21b1 100644
--- a/doc/contribs.html
+++ b/doc/contribs.html
@@ -1,7 +1,7 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
 <html>
 <head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type">
 <link rel="SHORTCUT ICON" href="/favicon.ico">
 <style type="text/css"><!--
 TD {font-family: Verdana,Arial,Helvetica}
diff --git a/doc/docs.html b/doc/docs.html
index b89eeb8..37e85ca 100644
--- a/doc/docs.html
+++ b/doc/docs.html
@@ -1,7 +1,7 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
 <html>
 <head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type">
 <link rel="SHORTCUT ICON" href="/favicon.ico">
 <style type="text/css"><!--
 TD {font-family: Verdana,Arial,Helvetica}
diff --git a/doc/downloads.html b/doc/downloads.html
index 9483f2a..bc6728e 100644
--- a/doc/downloads.html
+++ b/doc/downloads.html
@@ -1,7 +1,7 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
 <html>
 <head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type">
 <link rel="SHORTCUT ICON" href="/favicon.ico">
 <style type="text/css"><!--
 TD {font-family: Verdana,Arial,Helvetica}
diff --git a/doc/encoding.html b/doc/encoding.html
index 85d1c74..14bfdbf 100644
--- a/doc/encoding.html
+++ b/doc/encoding.html
@@ -1,7 +1,7 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
 <html>
 <head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type">
 <link rel="SHORTCUT ICON" href="/favicon.ico">
 <style type="text/css"><!--
 TD {font-family: Verdana,Arial,Helvetica}
diff --git a/doc/entities.html b/doc/entities.html
index b884e18..752ee52 100644
--- a/doc/entities.html
+++ b/doc/entities.html
@@ -1,7 +1,7 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
 <html>
 <head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type">
 <link rel="SHORTCUT ICON" href="/favicon.ico">
 <style type="text/css"><!--
 TD {font-family: Verdana,Arial,Helvetica}
diff --git a/doc/example.html b/doc/example.html
index 168c0d9..a37e49e 100644
--- a/doc/example.html
+++ b/doc/example.html
@@ -1,7 +1,7 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
 <html>
 <head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type">
 <link rel="SHORTCUT ICON" href="/favicon.ico">
 <style type="text/css"><!--
 TD {font-family: Verdana,Arial,Helvetica}
diff --git a/doc/help.html b/doc/help.html
index 53b665c..d1bead2 100644
--- a/doc/help.html
+++ b/doc/help.html
@@ -1,7 +1,7 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
 <html>
 <head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type">
 <link rel="SHORTCUT ICON" href="/favicon.ico">
 <style type="text/css"><!--
 TD {font-family: Verdana,Arial,Helvetica}
diff --git a/doc/index.html b/doc/index.html
index 7208ee3..f3bf2d0 100644
--- a/doc/index.html
+++ b/doc/index.html
@@ -1,7 +1,7 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
 <html>
 <head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type">
 <link rel="SHORTCUT ICON" href="/favicon.ico">
 <style type="text/css"><!--
 TD {font-family: Verdana,Arial,Helvetica}
diff --git a/doc/interface.html b/doc/interface.html
index 738dd28..08052b8 100644
--- a/doc/interface.html
+++ b/doc/interface.html
@@ -1,7 +1,7 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
 <html>
 <head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type">
 <link rel="SHORTCUT ICON" href="/favicon.ico">
 <style type="text/css"><!--
 TD {font-family: Verdana,Arial,Helvetica}
diff --git a/doc/intro.html b/doc/intro.html
index 1d2c55c..1b476ea 100644
--- a/doc/intro.html
+++ b/doc/intro.html
@@ -1,7 +1,7 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
 <html>
 <head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type">
 <link rel="SHORTCUT ICON" href="/favicon.ico">
 <style type="text/css"><!--
 TD {font-family: Verdana,Arial,Helvetica}
diff --git a/doc/library.html b/doc/library.html
index d416676..87f77e7 100644
--- a/doc/library.html
+++ b/doc/library.html
@@ -1,7 +1,7 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
 <html>
 <head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type">
 <link rel="SHORTCUT ICON" href="/favicon.ico">
 <style type="text/css"><!--
 TD {font-family: Verdana,Arial,Helvetica}
diff --git a/doc/namespaces.html b/doc/namespaces.html
index 46c2e37..defd5c0 100644
--- a/doc/namespaces.html
+++ b/doc/namespaces.html
@@ -1,7 +1,7 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
 <html>
 <head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type">
 <link rel="SHORTCUT ICON" href="/favicon.ico">
 <style type="text/css"><!--
 TD {font-family: Verdana,Arial,Helvetica}
diff --git a/doc/news.html b/doc/news.html
index 94470b6..2c3de58 100644
--- a/doc/news.html
+++ b/doc/news.html
@@ -1,7 +1,7 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
 <html>
 <head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type">
 <link rel="SHORTCUT ICON" href="/favicon.ico">
 <style type="text/css"><!--
 TD {font-family: Verdana,Arial,Helvetica}
diff --git a/doc/python.html b/doc/python.html
index c5a4dbd..5c90028 100644
--- a/doc/python.html
+++ b/doc/python.html
@@ -1,7 +1,7 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
 <html>
 <head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type">
 <link rel="SHORTCUT ICON" href="/favicon.ico">
 <style type="text/css"><!--
 TD {font-family: Verdana,Arial,Helvetica}
diff --git a/doc/threads.html b/doc/threads.html
index 3cfae90..871d6f8 100644
--- a/doc/threads.html
+++ b/doc/threads.html
@@ -1,7 +1,7 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
 <html>
 <head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type">
 <link rel="SHORTCUT ICON" href="/favicon.ico">
 <style type="text/css"><!--
 TD {font-family: Verdana,Arial,Helvetica}
diff --git a/doc/tree.html b/doc/tree.html
index 66cf0d4..3a43034 100644
--- a/doc/tree.html
+++ b/doc/tree.html
@@ -1,7 +1,7 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
 <html>
 <head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type">
 <link rel="SHORTCUT ICON" href="/favicon.ico">
 <style type="text/css"><!--
 TD {font-family: Verdana,Arial,Helvetica}
diff --git a/doc/upgrade.html b/doc/upgrade.html
index 13fd669..cdd43ef 100644
--- a/doc/upgrade.html
+++ b/doc/upgrade.html
@@ -1,7 +1,7 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
 <html>
 <head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type">
 <link rel="SHORTCUT ICON" href="/favicon.ico">
 <style type="text/css"><!--
 TD {font-family: Verdana,Arial,Helvetica}
diff --git a/doc/xml.html b/doc/xml.html
index e4113a2..e51f418 100644
--- a/doc/xml.html
+++ b/doc/xml.html
@@ -407,6 +407,13 @@
         else xmlAddPrevSibling(doc-&gt;children, (xmlNodePtr)dtd);
           </pre>
   </li>
+      <li>So what is this funky "xmlChar" used all the time?
+    <p>It is a null terminated sequence of utf-8 characters. And only utf-8! You
+    need to convert strings encoded in different ways to utf-8 before passing
+    them to the API.  This can be accomplished with the iconv library for
+    instance.</p>
+  </li>
+
   <li>etc ...</li>
 </ol>
 
diff --git a/doc/xmldtd.html b/doc/xmldtd.html
index 362b637..3f9bb64 100644
--- a/doc/xmldtd.html
+++ b/doc/xmldtd.html
@@ -1,7 +1,7 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
 <html>
 <head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type">
 <link rel="SHORTCUT ICON" href="/favicon.ico">
 <style type="text/css"><!--
 TD {font-family: Verdana,Arial,Helvetica}
diff --git a/doc/xmlio.html b/doc/xmlio.html
index eca8e82..770ce23 100644
--- a/doc/xmlio.html
+++ b/doc/xmlio.html
@@ -1,7 +1,7 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
 <html>
 <head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type">
 <link rel="SHORTCUT ICON" href="/favicon.ico">
 <style type="text/css"><!--
 TD {font-family: Verdana,Arial,Helvetica}
diff --git a/doc/xmlmem.html b/doc/xmlmem.html
index 5867c65..a4a6022 100644
--- a/doc/xmlmem.html
+++ b/doc/xmlmem.html
@@ -1,7 +1,7 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
 <html>
 <head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type">
 <link rel="SHORTCUT ICON" href="/favicon.ico">
 <style type="text/css"><!--
 TD {font-family: Verdana,Arial,Helvetica}