From e85cf827a804d9abf4cbf48af6394c49331de322 Mon Sep 17 00:00:00 2001 From: Aron Xu Date: Mon, 21 Sep 2015 22:55:55 +0800 Subject: Revert "Merge tag 'upstream/2.9.1+dfsg1'" This reverts commit 21ee18bdbc9a9d4500e12a1399d51c593b8b31d4, reversing changes made to de338c1adfa336ddb5177ceb5c63bcd868a0ebc7. --- doc/FAQ.html | 51 ++++++++++++++++++++++++++++++++++----------------- 1 file changed, 34 insertions(+), 17 deletions(-) (limited to 'doc/FAQ.html') diff --git a/doc/FAQ.html b/doc/FAQ.html index 0bfd387..3481c19 100644 --- a/doc/FAQ.html +++ b/doc/FAQ.html @@ -7,11 +7,13 @@ H1 {font-family: Verdana,Arial,Helvetica} H2 {font-family: Verdana,Arial,Helvetica} H3 {font-family: Verdana,Arial,Helvetica} A:link, A:visited, A:active { text-decoration: underline } -FAQ
Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
Made with Libxml2 Logo

The XML C parser and toolkit of Gnome

FAQ

Main Menu
Related links

Table of Contents:

  • License(s)
    • +FAQ
    Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
    Made with Libxml2 Logo

    The XML C parser and toolkit of Gnome

    FAQ

    Main Menu
    Related links

    Table of Contents:

    License(s)

    1. Licensing Terms for libxml +

      License(s)

        +
      1. Licensing Terms for libxml

        libxml2 is released under the MIT License; see the file Copyright in the distribution for the precise wording

        @@ -22,7 +24,8 @@ A:link, A:visited, A:active { text-decoration: underline } improvements as patches for possible incorporation in the main development tree.

        2. -

      Installation

      1. Do Not Use +

      Installation

        +
      1. Do Not Use libxml1, use libxml2

      2. Where can I get libxml ? @@ -33,7 +36,8 @@ A:link, A:visited, A:active { text-decoration: underline }

      3. I see libxml and libxml2 releases, which one should I install ? -
        • If you are not constrained by backward compatibility issues with +
            +
          • If you are not constrained by backward compatibility issues with existing applications, install libxml2 only
          • If you are not doing development, you can safely install both. Usually the packages libxml and libxml2 are @@ -45,7 +49,8 @@ A:link, A:visited, A:active { text-decoration: underline } too for libxml2 >= 2.3.0
          • If you are developing a new application, please develop against libxml2(-devel)
            • -
          • +
        +
      4. I can't install the libxml package, it conflicts with libxml0

        You probably have an old libxml0 package used to provide the shared library for libxml.so.0, you can probably safely remove it. The libxml @@ -62,7 +67,8 @@ A:link, A:visited, A:active { text-decoration: underline } package, providing includes, static libraries and scripts needed to build applications with libxml(2)) that you can install locally.

        5. -

      Compilation

      1. What is the process to compile libxml2 ? +

      Compilation

        +
      1. What is the process to compile libxml2 ?

        As most UNIX libraries libxml2 follows the "standard":

        gunzip -c xxx.tar.gz | tar xvf -

        cd libxml-xxxx

        @@ -80,14 +86,16 @@ A:link, A:visited, A:active { text-decoration: underline } find).

        However if found at configuration time libxml2 will detect and use the following libs:

        -
        • libz : a +
            +
          • libz : a highly portable and available widely compression library.
          • iconv: a powerful character encoding conversion library. It is included by default in recent glibc libraries, so it doesn't need to be installed specifically on Linux. It now seems a part of the official UNIX specification. Here is one implementation of the library which source can be found here.
            • -
          • +
        +

      2. Make check fails on some platforms

        Sometimes the regression tests' results don't completely match the @@ -108,7 +116,8 @@ A:link, A:visited, A:active { text-decoration: underline } optimizer which miscompiles the URI module. Please use another compiler.

        3. -

      Developer corner

      1. Troubles compiling or linking programs using libxml2 +

      Developer corner

        +
      1. Troubles compiling or linking programs using libxml2

        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 xml2-config which is installed as part of libxml2 usual @@ -126,7 +135,8 @@ A:link, A:visited, A:active { text-decoration: underline }

        There are many different ways to accomplish this. Here is one way to do this under Linux. Suppose your home directory is /home/user. Then:

        -
        • Create a subdirectory, let's call it myxml
          • +
            +
          • Create a subdirectory, let's call it myxml
          • unpack the libxml2 distribution into that subdirectory
          • chdir into the unpacked distribution (/home/user/myxml/libxml2 )
            • @@ -159,7 +169,8 @@ A:link, A:visited, A:active { text-decoration: underline } program which you just installed will be used instead of the system default one, and this will automatically get the correct libraries linked with your program. -
          +
        +

      2. xmlDocDump() generates output on one line. @@ -167,7 +178,8 @@ A:link, A:visited, A:active { text-decoration: underline } document since all spaces in the content of a document are significant. If you build a tree from the API and want indentation:

        -
        1. the correct way is to generate those yourself too.
          2. +
            +
          1. the correct way is to generate those yourself too.
          2. the dangerous way is to ask libxml2 to add those blanks to your content modifying the content of your document in the process. The result may not be what you expect. There is @@ -175,7 +187,8 @@ A:link, A:visited, A:active { text-decoration: underline } affect other parts of the content of your document. See xmlKeepBlanksDefault () and xmlSaveFormatFile ()
            3. -
          +
        +

      3. Extra nodes in the document:

        For an XML file as below:

        @@ -233,7 +246,8 @@ pnode=pxmlDoc->children->children; web page?

        Ideally a libxml2 book would be nice. I have no such plan ... But you can:

        - +

      4. What about C++ ?

        libxml2 is written in pure C in order to allow easy reuse on a number of platforms, including embedded systems. I don't intend to convert to C++.

        There is however a C++ wrapper which may fulfill your needs:

        - +
      5. How to validate a document a posteriori ?

        It is possible to validate documents which had not been validated at initial parsing time or documents which have been built from scratch -- cgit v1.2.3