From 789259a1b6850d30acffbb62b11456b9ed7a8f59 Mon Sep 17 00:00:00 2001 From: Mike Hommey Date: Tue, 17 Apr 2007 20:40:00 +0200 Subject: Load /tmp/libxml2-2.6.28 into libxml2/branches/upstream/current. --- doc/APIchunk1.html | 2 + doc/APIchunk10.html | 4 + doc/APIchunk12.html | 3 + doc/APIchunk13.html | 6 +- doc/APIchunk14.html | 2 + doc/APIchunk15.html | 1 + doc/APIchunk17.html | 1 + doc/APIchunk19.html | 2 + doc/APIchunk20.html | 2 + doc/APIchunk21.html | 1 + doc/APIchunk22.html | 2 + doc/APIchunk23.html | 8 ++ doc/APIchunk24.html | 14 ++- doc/APIchunk26.html | 2 + doc/APIchunk28.html | 7 ++ doc/APIchunk29.html | 3 +- doc/APIchunk4.html | 4 + doc/APIchunk7.html | 1 + doc/APIfiles.html | 1 + doc/APIfunctions.html | 2 + doc/APIsymbols.html | 1 + doc/DOM.html | 6 +- doc/FAQ.html | 26 +++-- doc/XSLT.html | 2 +- doc/bugs.html | 8 +- doc/catalog.html | 4 +- doc/devhelp/libxml2-parserInternals.html | 2 +- doc/devhelp/libxml2-tree.html | 10 +- doc/devhelp/libxml2-xmlreader.html | 133 +++++++++++++------------ doc/devhelp/libxml2-xpath.html | 8 +- doc/devhelp/libxml2.devhelp | 1 + doc/docs.html | 2 +- doc/downloads.html | 10 +- doc/encoding.html | 2 +- doc/example.html | 2 +- doc/guidelines.html | 2 +- doc/html/index.html | 13 +++ doc/html/libxml-parserInternals.html | 2 +- doc/html/libxml-tree.html | 8 +- doc/html/libxml-xmlreader.html | 9 +- doc/html/libxml-xpath.html | 8 +- doc/index.html | 2 +- doc/libxml2-api.xml | 164 +++++++++++++++++-------------- doc/libxml2.xsa | 64 +++++++++--- doc/news.html | 29 +++++- doc/python.html | 6 +- doc/search.php | 3 +- doc/xml.html | 119 +++++++++++++--------- doc/xmlcatalog_man.xml | 2 +- doc/xmlio.html | 2 +- doc/xmllint.xml | 2 +- doc/xmlmem.html | 4 +- doc/xmlreader.html | 2 +- 53 files changed, 463 insertions(+), 263 deletions(-) create mode 100644 doc/html/index.html (limited to 'doc') diff --git a/doc/APIchunk1.html b/doc/APIchunk1.html index a222fe0..f17f1af 100644 --- a/doc/APIchunk1.html +++ b/doc/APIchunk1.html @@ -49,6 +49,8 @@ A:link, A:visited, A:active { text-decoration: underline } xmlNewChild
xmlNewDocNode
xmlNewDocNodeEatName
+xmlNodeSetContent
+xmlNodeSetContentLen
xmlParseAttValue
xmlParseAttributeType
xmlParseCDSect
diff --git a/doc/APIchunk10.html b/doc/APIchunk10.html index 432eb31..c55e04a 100644 --- a/doc/APIchunk10.html +++ b/doc/APIchunk10.html @@ -331,6 +331,8 @@ A:link, A:visited, A:active { text-decoration: underline } xmlAutomataNewAllTrans
xmlAutomataNewCounterTrans
xmlIsLetter
+xmlNodeAddContent
+xmlNodeAddContentLen
xmlNodeDump
xmlNodeDumpOutput
xmlParseBalancedChunkMemory
@@ -345,6 +347,8 @@ A:link, A:visited, A:active { text-decoration: underline } htmlIsAutoClosed
xmlCatalogAdd
xmlNewChild
+xmlNodeSetContent
+xmlNodeSetContentLen
xmlParseURIRaw
xmlTextReaderConstString
already
XML_SCHEMAS_ATTRGROUP_GLOBAL
diff --git a/doc/APIchunk12.html b/doc/APIchunk12.html index b036fc8..fb3ad79 100644 --- a/doc/APIchunk12.html +++ b/doc/APIchunk12.html @@ -679,6 +679,7 @@ A:link, A:visited, A:active { text-decoration: underline } xmlTextWriterWriteDTDExternalEntityContents
contentspec
xmlParseElementContentDecl
xmlParseElementDecl
+
context?
_xmlXPathContext
contexts
_xmlDOMWrapCtxt
contextual
xmlRelaxNGGetParserErrors
xmlRelaxNGSetParserErrors
@@ -689,6 +690,8 @@ A:link, A:visited, A:active { text-decoration: underline }
contraint
_xmlSchemaElement
contrary
xmlNodeListGetRawString
xmlXPathFreeNodeSetList
+
contrast
xmlNodeAddContent
+xmlNodeAddContentLen
control
_xmlXPathContext
resolveEntity
resolveEntitySAXFunc
diff --git a/doc/APIchunk13.html b/doc/APIchunk13.html index 1c9e865..834cde1 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
@@ -323,6 +322,7 @@ A:link, A:visited, A:active { text-decoration: underline } xmlAddNextSibling
xmlAddPrevSibling
xmlTextReaderCurrentNode
+xmlTextReaderSetup
destruction
xmlDeregisterNodeDefault
details
xmlC14NDocDumpMemory
xmlC14NDocSave
@@ -374,6 +374,7 @@ A:link, A:visited, A:active { text-decoration: underline } xmlRegexpIsDeterminist
dict
_xmlDoc
dictionary
_xmlParserCtxt
+_xmlXPathContext
xmlDictCleanup
xmlDictCreate
xmlDictCreateSub
@@ -384,7 +385,6 @@ A:link, A:visited, A:active { text-decoration: underline } xmlStreamPushAttr
xmlStreamPushNode
dictionnary
_xmlParserCtxt
-_xmlXPathContext
xmlDictCreate
xmlDictCreateSub
xmlDictExists
diff --git a/doc/APIchunk14.html b/doc/APIchunk14.html index dfe748d..77106c1 100644 --- a/doc/APIchunk14.html +++ b/doc/APIchunk14.html @@ -273,6 +273,8 @@ A:link, A:visited, A:active { text-decoration: underline } xmlNewDocNode
xmlNewDocNodeEatName
xmlNewTextChild
+xmlNodeSetContent
+xmlNodeSetContentLen
xmlParseCDSect
xmlParseCharData
xmlSaveUri
diff --git a/doc/APIchunk15.html b/doc/APIchunk15.html index 5bd7b26..802fb82 100644 --- a/doc/APIchunk15.html +++ b/doc/APIchunk15.html @@ -122,6 +122,7 @@ A:link, A:visited, A:active { text-decoration: underline } xmlNewTextReaderFilename
xmlStreamPushNode
xmlStreamWantsAnyNode
+
feed
xmlTextReaderSetup
fetch
xmlNanoFTPGetSocket
xmlNanoFTPOpen
xmlNanoHTTPFetch
diff --git a/doc/APIchunk17.html b/doc/APIchunk17.html index 9842c3a..c92691a 100644 --- a/doc/APIchunk17.html +++ b/doc/APIchunk17.html @@ -482,6 +482,7 @@ A:link, A:visited, A:active { text-decoration: underline }
interpreter
xmlXPathAxisFunc
intersection
xmlXPathIntersection
invalid
XML_SCHEMAS_TYPE_INTERNAL_INVALID
+xmlParseSDDecl
xmlReconciliateNs
xmlValidateDtdFinal
invited
xmlValidGetValidElements
diff --git a/doc/APIchunk19.html b/doc/APIchunk19.html index 5bb6121..98688f2 100644 --- a/doc/APIchunk19.html +++ b/doc/APIchunk19.html @@ -153,6 +153,7 @@ A:link, A:visited, A:active { text-decoration: underline }
maybe
_xmlSchemaElement
mean
xmlPatternMinDepth
means
xmlExpNewRange
+xmlParseSDDecl
xmlSetGenericErrorFunc
xmlSetStructuredErrorFunc
xmlStreamPush
@@ -243,6 +244,7 @@ A:link, A:visited, A:active { text-decoration: underline }
misc
xmlXPathContextSetCache
misleading
xmlParsePEReference
xmlParserHandlePEReference
+
missing
xmlParseSDDecl
mixed
XML_SCHEMAS_TYPE_MIXED
xmlKeepBlanksDefault
mixed-content
xmlParseElementMixedContentDecl
diff --git a/doc/APIchunk20.html b/doc/APIchunk20.html index 2a9174d..97a8fc6 100644 --- a/doc/APIchunk20.html +++ b/doc/APIchunk20.html @@ -100,6 +100,8 @@ A:link, A:visited, A:active { text-decoration: underline } xmlNewDocNode
xmlNewDocNodeEatName
xmlNewTextChild
+xmlNodeSetContent
+xmlNodeSetContentLen
xmlParseEntityRef
xmlParserHandleReference
xmlRegExecErrInfo
diff --git a/doc/APIchunk21.html b/doc/APIchunk21.html index f7cf410..a49e002 100644 --- a/doc/APIchunk21.html +++ b/doc/APIchunk21.html @@ -240,6 +240,7 @@ A:link, A:visited, A:active { text-decoration: underline } xmlSaveToFilename
xmlSaveToIO
xmlTextReaderSchemaValidateCtxt
+xmlTextReaderSetup
xmlXPathContextSetCache
ordered
xmlListAppend
xmlListInsert
diff --git a/doc/APIchunk22.html b/doc/APIchunk22.html index bd256cb..f823421 100644 --- a/doc/APIchunk22.html +++ b/doc/APIchunk22.html @@ -162,6 +162,8 @@ A:link, A:visited, A:active { text-decoration: underline }
piece
xmlNewChild
xmlNewDocNode
xmlNewDocNodeEatName
+xmlNodeSetContent
+xmlNodeSetContentLen
pieces
xmlParseURIRaw
place
xmlCatalogAdd
xmlCopyError
diff --git a/doc/APIchunk23.html b/doc/APIchunk23.html index effe8f5..91b1835 100644 --- a/doc/APIchunk23.html +++ b/doc/APIchunk23.html @@ -101,6 +101,8 @@ A:link, A:visited, A:active { text-decoration: underline } xmlNamespaceParseNCName
xmlNamespaceParseNSDef
xmlNamespaceParseQName
+xmlNodeAddContent
+xmlNodeAddContentLen
xmlParseCDSect
xmlParserInputBufferGrow
xmlTextWriterWriteFormatRaw
@@ -246,8 +248,12 @@ A:link, A:visited, A:active { text-decoration: underline } xmlNewChild
xmlNewDocNode
xmlNewDocNodeEatName
+xmlNodeAddContent
+xmlNodeAddContentLen
xmlNodeBufGetContent
xmlNodeGetContent
+xmlNodeSetContent
+xmlNodeSetContentLen
xmlParseAttribute
xmlParseCharRef
xmlParseEntityRef
@@ -512,6 +518,8 @@ A:link, A:visited, A:active { text-decoration: underline } xmlSchematronFreeValidCtxt
xmlTextReaderClose
xmlXIncludeSetFlags
+
resp
xmlNodeSetContent
+xmlNodeSetContentLen
respect
xmlExpStringDerive
respecting
xmlValidGetValidElements
response
xmlNanoFTPCheckResponse
diff --git a/doc/APIchunk24.html b/doc/APIchunk24.html index b737b67..a965455 100644 --- a/doc/APIchunk24.html +++ b/doc/APIchunk24.html @@ -493,6 +493,10 @@ A:link, A:visited, A:active { text-decoration: underline } xmlNewChild
xmlNewDocNode
xmlNewDocNodeEatName
+xmlNodeAddContent
+xmlNodeAddContentLen
+xmlNodeSetContent
+xmlNodeSetContentLen
xmlTextWriterWriteRawLen
specialized
_xmlDOMWrapCtxt
xmlGcMemGet
@@ -529,8 +533,10 @@ A:link, A:visited, A:active { text-decoration: underline } xmlParseSDDecl
xmlSAX2IsStandalone
xmlTextReaderStandalone
-
standalone=
xmlParseEntityRef
+
standalone=
_xmlDoc
+xmlParseEntityRef
xmlParsePEReference
+xmlParseSDDecl
xmlParserHandlePEReference
standalone?
isStandaloneSAXFunc
standard
docbParseDocument
@@ -859,6 +865,8 @@ A:link, A:visited, A:active { text-decoration: underline } xmlDOMWrapRemoveNode
xmlInitCharEncodingHandlers
xmlNanoFTPGetConnection
+xmlNodeAddContent
+xmlNodeAddContentLen
xmlSchemaGetCanonValue
xmlSchemaGetCanonValueWhtsp
xmlTextReaderNormalization
@@ -866,6 +874,10 @@ A:link, A:visited, A:active { text-decoration: underline } xmlNewChild
xmlNewDocNode
xmlNewDocNodeEatName
+xmlNodeAddContent
+xmlNodeAddContentLen
+xmlNodeSetContent
+xmlNodeSetContentLen
xmlStrcat
xmlStrdup
sure
xmlSaveClose
diff --git a/doc/APIchunk26.html b/doc/APIchunk26.html index 828659a..5606555 100644 --- a/doc/APIchunk26.html +++ b/doc/APIchunk26.html @@ -58,6 +58,8 @@ A:link, A:visited, A:active { text-decoration: underline }
understand
xmlExpParse
unescape
xmlURIUnescapeString
unescaped
xmlFileOpen
+xmlNodeAddContent
+xmlNodeAddContentLen
xmlURIUnescapeString
unescaping
xmlParseURIRaw
unicode
htmlEntityValueLookup
diff --git a/doc/APIchunk28.html b/doc/APIchunk28.html index 05bde7b..97bb1b7 100644 --- a/doc/APIchunk28.html +++ b/doc/APIchunk28.html @@ -163,6 +163,10 @@ A:link, A:visited, A:active { text-decoration: underline } xmlNewChild
xmlNewDocNode
xmlNewDocNodeEatName
+xmlNodeSetContent
+xmlNodeSetContentLen
+
xmlEncodeSpecialChars
xmlNodeSetContent
+xmlNodeSetContentLen
xmlEntitiesTablePtr
xmlCopyEntitiesTable
xmlCreateEntitiesTable
xmlEntityPtr
getEntity
@@ -290,6 +294,8 @@ A:link, A:visited, A:active { text-decoration: underline } xmlXPathNodeSetDel
xmlXPathNodeSetItem
xmlXPtrBuildNodeList
+
xmlNodeSetContent
xmlNodeAddContent
+
xmlNodeSetContentLen
xmlNodeAddContentLen
xmlNodeSetPtr
xmlXPathFreeNodeSet
xmlXPathNodeSetCreate
xmlNodeType
xmlTextReaderNodeType
@@ -330,6 +336,7 @@ A:link, A:visited, A:active { text-decoration: underline }
xmlParserHandleReference
xmlScanName
xmlParserInputBufferPtr
xmlNewTextReader
xmlTextReaderGetRemainder
+xmlTextReaderSetup
xmlParserInputPtr
resolveEntity
resolveEntitySAXFunc
xmlFreeInputStream
diff --git a/doc/APIchunk29.html b/doc/APIchunk29.html index 92c88b4..2e413da 100644 --- a/doc/APIchunk29.html +++ b/doc/APIchunk29.html @@ -38,7 +38,8 @@ A:link, A:visited, A:active { text-decoration: underline } x-x y-z

Letter y:

year
ftpListCallback
-
yes
xmlInputMatchCallback
+
yes
_xmlDoc
+xmlInputMatchCallback
xmlIsBlankNode
xmlIsMixedElement
xmlNodeIsText
diff --git a/doc/APIchunk4.html b/doc/APIchunk4.html index b3c8364..4b74048 100644 --- a/doc/APIchunk4.html +++ b/doc/APIchunk4.html @@ -211,6 +211,10 @@ A:link, A:visited, A:active { text-decoration: underline } xmlNewTextChild
xmlNewTextWriter
xmlNewTextWriterPushParser
+xmlNodeAddContent
+xmlNodeAddContentLen
+xmlNodeSetContent
+xmlNodeSetContentLen
xmlParseExternalID
xmlParsePEReference
xmlParserHandlePEReference
diff --git a/doc/APIchunk7.html b/doc/APIchunk7.html index ed7c4a2..c8cde3b 100644 --- a/doc/APIchunk7.html +++ b/doc/APIchunk7.html @@ -188,6 +188,7 @@ A:link, A:visited, A:active { text-decoration: underline } xmlReaderNewMemory
xmlReaderNewWalker
xmlSetupParserForBuffer
+xmlTextReaderSetup
Shavian
xmlUCSIsShavian
Shell
xmlShellReadlineFunc
Shema
xmlRelaxNGParse
diff --git a/doc/APIfiles.html b/doc/APIfiles.html index e10fe00..8a3f6d7 100644 --- a/doc/APIfiles.html +++ b/doc/APIfiles.html @@ -2719,6 +2719,7 @@ A:link, A:visited, A:active { text-decoration: underline } xmlTextReaderSetParserProp
xmlTextReaderSetSchema
xmlTextReaderSetStructuredErrorHandler
+xmlTextReaderSetup
xmlTextReaderStandalone
xmlTextReaderValue
xmlTextReaderXmlLang
diff --git a/doc/APIfunctions.html b/doc/APIfunctions.html index fea4fd3..bbfd181 100644 --- a/doc/APIfunctions.html +++ b/doc/APIfunctions.html @@ -1768,6 +1768,7 @@ A:link, A:visited, A:active { text-decoration: underline } xmlParserInputBufferPush
xmlParserInputBufferRead
xmlSchemaValidateStream
+xmlTextReaderSetup

Type xmlParserInputPtr:

inputPush
xmlCheckHTTPInput
xmlFreeInputStream
@@ -2059,6 +2060,7 @@ A:link, A:visited, A:active { text-decoration: underline } xmlTextReaderSetParserProp
xmlTextReaderSetSchema
xmlTextReaderSetStructuredErrorHandler
+xmlTextReaderSetup
xmlTextReaderStandalone
xmlTextReaderValue
xmlTextReaderXmlLang
diff --git a/doc/APIsymbols.html b/doc/APIsymbols.html index c6c5265..4cfeef8 100644 --- a/doc/APIsymbols.html +++ b/doc/APIsymbols.html @@ -2939,6 +2939,7 @@ A:link, A:visited, A:active { text-decoration: underline } xmlTextReaderSetParserProp
xmlTextReaderSetSchema
xmlTextReaderSetStructuredErrorHandler
+xmlTextReaderSetup
xmlTextReaderStandalone
xmlTextReaderValue
xmlTextReaderXmlLang
diff --git a/doc/DOM.html b/doc/DOM.html index 52f1139..90b988b 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 0d5ded6..6bc67ec 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. +

  3. 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/

  4. +

  5. 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.
  6. +

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

  8. -
  9. I use the CVS version and there is no configure script +
  10. 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 657ead3..c483e04 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 6415c85..d37423b 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:

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

  • -
  • 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 @@ -525,7 +531,7 @@ xmlDtdPtr dtd = xmlParseDTD(NULL, filename_of_dtd); /* parse the DTD */

  • George Lebl wrote an article for IBM developerWorks about using libxml.
  • -
  • Check the TODO +
  • Check the TODO file.
  • Read the 1.x to 2.x upgrade path description. If you are starting a new project using libxml you should @@ -545,7 +551,7 @@ 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 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.

    +information.

    Check the following before posting:

    @@ -604,7 +610,7 @@ answer a given question, ask on the list.

    others" and is not welcome. I will automatically Carbon-Copy the xml@gnome.org mailing list for any technical reply made about libxml2 or libxslt.
  • -
  • There is no garantee of support, if +
  • There is no guarantee of support. If your question remains unanswered after a week, repost it, making sure you gave all the detail needed and the information requested.
  • Failing to provide information as requested or double checking first @@ -651,8 +657,7 @@ database:

    The latest versions of libxml2 can be found on the xmlsoft.org server ( HTTP, FTP and rsync are available), there is also +href="ftp://xmlsoft.org/libxml2/">FTP and rsync are available), there are also mirrors (Australia( Web), France) or on the contact me.

    Snapshot:

    The change log describes the recents commits -to the CVS code base.

    - -

    There is the list of public releases:

    - +to the SVN code base.

    + +

    Here is the list of public releases:

    + +

    2.6.28: Apr 17 2007

    +
      +
    • Documentation: comment fixes (Markus Keim), xpath comments fixes too + (James Dennett)
    • +
    • Bug fixes: XPath bug (William Brack), HTML parser autoclose stack usage + (Usamah Malik), various regexp bug fixes (DV and William), path conversion + on Windows (Igor Zlatkovic), htmlCtxtReset fix (Michael Day), XPath + principal node of axis bug, HTML serialization of some codepoint + (Steven Rainwater), user data propagation in XInclude (Michael Day), + standalone and XML decl detection (Michael Day), Python id ouptut + for some id, fix the big python string memory leak, URI parsing fixes + (Stéphane Bidoul and William), long comments parsing bug (William), + concurrent threads initialization (Ted Phelps), invalid char + in text XInclude (William), XPath memory leak (William), tab in + python problems (Andreas Hanke), XPath node comparison error + (Oleg Paraschenko), cleanup patch for reader (Julien Reichel), + XML Schemas attribute group (William), HTML parsing problem (William), + fix char 0x2d in regexps (William), regexp quantifier range with + min occurs of 0 (William), HTML script/style parsing (Mike Day)
    • +
    • Improvement: make xmlTextReaderSetup() public
    • +
    • Compilation and postability: fix a missing include problem (William), + __ss_familly on AIX again (Björn Wiberg), compilation without zlib + (Michael Day), catalog patch for Win32 (Christian Ehrlicher), + Windows CE fixes (Andreas Stricke)
    • +
    • Various CVS to SVN infrastructure changes
    • +

    2.6.27: Oct 25 2006

    • Portability fixes: file names on windows (Roland Schwingel, @@ -1430,7 +1461,7 @@ to the CVS code base.

    • New xmlWriter API provided by Alfred Mickautsch
    • Schemas: base64 support by Anthony Carrico
    • Parser<->HTTP integration fix, proper processing of the Mime-Type - and charset informations if available.
    • + and charset information if available.
    • Relax-NG: bug fixes including the one reported by Martijn Faassen and zeroOrMore, better error reporting.
    • Python bindings (Stéphane Bidoul), never use stdout for errors @@ -1667,7 +1698,7 @@ to the CVS code base.

    • Fix for HTTP URL escaping problem
    • added an TextXmlReader (C#) like API (work in progress)
    • Rewrote the API in XML generation script, includes a C parser and saves - more informations needed for C# bindings
    • + more information needed for C# bindings

    2.4.28: Nov 22 2002

    @@ -2560,7 +2591,7 @@ 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.

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

    You can check the progresses on the libxslt Changelog.

    @@ -2613,7 +2644,7 @@ or libxslt wrappers or bindings:

  • Steve Ball and contributors maintains libxml2 and libxslt bindings for Tcl.
  • -
  • libxml2 and libxslt is the default XML library for PHP5.
  • +
  • libxml2 and libxslt are the default XML libraries for PHP5.
  • LibxmlJ is an effort to create a 100% JAXP-compatible Java wrapper for libxml2 and libxslt as part of GNU ClasspathX project.
  • @@ -2739,8 +2770,8 @@ the error messages when trying to validate the invalid document.

    The main interest of that test is the creation of a parser context with createFileParserCtxt() and how the behaviour can be changed before calling -parseDocument() . Similarly the informations resulting from the parsing phase -are also available using context methods.

    +parseDocument() . Similarly the information resulting from the parsing phase +is also available using context methods.

    Contexts like nodes are defined as class and the libxml2 wrappers maps the C function interfaces in terms of objects method as much as possible. The @@ -3340,7 +3371,7 @@ or call a specific routine when a given block number is allocated:

    href="http://xmlsoft.org/html/libxml-xmlmemory.html">xmlMemStrdupLoc() are the memory debugging replacement allocation routines
  • xmlMemoryDump - () dumps all the informations about the allocated memory block lefts + () dumps all the information about the allocated memory block lefts in the .memdump file
  • @@ -3352,7 +3383,7 @@ allocations use (some libc implementations are known to be far too permissive resulting in major portability problems!).

    If the .memdump reports a leak, it displays the allocation function and -also tries to give some informations about the content and structure of the +also tries to give some information about the content and structure of the allocated blocks left. This is sufficient in most cases to find the culprit, but not always. Assuming the allocation problem is reproducible, it is possible to find more easily:

    @@ -3455,7 +3486,7 @@ French like for both markup and content:

    Having internationalization support in libxml2 means the following:

    • the document is properly parsed
    • -
    • informations about it's encoding are saved
    • +
    • information about it's encoding is saved
    • it can be modified
    • it can be saved in its original encoding
    • it can also be saved in another encoding supported by libxml2 (for @@ -3707,7 +3738,7 @@ the interfaces to the libxml2 I/O system. This consists of 4 main parts:

      xmlSetExternalEntityLoader(). Check the example.
    • Input I/O buffers which are a commodity structure used by the parser(s) - input layer to handle fetching the informations to feed the parser. This + input layer to handle fetching the information to feed the parser. This provides buffering and is also a placeholder where the encoding converters to UTF8 are piggy-backed.
    • Output I/O buffers are similar to the Input ones and fulfill similar @@ -4008,7 +4039,7 @@ default catalog

      How to debug catalog processing:

      Setting up the XML_DEBUG_CATALOG environment variable will -make libxml2 output debugging informations for each catalog operations, for +make libxml2 output debugging information for each catalog operations, for example:

      orchis:~/XML -> xmllint --memory --noout test/ent2
       warning: failed to load external entity "title.xml"
      @@ -4210,7 +4241,7 @@ literature to point at:

      • You can find a good rant from Norm Walsh about the - need for catalogs, it provides a lot of context informations even if + need for catalogs, it provides a lot of context information even if I don't agree with everything presented. Norm also wrote a more recent article XML @@ -4763,10 +4794,10 @@ 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 +href="http:///svn.gnome.org/viewcvs/gdome2/trunk/">gdome2 Gnome module, this is a full DOM interface, thanks to Paolo Casarini, check the Gdome2 homepage for more -informations.

        +href="http://gdome2.cs.unibo.it/">Gdome2 homepage for more +information.

        A real example

        @@ -4963,7 +4994,7 @@ storage. This is left as an exercise to the reader :-)

        Feel free to use the code for the full C parsing example as a template, it is also available with Makefile in the -Gnome CVS base under gnome-xml/example

        +Gnome SVN base under libxml2/example

        Contributions

          diff --git a/doc/xmlcatalog_man.xml b/doc/xmlcatalog_man.xml index 8b45d44..08d3a41 100644 --- a/doc/xmlcatalog_man.xml +++ b/doc/xmlcatalog_man.xml @@ -26,7 +26,7 @@ - $Date: 2006/08/21 08:34:11 $ + $Date: 2006-08-21 10:34:11 +0200 (Mon, 21 Aug 2006) $ diff --git a/doc/xmlio.html b/doc/xmlio.html index 60188df..1e6f6fc 100644 --- a/doc/xmlio.html +++ b/doc/xmlio.html @@ -22,7 +22,7 @@ the interfaces to the libxml2 I/O system. This consists of 4 main parts:

            xmlSetExternalEntityLoader(). Check the example.
          • Input I/O buffers which are a commodity structure used by the parser(s) - input layer to handle fetching the informations to feed the parser. This + input layer to handle fetching the information to feed the parser. This provides buffering and is also a placeholder where the encoding converters to UTF8 are piggy-backed.
          • Output I/O buffers are similar to the Input ones and fulfill similar diff --git a/doc/xmllint.xml b/doc/xmllint.xml index 9757675..f9f4692 100644 --- a/doc/xmllint.xml +++ b/doc/xmllint.xml @@ -46,7 +46,7 @@ - $Date: 2006/08/21 08:34:11 $ + $Date: 2006-08-21 10:34:11 +0200 (Mon, 21 Aug 2006) $ diff --git a/doc/xmlmem.html b/doc/xmlmem.html index 58c2987..425ce23 100644 --- a/doc/xmlmem.html +++ b/doc/xmlmem.html @@ -49,7 +49,7 @@ or call a specific routine when a given block number is allocated:

            • xmlMemStrdupLoc() are the memory debugging replacement allocation routines
            • xmlMemoryDump - () dumps all the informations about the allocated memory block lefts + () dumps all the information about the allocated memory block lefts in the .memdump file

            When developing libxml2 memory debug is enabled, the tests programs call xmlMemoryDump () and the "make test" regression tests will check for any @@ -57,7 +57,7 @@ memory leak during the full regression test sequence, this helps a lot ensuring that libxml2 does not leak memory and bullet proof memory allocations use (some libc implementations are known to be far too permissive resulting in major portability problems!).

            If the .memdump reports a leak, it displays the allocation function and -also tries to give some informations about the content and structure of the +also tries to give some information about the content and structure of the allocated blocks left. This is sufficient in most cases to find the culprit, but not always. Assuming the allocation problem is reproducible, it is possible to find more easily:

            1. write down the block number xxxx not allocated
            2. diff --git a/doc/xmlreader.html b/doc/xmlreader.html index b8382a8..416f047 100644 --- a/doc/xmlreader.html +++ b/doc/xmlreader.html @@ -468,7 +468,7 @@ process to the successor or return 0 if the document end is reached.

              Daniel Veillard

              -

              $Id: xmlreader.html,v 1.9 2005/10/18 19:11:54 veillard Exp $

              +

              $Id: xmlreader.html 3320 2005-10-18 19:11:55Z veillard $

              -- cgit v1.2.3