diff --git a/doc/xml.html b/doc/xml.html
index 621e555..43b49cb 100644
--- a/doc/xml.html
+++ b/doc/xml.html
@@ -292,6 +292,19 @@
 
 <h3><a name="Developer">Developer</a> corner</h3>
 <ol>
+  <li><em>Troubles compiling or linking programs using libxml2</em>
+    <p>Usually the problem comes from the fact that the compiler doesn't get
+    the right compilation or linking flags. There is a small shell script
+    <code>xml2-config</code> which is installed as part of libxml2 usual
+    install process which provides those flags. Use </p>
+    <p><code>xml2-config --cflags</code></p>
+    <p>to get the compilation flags and</p>
+    <p><code>xml2-config --libs</code></p>
+    <p>to get the linker flags. Usually this is done directly from the
+    Makefile as:</p>
+    <p><code>CFLAGS=`xml2-config --cflags`</code></p>
+    <p><code>LIBS=`xml2-config --libs`</code></p>
+  </li>
   <li><em>xmlDocDump() generates output on one line.</em>
     <p>Libxml will not <strong>invent</strong> spaces in the content of a
     document since <strong>all spaces in the content of a document are
@@ -648,7 +661,7 @@
     (Charles Bozeman), DTD and namespaces (Brent Hendricks), HTML push parser
     and zero bytes handling, some missing Windows file path conversions,
     behaviour of the parser and validator in the presence of "out of memory"
-    error conditions </li>
+    error conditions</li>
   <li>extended the API to be able to plug a garbage collecting memory
     allocator, added xmlMallocAtomic() and modified the allocations
     accordingly.</li>