diff --git a/ChangeLog b/ChangeLog index 530c0800..6498ed23 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,10 @@ +Thu Feb 15 12:43:28 PST 2007 William Brack + + * doc/xml.html: Changed all references to libxml2 CVS over to + the corresponding SVN. A few other spelling/grammar/links + also changed. + * doc/libxml2-api.xml, doc/*.html: Regenerated all docs. + Tue Feb 13 18:15:58 PST 2007 William Brack * xpath.c: Fixed memory bug with invalid function reported by diff --git a/doc/APIchunk13.html b/doc/APIchunk13.html index 136803d8..959a1b5b 100644 --- a/doc/APIchunk13.html +++ b/doc/APIchunk13.html @@ -44,6 +44,7 @@ A:link, A:visited, A:active { text-decoration: underline }
day:minute
ftpListCallback
de-coupled
xmlValidateDtd
deactivated
xmlTextReaderRelaxNGSetSchema
+xmlTextReaderRelaxNGValidate
xmlTextReaderSchemaValidate
xmlTextReaderSchemaValidateCtxt
xmlTextReaderSetSchema
@@ -251,10 +252,8 @@ A:link, A:visited, A:active { text-decoration: underline } xmlExpExpDerive
xmlExpStringDerive
des
xmlTextReaderRelaxNGSetSchema
-xmlTextReaderRelaxNGValidate
xmlTextReaderSetSchema
desactivated
xmlTextReaderRelaxNGSetSchema
-xmlTextReaderRelaxNGValidate
xmlTextReaderSetSchema
descend
xmlDOMWrapCloneNode
descendant
xmlXPathNextDescendant
diff --git a/doc/DOM.html b/doc/DOM.html index 52f11392..90b988b2 100644 --- a/doc/DOM.html +++ b/doc/DOM.html @@ -12,6 +12,6 @@ Object Model; this is an API for accessing XML or HTML structured documents. Native support for DOM in Gnome is on the way (module gnome-dom), and will be based on gnome-xml. This will be a far cleaner interface to manipulate XML files within Gnome since it won't expose the internal -structure.

The current DOM implementation on top of libxml2 is the gdome2 Gnome module, this -is a full DOM interface, thanks to Paolo Casarini, check the Gdome2 homepage for more -informations.

Daniel Veillard

+structure.

The current DOM implementation on top of libxml2 is the gdome2 Gnome module, this +is a full DOM interface, thanks to Paolo Casarini, check the Gdome2 homepage for more +information.

Daniel Veillard

diff --git a/doc/FAQ.html b/doc/FAQ.html index 0d5ded6d..6bc67eca 100644 --- a/doc/FAQ.html +++ b/doc/FAQ.html @@ -24,12 +24,14 @@ A:link, A:visited, A:active { text-decoration: underline }

Installation

  1. Do Not Use libxml1, use libxml2
    2. +

  2. Where can I get libxml ?

    The original distribution comes from xmlsoft.org or gnome.org

    Most Linux and BSD distributions include libxml, this is probably the safer way for end-users to use libxml.

    David Doolin provides precompiled Windows versions at http://www.ce.berkeley.edu/~doolin/code/libxmlwin32/

    3. +

  3. I see libxml and libxml2 releases, which one should I install ?
    • If you are not constrained by backward compatibility issues with existing applications, install libxml2 only
      • @@ -86,6 +88,7 @@ A:link, A:visited, A:active { text-decoration: underline } of the official UNIX specification. Here is one implementation of the library which source can be found here.
    4. +

  4. Make check fails on some platforms

    Sometimes the regression tests' results don't completely match the value produced by the parser, and the makefile uses diff to print the @@ -94,7 +97,7 @@ A:link, A:visited, A:active { text-decoration: underline }

    Sometimes (especially on Solaris) make checks fail due to limitations in make. Try using GNU-make instead.

    5. -
  5. I use the CVS version and there is no configure script +
  6. I use the SVN version and there is no configure script

    The configure script (and other Makefiles) are generated. Use the autogen.sh script to regenerate the configure script and Makefiles, like:

    @@ -173,8 +176,9 @@ A:link, A:visited, A:active { text-decoration: underline } () and xmlSaveFormatFile ()
-
  • Extra nodes in the document: -

    For a XML file as below:

    +

    +
  • Extra nodes in the document: +

    For an XML file as below:

    <?xml version="1.0"?>
 <PLAN xmlns="http://www.argus.ca/autotest/1.0/">
 <NODE CommFlag="0"/>
@@ -232,19 +236,23 @@ pnode=pxmlDoc->children->children;
  • have a look at the set of examples.
  • look for examples of use for libxml2 function using the Gnome code. +
    • -
  • Browse +
  • Browse the libxml2 source , I try to write code as clean and documented as possible, so looking at it may be helpful. In particular the code - of xmllint.c and of the various testXXX.c test programs should + of xmllint.c and of the various testXXX.c test programs should provide good examples of how to do things with the library.
    • -
  • What about C++ ? +

    +
  • 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++.

    @@ -260,7 +268,7 @@ pnode=pxmlDoc->children->children;
    • --> -
  • How to validate a document a posteriori ? +
  • 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 using the API. Use the xmlValidateDtd() @@ -276,7 +284,7 @@ xmlDtdPtr dtd = xmlParseDTD(NULL, filename_of_dtd); /* parse the DTD */ else xmlAddPrevSibling(doc->children, (xmlNodePtr)dtd);

    • -
  • So what is this funky "xmlChar" used all the time? +
  • So what is this funky "xmlChar" used all the time?

    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 diff --git a/doc/XSLT.html b/doc/XSLT.html index 657ead30..c483e044 100644 --- a/doc/XSLT.html +++ b/doc/XSLT.html @@ -10,4 +10,4 @@ A:link, A:visited, A:active { text-decoration: underline } XSLT
    Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
    Made with Libxml2 Logo

    The XML C parser and toolkit of Gnome

    XSLT

    Main Menu
    Related links

    Check the separate libxslt page

    XSL Transformations, is a language for transforming XML documents into other XML documents (or HTML/textual output).

    A separate library called libxslt is available implementing XSLT-1.0 for -libxml2. This module "libxslt" too can be found in the Gnome CVS base.

    You can check the progresses on the libxslt Changelog.

    Daniel Veillard

    +libxml2. This module "libxslt" too can be found in the Gnome SVN base.

    You can check the progresses on the libxslt Changelog.

    Daniel Veillard

    diff --git a/doc/bugs.html b/doc/bugs.html index 6415c85b..d37423be 100644 --- a/doc/bugs.html +++ b/doc/bugs.html @@ -14,7 +14,7 @@ bug tracking database (make sure to use the "libxml2" module name). I look at reports there regularly and it's good to have a reminder when a bug is still open. Be sure to specify that the bug is for the package libxml2.

    For small problems you can try to get help on IRC, the #xml channel on irc.gnome.org (port 6667) usually have a few person subscribed which may help -(but there is no garantee and if a real issue is raised it should go on the +(but there is no guarantee and if a real issue is raised it should go on the mailing-list for archival).

    There is also a mailing-list xml@gnome.org for libxml, with an on-line archive (old). To subscribe to this list, please visit the associated Web page and follow the instructions. Do not send code, I won't debug it @@ -24,13 +24,13 @@ bounces* (in the order of a thousand a day !) I cannot approve them manually anymore. If your mail to the list bounced waiting for administrator approval, it is LOST ! Repost it and fix the problem triggering the error. Also please note that emails with -a legal warning asking to not copy or redistribute freely the informations +a legal warning asking to not copy or redistribute freely the information they contain are NOT acceptable for the mailing-list, such mail will as much as possible be discarded automatically, and are less likely to be answered if they made it to the list, DO NOT post to the list from an email address where such legal requirements are automatically added, get private paying support if you can't share -informations.

    Check the following before +information.

    Check the following before posting: