mirror of
https://gitlab.gnome.org/GNOME/libxml2.git
synced 2025-07-30 22:43:14 +03:00
Trying to minimize the support pain, Daniel
This commit is contained in:
Daniel Veillard
68
doc/FAQ.html
68
doc/FAQ.html
@ -3,7 +3,7 @@
|
|||||||
<html>
|
<html>
|
||||||
<head>
|
<head>
|
||||||
<title>Libxml Frequently Asked Questions</title>
|
<title>Libxml Frequently Asked Questions</title>
|
||||||
<meta name="GENERATOR" content="amaya V4.1">
|
<meta name="GENERATOR" content="amaya V5.0">
|
||||||
<meta http-equiv="Content-Type" content="text/html">
|
<meta http-equiv="Content-Type" content="text/html">
|
||||||
</head>
|
</head>
|
||||||
|
|
||||||
@ -43,8 +43,8 @@ href="http://xmlsoft.org/messages/">http://xmlsoft.org/messages/</a></p>
|
|||||||
<li><em>Can I embed libxml in a proprietary application ?</em>
|
<li><em>Can I embed libxml in a proprietary application ?</em>
|
||||||
<p>Yes. The W3C IPR allows you to also keep proprietary the changes you
|
<p>Yes. The W3C IPR allows you to also keep proprietary the changes you
|
||||||
made to libxml, but it would be graceful to provide back bugfixes and
|
made to libxml, but it would be graceful to provide back bugfixes and
|
||||||
improvements as patches for possible incorporation in the main development
|
improvements as patches for possible incorporation in the main
|
||||||
tree</p>
|
development tree</p>
|
||||||
</li>
|
</li>
|
||||||
</ol>
|
</ol>
|
||||||
|
|
||||||
@ -53,7 +53,8 @@ href="http://xmlsoft.org/messages/">http://xmlsoft.org/messages/</a></p>
|
|||||||
<li>Unless you are forced to because your application links with a Gnome
|
<li>Unless you are forced to because your application links with a Gnome
|
||||||
library requiring it, <strong><span style="background-color: #FF0000">Do
|
library requiring it, <strong><span style="background-color: #FF0000">Do
|
||||||
Not Use libxml1</span></strong>, use libxml2</li>
|
Not Use libxml1</span></strong>, use libxml2</li>
|
||||||
<li><em>Where can I get libxml</em> ?
|
<li><em>Where can I get libxml</em>
|
||||||
|
?
|
||||||
<p>The original distribution comes from <a
|
<p>The original distribution comes from <a
|
||||||
href="ftp://rpmfind.net/pub/libxml/">rpmfind.net</a> or <a
|
href="ftp://rpmfind.net/pub/libxml/">rpmfind.net</a> or <a
|
||||||
href="ftp://ftp.gnome.org/pub/GNOME/stable/sources/libxml/">gnome.org</a></p>
|
href="ftp://ftp.gnome.org/pub/GNOME/stable/sources/libxml/">gnome.org</a></p>
|
||||||
@ -64,16 +65,16 @@ href="http://xmlsoft.org/messages/">http://xmlsoft.org/messages/</a></p>
|
|||||||
</li>
|
</li>
|
||||||
<li><em>I see libxml and libxml2 releases, which one should I install ?</em>
|
<li><em>I see libxml and libxml2 releases, which one should I install ?</em>
|
||||||
<ul>
|
<ul>
|
||||||
<li>If you are not concerned by any existing backward compatibility with
|
<li>If you are not concerned by any existing backward compatibility
|
||||||
existing application, install libxml2 only</li>
|
with existing application, install libxml2 only</li>
|
||||||
<li>If you are not doing development, you can safely install both.
|
<li>If you are not doing development, you can safely install both.
|
||||||
usually the packages <a
|
usually the packages <a
|
||||||
href="http://rpmfind.net/linux/RPM/libxml.html">libxml</a> and <a
|
href="http://rpmfind.net/linux/RPM/libxml.html">libxml</a> and <a
|
||||||
href="http://rpmfind.net/linux/RPM/libxml2.html">libxml2</a> are
|
href="http://rpmfind.net/linux/RPM/libxml2.html">libxml2</a> are
|
||||||
compatible (this is not the case for development packages)</li>
|
compatible (this is not the case for development packages)</li>
|
||||||
<li>If you are a developer and your system provides separate packaging
|
<li>If you are a developer and your system provides separate packaging
|
||||||
for shared libraries and the development components, it is possible to
|
for shared libraries and the development components, it is possible
|
||||||
install libxml and libxml2, and also <a
|
to install libxml and libxml2, and also <a
|
||||||
href="http://rpmfind.net/linux/RPM/libxml-devel.html">libxml-devel</a>
|
href="http://rpmfind.net/linux/RPM/libxml-devel.html">libxml-devel</a>
|
||||||
and <a
|
and <a
|
||||||
href="http://rpmfind.net/linux/RPM/libxml2-devel.html">libxml2-devel</a>
|
href="http://rpmfind.net/linux/RPM/libxml2-devel.html">libxml2-devel</a>
|
||||||
@ -122,13 +123,13 @@ href="http://xmlsoft.org/messages/">http://xmlsoft.org/messages/</a></p>
|
|||||||
<p>However if found at configuration time libxml will detect and use the
|
<p>However if found at configuration time libxml will detect and use the
|
||||||
following libs:</p>
|
following libs:</p>
|
||||||
<ul>
|
<ul>
|
||||||
<li><a href="http://www.info-zip.org/pub/infozip/zlib/">libz</a>: a
|
<li><a href="http://www.info-zip.org/pub/infozip/zlib/">libz</a>
|
||||||
highly portable and available widely compression library</li>
|
: a highly portable and available widely compression library</li>
|
||||||
<li>iconv: a powerful character encoding conversion library. It's
|
<li>iconv: a powerful character encoding conversion library. It's
|
||||||
included by default on recent glibc libraries, so it doesn't need to
|
included by default on recent glibc libraries, so it doesn't need to
|
||||||
be installed specifically on linux. It seems it's now <a
|
be installed specifically on linux. It seems it's now <a
|
||||||
href="http://www.opennc.org/onlinepubs/7908799/xsh/iconv.html">part of
|
href="http://www.opennc.org/onlinepubs/7908799/xsh/iconv.html">part
|
||||||
the official UNIX</a> specification. Here is one <a
|
of the official UNIX</a> specification. Here is one <a
|
||||||
href="http://clisp.cons.org/~haible/packages-libiconv.html">implementation
|
href="http://clisp.cons.org/~haible/packages-libiconv.html">implementation
|
||||||
of the library</a> which source can be found <a
|
of the library</a> which source can be found <a
|
||||||
href="ftp://ftp.ilog.fr/pub/Users/haible/gnu/">here</a>.</li>
|
href="ftp://ftp.ilog.fr/pub/Users/haible/gnu/">here</a>.</li>
|
||||||
@ -145,8 +146,8 @@ href="http://xmlsoft.org/messages/">http://xmlsoft.org/messages/</a></p>
|
|||||||
<li><em>make check fails on some platforms</em>
|
<li><em>make check fails on some platforms</em>
|
||||||
<p>Sometime the regression tests results don't completely match the value
|
<p>Sometime the regression tests results don't completely match the value
|
||||||
produced by the parser, and the makefile uses diff to print the delta. On
|
produced by the parser, and the makefile uses diff to print the delta. On
|
||||||
some platforms the diff return breaks the compilation process, if the diff
|
some platforms the diff return breaks the compilation process, if the
|
||||||
is small this is probably not a serious problem</p>
|
diff is small this is probably not a serious problem</p>
|
||||||
</li>
|
</li>
|
||||||
<li><em>I use the CVS version and there is no configure script</em>
|
<li><em>I use the CVS version and there is no configure script</em>
|
||||||
<p>The configure (and other Makefiles) are generated. Use the autogen.sh
|
<p>The configure (and other Makefiles) are generated. Use the autogen.sh
|
||||||
@ -162,6 +163,24 @@ href="http://xmlsoft.org/messages/">http://xmlsoft.org/messages/</a></p>
|
|||||||
|
|
||||||
<h2><a name="Developer">Developer</a> corner</h2>
|
<h2><a name="Developer">Developer</a> corner</h2>
|
||||||
<ol>
|
<ol>
|
||||||
|
<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
|
||||||
|
significant</strong>. If you build a tree from the API and want
|
||||||
|
indentation:</p>
|
||||||
|
<ol>
|
||||||
|
<li>the correct way is to generate those yourself too</li>
|
||||||
|
<li>the dangerous way is to ask libxml to add those blanks to your
|
||||||
|
content <strong>modifying the content of your document in the
|
||||||
|
process</strong>. The result may not be what you expect. There is
|
||||||
|
<strong>NO</strong> way to guarantee that such a modification won't
|
||||||
|
impact other part of the content of your document. See <a
|
||||||
|
href="http://xmlsoft.org/html/libxml-parser.html#XMLKEEPBLANKSDEFAULT">xmlKeepBlanksDefault
|
||||||
|
()</a> and <a
|
||||||
|
href="http://xmlsoft.org/html/libxml-tree.html#XMLSAVEFORMATFILE">xmlSaveFormatFile
|
||||||
|
()</a></li>
|
||||||
|
</ol>
|
||||||
|
</li>
|
||||||
<li>Extra nodes in the document:
|
<li>Extra nodes in the document:
|
||||||
<p><em>For a XML file as below:</em></p>
|
<p><em>For a XML file as below:</em></p>
|
||||||
<pre><?xml version="1.0"?>
|
<pre><?xml version="1.0"?>
|
||||||
@ -187,8 +206,8 @@ pnode=pxmlDoc->children->children;</pre>
|
|||||||
to forget. There is a function <a
|
to forget. There is a function <a
|
||||||
href="http://xmlsoft.org/html/libxml-parser.html">xmlKeepBlanksDefault
|
href="http://xmlsoft.org/html/libxml-parser.html">xmlKeepBlanksDefault
|
||||||
()</a> to remove those at parse time, but that's an heuristic, and its
|
()</a> to remove those at parse time, but that's an heuristic, and its
|
||||||
use should be limited to case where you are sure there is no mixed-content
|
use should be limited to case where you are sure there is no
|
||||||
in the document.</p>
|
mixed-content in the document.</p>
|
||||||
</li>
|
</li>
|
||||||
<li><em>I get compilation errors of existing code like when accessing
|
<li><em>I get compilation errors of existing code like when accessing
|
||||||
<strong>root</strong> or <strong>childs fields</strong> of nodes</em>
|
<strong>root</strong> or <strong>childs fields</strong> of nodes</em>
|
||||||
@ -202,12 +221,12 @@ pnode=pxmlDoc->children->children;</pre>
|
|||||||
fields</em>
|
fields</em>
|
||||||
<p>The source code you are using has been <a
|
<p>The source code you are using has been <a
|
||||||
href="upgrade.html">upgraded</a> to be able to compile with both libxml
|
href="upgrade.html">upgraded</a> to be able to compile with both libxml
|
||||||
and libxml2, but you need to install a more recent version: libxml(-devel)
|
and libxml2, but you need to install a more recent version:
|
||||||
>= 1.8.8 or libxml2(-devel) >= 2.1.0</p>
|
libxml(-devel) >= 1.8.8 or libxml2(-devel) >= 2.1.0</p>
|
||||||
</li>
|
</li>
|
||||||
<li><em>XPath implementation looks seriously broken</em>
|
<li><em>XPath implementation looks seriously broken</em>
|
||||||
<p>XPath implementation prior to 2.3.0 was really incomplete, upgrade to a
|
<p>XPath implementation prior to 2.3.0 was really incomplete, upgrade to
|
||||||
recent version, the implementation and debug of libxslt generated fixes
|
a recent version, the implementation and debug of libxslt generated fixes
|
||||||
for most obvious problems.</p>
|
for most obvious problems.</p>
|
||||||
</li>
|
</li>
|
||||||
<li><em>The example provided in the web page does not compile</em>
|
<li><em>The example provided in the web page does not compile</em>
|
||||||
@ -233,13 +252,14 @@ pnode=pxmlDoc->children->children;</pre>
|
|||||||
</li>
|
</li>
|
||||||
<li><a
|
<li><a
|
||||||
href="http://cvs.gnome.org/bonsai/rview.cgi?cvsroot=/cvs/gnome&dir=gnome-xml">Browse
|
href="http://cvs.gnome.org/bonsai/rview.cgi?cvsroot=/cvs/gnome&dir=gnome-xml">Browse
|
||||||
the libxml source</a>, I try to write code as clean and documented as
|
the libxml source</a>
|
||||||
possible, so looking at it may be helpful</li>
|
, I try to write code as clean and documented as possible, so
|
||||||
|
looking at it may be helpful</li>
|
||||||
</ul>
|
</ul>
|
||||||
</li>
|
</li>
|
||||||
<li>What about C++ ?
|
<li>What about C++ ?
|
||||||
<p>libxml is written in pure C in order to allow easy reuse on a number of
|
<p>libxml is written in pure C in order to allow easy reuse on a number
|
||||||
platforms, including embedded systems. I don't intend to convert to
|
of platforms, including embedded systems. I don't intend to convert to
|
||||||
C++.</p>
|
C++.</p>
|
||||||
<p>There is however a C++ wrapper provided by Ari Johnson
|
<p>There is however a C++ wrapper provided by Ari Johnson
|
||||||
<ari@btigate.com> which may fullfill your needs:</p>
|
<ari@btigate.com> which may fullfill your needs:</p>
|
||||||
|
|||||||
15
doc/xml.html
15
doc/xml.html
@ -155,8 +155,10 @@ href="http://mail.gnome.org/mailman/listinfo/xml">associated Web</a> page and
|
|||||||
follow the instructions. <strong>Do not send code, I won't debug it</strong>
|
follow the instructions. <strong>Do not send code, I won't debug it</strong>
|
||||||
(but patches are really appreciated!).</p>
|
(but patches are really appreciated!).</p>
|
||||||
|
|
||||||
<p>Check the following too before posting:</p>
|
<p>Check the following <strong><span style="color: #FF0000">before
|
||||||
|
posting</span></strong>:</p>
|
||||||
<ul>
|
<ul>
|
||||||
|
<li>read the <a href="FAQ.html">FAQ</a> </li>
|
||||||
<li>make sure you are <a href="ftp://xmlsoft.org/">using a recent
|
<li>make sure you are <a href="ftp://xmlsoft.org/">using a recent
|
||||||
version</a>, and that the problem still shows up in those</li>
|
version</a>, and that the problem still shows up in those</li>
|
||||||
<li>check the <a href="http://mail.gnome.org/archives/xml/">list
|
<li>check the <a href="http://mail.gnome.org/archives/xml/">list
|
||||||
@ -170,12 +172,11 @@ follow the instructions. <strong>Do not send code, I won't debug it</strong>
|
|||||||
attachement)</li>
|
attachement)</li>
|
||||||
</ul>
|
</ul>
|
||||||
|
|
||||||
<p>Alternatively, you can just send the bug to the <a
|
<p> Then send the bug with associated informations to reproduce it to the <a
|
||||||
href="mailto:xml@gnome.org">xml@gnome.org</a> list; if it's really libxml
|
href="mailto:xml@gnome.org">xml@gnome.org</a> list; if it's really libxml
|
||||||
related I will approve it.. Please do not send me mail directly especially
|
related I will approve it.. Please do not send me mail directly, it makes
|
||||||
for portability problem, it makes things really harder to track and in some
|
things really harder to track and in some cases I'm not the best person to
|
||||||
cases I'm not the best person to answer a given question, ask the list
|
answer a given question, ask the list instead.</p>
|
||||||
instead.</p>
|
|
||||||
|
|
||||||
<p>Of course, bugs reported with a suggested patch for fixing them will
|
<p>Of course, bugs reported with a suggested patch for fixing them will
|
||||||
probably be processed faster.</p>
|
probably be processed faster.</p>
|
||||||
@ -1687,6 +1688,6 @@ Gnome CVS base under gnome-xml/example</p>
|
|||||||
|
|
||||||
<p><a href="mailto:daniel@veillard.com">Daniel Veillard</a></p>
|
<p><a href="mailto:daniel@veillard.com">Daniel Veillard</a></p>
|
||||||
|
|
||||||
<p>$Id: xml.html,v 1.108 2001/08/24 00:49:01 veillard Exp $</p>
|
<p>$Id: xml.html,v 1.109 2001/09/12 18:51:29 veillard Exp $</p>
|
||||||
</body>
|
</body>
|
||||||
</html>
|
</html>
|
||||||
|
|||||||
Reference in New Issue
Block a user