Enriched encoding.html with more link and foreword warning to avoid
* doc/xml.html doc/encoding.html: Enriched encoding.html with more
link and foreword warning to avoid problem with ignorant
programmers, c.f #169721
Daniel
diff --git a/doc/xml.html b/doc/xml.html
index fbb0d33..41a6636 100644
--- a/doc/xml.html
+++ b/doc/xml.html
@@ -3099,6 +3099,17 @@
<h2><a name="Encodings">Encodings support</a></h2>
+<p>If you are not really familiar with Internationalization (usual shortcut
+is I18N) , Unicode, characters and glyphs, I suggest you read a <a
+href="http://www.tbray.org/ongoing/When/200x/2003/04/06/Unicode">presentation</a>
+by Tim Bray on Unicode and why you should care about it.</p>
+<p>If you don't understand why <b>it does not make sense to have a string
+without knowing what encoding it uses</b>, then as Joel Spolsky said
+<a href="http://www.joelonsoftware.com/articles/Unicode.html">please do
+not write another line of code until you finish reading that article.</a>.
+It is a prerequisite to understand this page, and avoid a lot of problems
+with libxml2, XML or text processing in general.</p>
+
<p>Table of Content:</p>
<ol>
<li><a href="encoding.html#What">What does internationalization support
@@ -3113,11 +3124,6 @@
<h3><a name="What">What does internationalization support mean ?</a></h3>
-<p>If you are not really familiar with Internationalization (usual shortcut
-is I18N) , Unicode, characters and glyphs, I suggest you read a <a
-href="http://www.tbray.org/ongoing/When/200x/2003/04/06/Unicode">presentation</a>
-by Tim Bray on Unicode and why you should care about it.</p>
-
<p>XML was designed from the start to allow the support of any character set
by using Unicode. Any conformant XML parser has to support the UTF-8 and
UTF-16 default encodings which can both express the full unicode ranges. UTF8