From fc97906edfc501278820fdcd3fc05efcbded1538 Mon Sep 17 00:00:00 2001 From: Daniel Veillard Date: Thu, 4 Mar 2004 22:07:16 +0000 Subject: [PATCH] paalied patch from Julio M. Merino Vidal fixing bug #134751 to fix * configure.in doc/Makefile.am include/libxml/Makefile.am: paalied patch from Julio M. Merino Vidal fixing bug #134751 to fix --with-html-dir option. * doc/*: rebuilt fully the docs * doc/html/libxml-xmlsave.html: new file from new header. Daniel --- ChangeLog | 8 + configure.in | 16 +- doc/APIchunk1.html | 1 + doc/APIchunk10.html | 1 + doc/APIchunk11.html | 2 + doc/APIchunk13.html | 1 + doc/APIchunk14.html | 2 + doc/APIchunk16.html | 3 +- doc/APIchunk17.html | 2 + doc/APIchunk19.html | 4 + doc/APIchunk20.html | 1 + doc/APIchunk21.html | 1 + doc/APIchunk22.html | 22 +- doc/APIchunk24.html | 1 + doc/APIchunk25.html | 4 + doc/APIchunk3.html | 3 +- doc/APIchunk6.html | 2 + doc/APIchunk9.html | 1 + doc/APIconstructors.html | 6 + doc/APIfiles.html | 10 + doc/APIfunctions.html | 10 + doc/APIsymbols.html | 10 + doc/Makefile.am | 29 +-- doc/examples/.cvsignore | 10 +- doc/examples/Makefile.am | 72 +++--- doc/examples/examples.xml | 428 ++++++++++++++++---------------- doc/examples/index.py | 8 +- doc/html/book1.html | 2 +- doc/html/index.html | 2 +- doc/html/libxml-lib.html | 2 +- doc/html/libxml-xmlregexp.html | 2 +- doc/html/libxml-xmlsave.html | 43 ++++ doc/html/libxml-xmlschemas.html | 2 +- doc/libxml2-api.xml | 69 +++++ doc/libxml2-refs.xml | 103 ++++++++ include/libxml/Makefile.am | 3 +- 36 files changed, 589 insertions(+), 297 deletions(-) create mode 100644 doc/html/libxml-xmlsave.html diff --git a/ChangeLog b/ChangeLog index 6fb95227..3e1dfb4e 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,11 @@ +Thu Mar 4 23:03:02 CET 2004 Daniel Veillard + + * configure.in doc/Makefile.am include/libxml/Makefile.am: + paalied patch from Julio M. Merino Vidal fixing bug #134751 + to fix --with-html-dir option. + * doc/*: rebuilt fully the docs + * doc/html/libxml-xmlsave.html: new file from new header. + Thu Mar 4 16:57:50 CET 2004 Daniel Veillard * debugXML.c testHTML.c tree.c doc/examples/*.c diff --git a/configure.in b/configure.in index 6acc92d7..07d6fa50 100644 --- a/configure.in +++ b/configure.in @@ -24,9 +24,6 @@ VERSION=${LIBXML_VERSION} AM_INIT_AUTOMAKE(libxml2, $VERSION) -AC_ARG_WITH(html-dir, -[ --with-html-dir=PATH path to installed docs ]) - dnl Checks for programs. AC_PROG_CC AC_PROG_INSTALL @@ -158,11 +155,14 @@ AC_CHECK_HEADERS([resolv.h], [], [], ]) dnl Specific dir for HTML output ? -if test "x$with_html_dir" = "x" ; then - HTML_DIR='$(prefix)/doc' -else - HTML_DIR=$with_html_dir -fi +AC_ARG_WITH(html-dir, AC_HELP_STRING([--with-html-dir=path], + [path to base html directory, default $datadir/doc/html]), + [HTML_DIR=$withval], [HTML_DIR='$(datadir)/doc']) + +AC_ARG_WITH(html-subdir, AC_HELP_STRING([--with-html-subdir=path], + [directory used under html-dir, default $PACKAGE-$VERSION/html]), + [test "x$withval" != "x" && HTML_DIR="$HTML_DIR/$withval"], + [HTML_DIR="$HTML_DIR/\$(PACKAGE)-\$(VERSION)/html"]) AC_SUBST(HTML_DIR) diff --git a/doc/APIchunk1.html b/doc/APIchunk1.html index 707c44b0..fcb4784b 100644 --- a/doc/APIchunk1.html +++ b/doc/APIchunk1.html @@ -209,6 +209,7 @@ A:link, A:visited, A:active { text-decoration: underline } xmlIOHTTPClose
xmlNanoFTPClose
xmlNanoFTPCloseConnection
+xmlSaveClose
Closed
xmlTextReaderClose
CombiningChar
IS_COMBINING
xmlNamespaceParseNCName
diff --git a/doc/APIchunk10.html b/doc/APIchunk10.html index 6afa7973..6def6a85 100644 --- a/doc/APIchunk10.html +++ b/doc/APIchunk10.html @@ -334,6 +334,7 @@ A:link, A:visited, A:active { text-decoration: underline } xmlReadIO
xmlReaderForIO
xmlReaderNewIO
+xmlSaveToIO
xmlTextReaderClose
closed
xmlCtxtReadFd
xmlReadFd
diff --git a/doc/APIchunk11.html b/doc/APIchunk11.html index 37a4f3bd..d8c29511 100644 --- a/doc/APIchunk11.html +++ b/doc/APIchunk11.html @@ -269,6 +269,8 @@ A:link, A:visited, A:active { text-decoration: underline } xmlReadFd
xmlReaderForFd
xmlReaderNewFd
+xmlSaveToFd
+xmlSaveToIO
designed
xmlCharEncodingOutputFunc
xmlLoadExternalEntity
desired
xmlBufferResize
diff --git a/doc/APIchunk13.html b/doc/APIchunk13.html index 1abf76be..a1ce7103 100644 --- a/doc/APIchunk13.html +++ b/doc/APIchunk13.html @@ -311,6 +311,7 @@ A:link, A:visited, A:active { text-decoration: underline } xmlHashScannerFull
xmlRelaxNGValidateFullElement
xmlRelaxNGValidatePushElement
+xmlSaveDoc
xmlShellPwd
xmlSplitQName2
xmlSplitQName3
diff --git a/doc/APIchunk14.html b/doc/APIchunk14.html index 0f656578..b85c1ef2 100644 --- a/doc/APIchunk14.html +++ b/doc/APIchunk14.html @@ -232,6 +232,8 @@ A:link, A:visited, A:active { text-decoration: underline } xmlParseSDDecl
xmlParserHandlePEReference
xmlParserHandleReference
+xmlSaveClose
+xmlSaveFlush
xmlStrEqual
xmlTextReaderHasValue
xmlTextReaderReadAttributeValue
diff --git a/doc/APIchunk16.html b/doc/APIchunk16.html index dc6e0ef7..09a4a004 100644 --- a/doc/APIchunk16.html +++ b/doc/APIchunk16.html @@ -155,7 +155,8 @@ A:link, A:visited, A:active { text-decoration: underline } xmlSplitQName3
xmlValidatePushCData
length-1
xmlXPathNodeSetItem
-
less
xmlXPathCeilingFunction
+
less
xmlSaveToFilename
+xmlXPathCeilingFunction
xmlXPathCompareValues
xmlXPathSubstringFunction
less-than
xmlNewTextChild
diff --git a/doc/APIchunk17.html b/doc/APIchunk17.html index 9e1b43b1..df28dfca 100644 --- a/doc/APIchunk17.html +++ b/doc/APIchunk17.html @@ -51,6 +51,8 @@ A:link, A:visited, A:active { text-decoration: underline } xmlRemoveRef
major
xmlDecodeEntities
make
xmlNewNode
+xmlSaveClose
+xmlSaveFlush
makes
xmlLoadCatalog
xmlLoadCatalogs
xmlTextReaderExpand
diff --git a/doc/APIchunk19.html b/doc/APIchunk19.html index 56f16b30..cbce12b2 100644 --- a/doc/APIchunk19.html +++ b/doc/APIchunk19.html @@ -218,6 +218,10 @@ A:link, A:visited, A:active { text-decoration: underline } xmlURIUnescapeString
options
htmlCtxtUseOptions
xmlCtxtUseOptions
+xmlSaveToBuffer
+xmlSaveToFd
+xmlSaveToFilename
+xmlSaveToIO
ordered
xmlListAppend
xmlListInsert
xmlXPathNextAncestor
diff --git a/doc/APIchunk20.html b/doc/APIchunk20.html index 58fad06f..10ad6e02 100644 --- a/doc/APIchunk20.html +++ b/doc/APIchunk20.html @@ -211,6 +211,7 @@ A:link, A:visited, A:active { text-decoration: underline } xmlParseBalancedChunkMemory
xmlParseBalancedChunkMemoryRecover
xmlParseExternalEntity
+xmlSaveToFilename
xmlXPathStringFunction
posteriori
xmlSetNs
potential
xmlValidGetPotentialChildren
diff --git a/doc/APIchunk21.html b/doc/APIchunk21.html index abbfa1af..84fe917b 100644 --- a/doc/APIchunk21.html +++ b/doc/APIchunk21.html @@ -329,6 +329,7 @@ A:link, A:visited, A:active { text-decoration: underline } xmlDecodeEntities
xmlUnlockLibrary
releases
xmlTextReaderClose
+
reliable
xmlSaveToFilename
rely
xmlParseNamespace
remainder
xmlTextReaderGetRemainder
remaining
xmlCreatePushParserCtxt
diff --git a/doc/APIchunk22.html b/doc/APIchunk22.html index d0233a94..15e00971 100644 --- a/doc/APIchunk22.html +++ b/doc/APIchunk22.html @@ -80,6 +80,14 @@ A:link, A:visited, A:active { text-decoration: underline } xmlOutputBufferCreateFile
xmlOutputBufferCreateFilename
xmlOutputBufferCreateIO
+xmlSaveClose
+xmlSaveDoc
+xmlSaveFlush
+xmlSaveToBuffer
+xmlSaveToFd
+xmlSaveToFilename
+xmlSaveToIO
+xmlSaveTree
sax
docbSAXParseDoc
docbSAXParseFile
htmlSAXParseDoc
@@ -184,10 +192,18 @@ A:link, A:visited, A:active { text-decoration: underline } xmlValidNormalizeAttributeValue
xmlXPathNormalizeFunction
serialization
LIBXML_OUTPUT_ENABLED
+xmlSaveToBuffer
+xmlSaveToFd
+xmlSaveToFilename
+xmlSaveToIO
xmlShellCat
xmlShellWrite
xmlValidatePopElement
xmlValidatePushElement
+
serializing
xmlSaveToBuffer
+xmlSaveToFd
+xmlSaveToFilename
+xmlSaveToIO
server
_xmlURI
xmlNanoFTPCheckResponse
xmlNanoFTPCloseConnection
@@ -495,6 +511,7 @@ A:link, A:visited, A:active { text-decoration: underline } xmlByteConsumed
xmlNewCharRef
xmlNewTextWriterTree
+xmlSaveTree
xmlXPathOrderDocElems
xmlXPathSubstringFunction
xmlXPtrNewCollapsedRange
@@ -702,6 +719,7 @@ A:link, A:visited, A:active { text-decoration: underline } attributeSAXFunc
xmlReconciliateNs
xmlRelaxNGValidateFullElement
+xmlSaveTree
xmlShellDu
xmlShellWrite
xmlTextReaderExpand
@@ -763,7 +781,9 @@ A:link, A:visited, A:active { text-decoration: underline } xmlNewDocNodeEatName
xmlStrcat
xmlStrdup
-
sure
xmlURIEscape
+
sure
xmlSaveClose
+xmlSaveFlush
+xmlURIEscape
xmlXPathNodeSetAddUnique
surprising
xmlRegisterCharEncodingHandler
surrogate
IS_CHAR
diff --git a/doc/APIchunk24.html b/doc/APIchunk24.html index ac217c77..d418a4f5 100644 --- a/doc/APIchunk24.html +++ b/doc/APIchunk24.html @@ -413,6 +413,7 @@ A:link, A:visited, A:active { text-decoration: underline } xmlNewCharEncodingHandler
xmlOutputBufferCreateIO
xmlOutputWriteCallback
+xmlSaveToIO
xmlShellWrite
writer
xmlFreeTextWriter
writes
xmlBufferWriteQuotedString
diff --git a/doc/APIchunk25.html b/doc/APIchunk25.html index 01bc2c69..cabe9f1d 100644 --- a/doc/APIchunk25.html +++ b/doc/APIchunk25.html @@ -355,6 +355,10 @@ A:link, A:visited, A:active { text-decoration: underline }
xmlSAX2StartElement
startElement
xmlSAX2UnparsedEntityDecl
unparsedEntityDecl
xmlSAXVersion
xmlSAXDefaultVersion
+
xmlSaveOptions
xmlSaveToBuffer
+xmlSaveToFd
+xmlSaveToFilename
+xmlSaveToIO
xmlSetExternalEntityLoader
resolveEntity
resolveEntitySAXFunc
xmlSAX2ResolveEntity
diff --git a/doc/APIchunk3.html b/doc/APIchunk3.html index 17625ae3..90610c8a 100644 --- a/doc/APIchunk3.html +++ b/doc/APIchunk3.html @@ -71,7 +71,8 @@ A:link, A:visited, A:active { text-decoration: underline } xmlValidateOneAttribute
xmlValidateOneNamespace
Float
xmlXPathStringEvalNumber
-
Flush
xmlTextWriterFlush
+
Flush
xmlSaveFlush
+xmlTextWriterFlush
For
_xmlParserCtxt
xmlC14NDocDumpMemory
xmlC14NDocSave
diff --git a/doc/APIchunk6.html b/doc/APIchunk6.html index dae47ac9..ad2ce0ca 100644 --- a/doc/APIchunk6.html +++ b/doc/APIchunk6.html @@ -260,6 +260,8 @@ A:link, A:visited, A:active { text-decoration: underline } xmlSAX2InternalSubset
Same
IS_PUBIDCHAR_CH
Save
xmlCopyError
+xmlSaveDoc
+xmlSaveTree
xmlSaveUri
Scan
xmlHashCopy
xmlHashScan
diff --git a/doc/APIchunk9.html b/doc/APIchunk9.html index 3f87ef88..a3fc71e7 100644 --- a/doc/APIchunk9.html +++ b/doc/APIchunk9.html @@ -245,6 +245,7 @@ A:link, A:visited, A:active { text-decoration: underline } xmlParsePEReference
xmlParserHandlePEReference
xmlParserInputBufferCreateStatic
+xmlSaveToFilename
xmlScanName
xmlSetupParserForBuffer
xmlStrncatNew
diff --git a/doc/APIconstructors.html b/doc/APIconstructors.html index e0a21098..af60a888 100644 --- a/doc/APIconstructors.html +++ b/doc/APIconstructors.html @@ -79,6 +79,8 @@ A:link, A:visited, A:active { text-decoration: underline } htmlNodeStatus

Type long:

xmlByteConsumed
xmlGetLineNo
+xmlSaveDoc
+xmlSaveTree
xmlXPathOrderDocElems

Type unsigned long:

xmlParserFindNodeInfoIndex

Type void *:

xmlCatalogAddLocal
@@ -446,6 +448,10 @@ A:link, A:visited, A:active { text-decoration: underline } xmlRelaxNGNewParserCtxt

Type xmlRelaxNGPtr:

xmlRelaxNGParse

Type xmlRelaxNGValidCtxtPtr:

xmlRelaxNGNewValidCtxt
+

Type xmlSaveCtxtPtr:

xmlSaveToBuffer
+xmlSaveToFd
+xmlSaveToFilename
+xmlSaveToIO

Type xmlSchemaFacetPtr:

xmlSchemaNewFacet

Type xmlSchemaParserCtxtPtr:

xmlSchemaNewDocParserCtxt
xmlSchemaNewMemParserCtxt
diff --git a/doc/APIfiles.html b/doc/APIfiles.html index cf89b021..a36f187a 100644 --- a/doc/APIfiles.html +++ b/doc/APIfiles.html @@ -2202,6 +2202,16 @@ A:link, A:visited, A:active { text-decoration: underline } xmlRegexpIsDeterminist
xmlRegexpPrint
xmlRegexpPtr
+

Module xmlsave:

xmlSaveClose
+xmlSaveCtxt
+xmlSaveCtxtPtr
+xmlSaveDoc
+xmlSaveFlush
+xmlSaveToBuffer
+xmlSaveToFd
+xmlSaveToFilename
+xmlSaveToIO
+xmlSaveTree

Module xmlschemas:

XML_SCHEMAS_ERR_
XML_SCHEMAS_ERR_ATTRINVALID
XML_SCHEMAS_ERR_ATTRUNKNOWN
diff --git a/doc/APIfunctions.html b/doc/APIfunctions.html index 56acb102..f18e9882 100644 --- a/doc/APIfunctions.html +++ b/doc/APIfunctions.html @@ -800,6 +800,7 @@ A:link, A:visited, A:active { text-decoration: underline } xmlSAXParseMemoryWithData
xmlSAXUserParseFile
xmlSAXUserParseMemory
+xmlSaveToIO
xmlSchemaSetParserErrors
xmlSchemaSetValidErrors
xmlSchemaValidateStream
@@ -908,6 +909,7 @@ A:link, A:visited, A:active { text-decoration: underline } xmlNewTextWriterMemory
xmlNodeBufGetContent
xmlNodeDump
+xmlSaveToBuffer

Type xmlC14NIsVisibleCallback:

xmlC14NExecute

Type xmlCatalogAllow:

xmlCatalogSetDefaults

Type xmlCatalogPrefer:

xmlCatalogSetDefaultPrefer
@@ -1093,6 +1095,7 @@ A:link, A:visited, A:active { text-decoration: underline } xmlRelaxNGValidatePushElement
xmlRemoveID
xmlRemoveRef
+xmlSaveDoc
xmlSaveFile
xmlSaveFileEnc
xmlSaveFileTo
@@ -1363,6 +1366,7 @@ A:link, A:visited, A:active { text-decoration: underline } xmlRelaxNGValidatePopElement
xmlRelaxNGValidatePushElement
xmlReplaceNode
+xmlSaveTree
xmlSchemaValPredefTypeNode
xmlSearchNs
xmlSearchNsByHref
@@ -1510,10 +1514,12 @@ A:link, A:visited, A:active { text-decoration: underline } xmlSaveFormatFileTo

Type xmlOutputCloseCallback:

xmlOutputBufferCreateIO
xmlRegisterOutputCallbacks
+xmlSaveToIO

Type xmlOutputMatchCallback:

xmlRegisterOutputCallbacks

Type xmlOutputOpenCallback:

xmlRegisterOutputCallbacks

Type xmlOutputWriteCallback:

xmlOutputBufferCreateIO
xmlRegisterOutputCallbacks
+xmlSaveToIO

Type xmlParserCtxtPtr:

inputPop
inputPush
namePop
@@ -1714,6 +1720,10 @@ A:link, A:visited, A:active { text-decoration: underline }

Type xmlSAXLocatorPtr:

setDocumentLocator
setDocumentLocatorSAXFunc
xmlSAX2SetDocumentLocator
+

Type xmlSaveCtxtPtr:

xmlSaveClose
+xmlSaveDoc
+xmlSaveFlush
+xmlSaveTree

Type xmlSchemaFacetPtr:

xmlSchemaCheckFacet
xmlSchemaFreeFacet
xmlSchemaValidateFacet
diff --git a/doc/APIsymbols.html b/doc/APIsymbols.html index 6c542244..973b478e 100644 --- a/doc/APIsymbols.html +++ b/doc/APIsymbols.html @@ -2106,13 +2106,23 @@ A:link, A:visited, A:active { text-decoration: underline } xmlSAXUserParseFile
xmlSAXUserParseMemory
xmlSAXVersion
+xmlSaveClose
+xmlSaveCtxt
+xmlSaveCtxtPtr
+xmlSaveDoc
xmlSaveFile
xmlSaveFileEnc
xmlSaveFileTo
+xmlSaveFlush
xmlSaveFormatFile
xmlSaveFormatFileEnc
xmlSaveFormatFileTo
xmlSaveNoEmptyTags
+xmlSaveToBuffer
+xmlSaveToFd
+xmlSaveToFilename
+xmlSaveToIO
+xmlSaveTree
xmlSaveUri
xmlScanName
xmlSchema
diff --git a/doc/Makefile.am b/doc/Makefile.am index 09a61154..e2d2fa68 100644 --- a/doc/Makefile.am +++ b/doc/Makefile.am @@ -1,7 +1,5 @@ ## Process this file with automake to produce Makefile.in SUBDIRS=examples -# The name of the module. -DOC_MODULE=libxml2-$(VERSION) # The top-level SGML file. DOC_MAIN_XML_FILE=gnome-xml.xml @@ -9,12 +7,9 @@ DOC_MAIN_XML_FILE=gnome-xml.xml # The directory containing the source code (if it contains documentation). DOC_SOURCE_DIR=.. -HTML_DIR=$(datadir)/doc - # A file in win32 depends upon one of the doc files WIN32_DIR=$(top_srcdir)/win32 -TARGET_DIR=$(HTML_DIR)/$(DOC_MODULE)/html PAGES= architecture.html bugs.html contribs.html docs.html DOM.html \ downloads.html entities.html example.html help.html index.html \ interface.html intro.html library.html namespaces.html news.html \ @@ -94,20 +89,20 @@ maintainer-clean-local: clean rebuild: api all install-data-local: - $(mkinstalldirs) $(DESTDIR)$(TARGET_DIR) - -@INSTALL@ -m 0644 $(srcdir)/xml.html $(srcdir)/encoding.html $(srcdir)/FAQ.html $(srcdir)/structure.gif $(srcdir)/DOM.gif $(srcdir)/smallfootonly.gif $(srcdir)/redhat.gif $(srcdir)/libxml.gif $(srcdir)/w3c.png $(srcdir)/Libxml2-Logo-180x168.gif $(srcdir)/Libxml2-Logo-90x34.gif $(DESTDIR)$(TARGET_DIR) - $(mkinstalldirs) $(DESTDIR)$(TARGET_DIR)/html - -@INSTALL@ -m 0644 $(srcdir)/html/*.html $(DESTDIR)$(TARGET_DIR)/html - -@INSTALL@ -m 0644 $(srcdir)/html/*.png $(DESTDIR)$(TARGET_DIR)/html - -@INSTALL@ -m 0644 $(srcdir)/html/index.sgml $(DESTDIR)$(TARGET_DIR)/html - $(mkinstalldirs) $(DESTDIR)$(TARGET_DIR)/tutorial + $(mkinstalldirs) $(DESTDIR)$(HTML_DIR) + -@INSTALL@ -m 0644 $(srcdir)/xml.html $(srcdir)/encoding.html $(srcdir)/FAQ.html $(srcdir)/structure.gif $(srcdir)/DOM.gif $(srcdir)/smallfootonly.gif $(srcdir)/redhat.gif $(srcdir)/libxml.gif $(srcdir)/w3c.png $(srcdir)/Libxml2-Logo-180x168.gif $(srcdir)/Libxml2-Logo-90x34.gif $(DESTDIR)$(HTML_DIR) + $(mkinstalldirs) $(DESTDIR)$(HTML_DIR)/html + -@INSTALL@ -m 0644 $(srcdir)/html/*.html $(DESTDIR)$(HTML_DIR)/html + -@INSTALL@ -m 0644 $(srcdir)/html/*.png $(DESTDIR)$(HTML_DIR)/html + -@INSTALL@ -m 0644 $(srcdir)/html/index.sgml $(DESTDIR)$(HTML_DIR)/html + $(mkinstalldirs) $(DESTDIR)$(HTML_DIR)/tutorial -@INSTALL@ -m 0644 $(srcdir)/tutorial/*.* \ - $(DESTDIR)$(TARGET_DIR)/tutorial - $(mkinstalldirs) $(DESTDIR)$(TARGET_DIR)/tutorial/images + $(DESTDIR)$(HTML_DIR)/tutorial + $(mkinstalldirs) $(DESTDIR)$(HTML_DIR)/tutorial/images -@INSTALL@ -m 0644 $(srcdir)/tutorial/images/*.* \ - $(DESTDIR)$(TARGET_DIR)/tutorial/images - $(mkinstalldirs) $(DESTDIR)$(TARGET_DIR)/tutorial/images/callouts + $(DESTDIR)$(HTML_DIR)/tutorial/images + $(mkinstalldirs) $(DESTDIR)$(HTML_DIR)/tutorial/images/callouts -@INSTALL@ -m 0644 $(srcdir)/tutorial/images/callouts/*.* \ - $(DESTDIR)$(TARGET_DIR)/tutorial/images/callouts + $(DESTDIR)$(HTML_DIR)/tutorial/images/callouts .PHONY : html xml templates scan diff --git a/doc/examples/.cvsignore b/doc/examples/.cvsignore index e0ef2ffd..00877b27 100644 --- a/doc/examples/.cvsignore +++ b/doc/examples/.cvsignore @@ -1,13 +1,13 @@ .memdump Makefile.in Makefile -io1 +xpath1 parse1 parse2 +tree1 +tree2 +testWriter reader1 reader2 reader3 -testWriter -tree1 -tree2 -xpath1 +io1 diff --git a/doc/examples/Makefile.am b/doc/examples/Makefile.am index fd846a8d..754e6638 100644 --- a/doc/examples/Makefile.am +++ b/doc/examples/Makefile.am @@ -1,8 +1,4 @@ # Beware this is autogenerated by index.py -HTML_DIR=$(datadir)/doc -DOC_MODULE=libxml2-$(VERSION) -TARGET_DIR=$(HTML_DIR)/$(DOC_MODULE)/examples - INCLUDES = -I$(top_builddir)/include -I$(top_srcdir)/include -I@srcdir@/include @THREAD_CFLAGS@ @Z_CFLAGS@ DEPS = $(top_builddir)/libxml2.la LDADDS = @STATIC_BINARIES@ $(top_builddir)/libxml2.la @THREAD_LIBS@ @Z_LIBS@ $(ICONV_LIBS) -lm @WIN32_EXTRA_LIBADD@ @@ -16,17 +12,17 @@ index.html: examples.xml examples.xsl -@(xsltproc examples.xsl examples.xml && echo "Rebuilt web page" && xmllint --valid --noout index.html) install-data-local: - $(mkinstalldirs) $(DESTDIR)$(TARGET_DIR) - -@INSTALL@ -m 0644 $(srcdir)/*.html $(srcdir)/*.c $(srcdir)/*.xml $(srcdir)/*.xsl $(srcdir)/*.res $(DESTDIR)$(TARGET_DIR) + $(mkinstalldirs) $(DESTDIR)$(HTML_DIR) + -@INSTALL@ -m 0644 $(srcdir)/*.html $(srcdir)/*.c $(srcdir)/*.xml $(srcdir)/*.xsl $(srcdir)/*.res $(DESTDIR)$(HTML_DIR) -EXTRA_DIST=examples.xsl index.py test1.xml test2.xml test3.xml writer.xml examples.xml io1.res reader1.res reader3.res tree1.res tree2.res +EXTRA_DIST=examples.xsl index.py test1.xml examples.xml test2.xml writer.xml test3.xml reader1.res reader3.res tree1.res tree2.res io1.res -noinst_PROGRAMS=io1 parse1 parse2 reader1 reader2 reader3 testWriter tree1 tree2 xpath1 +noinst_PROGRAMS=xpath1 parse1 parse2 tree1 tree2 testWriter reader1 reader2 reader3 io1 -io1_SOURCES=io1.c -io1_LDFLAGS= -io1_DEPENDENCIES= $(DEPS) -io1_LDADD= @RDL_LIBS@ $(LDADDS) +xpath1_SOURCES=xpath1.c +xpath1_LDFLAGS= +xpath1_DEPENDENCIES= $(DEPS) +xpath1_LDADD= @RDL_LIBS@ $(LDADDS) parse1_SOURCES=parse1.c parse1_LDFLAGS= @@ -38,6 +34,21 @@ parse2_LDFLAGS= parse2_DEPENDENCIES= $(DEPS) parse2_LDADD= @RDL_LIBS@ $(LDADDS) +tree1_SOURCES=tree1.c +tree1_LDFLAGS= +tree1_DEPENDENCIES= $(DEPS) +tree1_LDADD= @RDL_LIBS@ $(LDADDS) + +tree2_SOURCES=tree2.c +tree2_LDFLAGS= +tree2_DEPENDENCIES= $(DEPS) +tree2_LDADD= @RDL_LIBS@ $(LDADDS) + +testWriter_SOURCES=testWriter.c +testWriter_LDFLAGS= +testWriter_DEPENDENCIES= $(DEPS) +testWriter_LDADD= @RDL_LIBS@ $(LDADDS) + reader1_SOURCES=reader1.c reader1_LDFLAGS= reader1_DEPENDENCIES= $(DEPS) @@ -53,45 +64,30 @@ reader3_LDFLAGS= reader3_DEPENDENCIES= $(DEPS) reader3_LDADD= @RDL_LIBS@ $(LDADDS) -testWriter_SOURCES=testWriter.c -testWriter_LDFLAGS= -testWriter_DEPENDENCIES= $(DEPS) -testWriter_LDADD= @RDL_LIBS@ $(LDADDS) - -tree1_SOURCES=tree1.c -tree1_LDFLAGS= -tree1_DEPENDENCIES= $(DEPS) -tree1_LDADD= @RDL_LIBS@ $(LDADDS) - -tree2_SOURCES=tree2.c -tree2_LDFLAGS= -tree2_DEPENDENCIES= $(DEPS) -tree2_LDADD= @RDL_LIBS@ $(LDADDS) - -xpath1_SOURCES=xpath1.c -xpath1_LDFLAGS= -xpath1_DEPENDENCIES= $(DEPS) -xpath1_LDADD= @RDL_LIBS@ $(LDADDS) +io1_SOURCES=io1.c +io1_LDFLAGS= +io1_DEPENDENCIES= $(DEPS) +io1_LDADD= @RDL_LIBS@ $(LDADDS) tests: $(noinst_PROGRAMS) @(echo > .memdump) - @(./io1 > io1.tmp ; diff io1.tmp io1.res ; rm -f io1.tmp) - @(grep "MORY ALLO" .memdump | grep -v "MEMORY ALLOCATED : 0" ; exit 0) @(./parse1 test1.xml) @(grep "MORY ALLO" .memdump | grep -v "MEMORY ALLOCATED : 0" ; exit 0) @(./parse2 test2.xml) @(grep "MORY ALLO" .memdump | grep -v "MEMORY ALLOCATED : 0" ; exit 0) + @(./tree1 test2.xml > tree1.tmp ; diff tree1.tmp tree1.res ; rm tree1.tmp) + @(grep "MORY ALLO" .memdump | grep -v "MEMORY ALLOCATED : 0" ; exit 0) + @(./tree2 > tree2.tmp ; diff tree2.tmp tree2.res ; rm tree2.tmp) + @(grep "MORY ALLO" .memdump | grep -v "MEMORY ALLOCATED : 0" ; exit 0) + @(./testWriter ; for i in 1 2 3 4 ; do diff writer.xml writer$$i.res ; done ; rm writer*.res) + @(grep "MORY ALLO" .memdump | grep -v "MEMORY ALLOCATED : 0" ; exit 0) @(./reader1 test2.xml > reader1.tmp ; diff reader1.tmp reader1.res ; rm reader1.tmp) @(grep "MORY ALLO" .memdump | grep -v "MEMORY ALLOCATED : 0" ; exit 0) @(./reader2 test2.xml > reader1.tmp ; diff reader1.tmp reader1.res ; rm reader1.tmp) @(grep "MORY ALLO" .memdump | grep -v "MEMORY ALLOCATED : 0" ; exit 0) @(./reader3 > reader3.tmp ; diff reader3.tmp reader3.res ; rm reader3.tmp) @(grep "MORY ALLO" .memdump | grep -v "MEMORY ALLOCATED : 0" ; exit 0) - @(./testWriter ; for i in 1 2 3 4 ; do diff writer.xml writer$$i.res ; done ; rm writer*.res) - @(grep "MORY ALLO" .memdump | grep -v "MEMORY ALLOCATED : 0" ; exit 0) - @(./tree1 test2.xml > tree1.tmp ; diff tree1.tmp tree1.res ; rm tree1.tmp) - @(grep "MORY ALLO" .memdump | grep -v "MEMORY ALLOCATED : 0" ; exit 0) - @(./tree2 > tree2.tmp ; diff tree2.tmp tree2.res ; rm tree2.tmp) + @(./io1 > io1.tmp ; diff io1.tmp io1.res ; rm -f io1.tmp) @(grep "MORY ALLO" .memdump | grep -v "MEMORY ALLOCATED : 0" ; exit 0) diff --git a/doc/examples/examples.xml b/doc/examples/examples.xml index 6fdf82c8..9c14221b 100644 --- a/doc/examples/examples.xml +++ b/doc/examples/examples.xml @@ -1,28 +1,39 @@ - - Example of custom Input/Output - Demonstrate the use of xmlRegisterInputCallbacks to build a custom I/O layer, this is used in an XInclude method context to show how dynamic document can be built in a clean way. - io1 - io1 > io1.tmp ; diff io1.tmp io1.res ; rm -f io1.tmp - Daniel Veillard + + Evaluate XPath expression and prints result node set. + Shows how to evaluate XPath expression and register known namespaces in XPath context. + xpath1 <xml-file> <xpath-expr> [<known-ns-list>] + Aleksey Sanin see Copyright for the status of this software. -

InputOutput
+
XPath
+ <libxml/xpath.h> <libxml/parser.h> - <libxml/xinclude.h> + <libxml/xpathInternals.h> <libxml/tree.h> - <libxml/xmlIO.h> - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + @@ -71,138 +82,6 @@ - - Parse an XML file with an xmlReader - Demonstrate the use of xmlReaderForFile() to parse an XML file and dump the informations about the nodes found in the process. (Note that the XMLReader functions require libxml2 version later than 2.6.) - reader1 <filename> - reader1 test2.xml > reader1.tmp ; diff reader1.tmp reader1.res ; rm reader1.tmp - Daniel Veillard - see Copyright for the status of this software. -
xmlReader
- - <libxml/xmlreader.h> - - - - - - - - - - - - - - - - - - - - Parse and validate an XML file with an xmlReader - Demonstrate the use of xmlReaderForFile() to parse an XML file validating the content in the process and activating options like entities substitution, and DTD attributes defaulting. (Note that the XMLReader functions require libxml2 version later than 2.6.) - reader2 <valid_xml_filename> - reader2 test2.xml > reader1.tmp ; diff reader1.tmp reader1.res ; rm reader1.tmp - Daniel Veillard - see Copyright for the status of this software. -
xmlReader
- - <libxml/xmlreader.h> - - - - - - - - - - - - - - - - - - - - - - - - Show how to extract subdocuments with xmlReader - Demonstrate the use of xmlTextReaderPreservePattern() to parse an XML file with the xmlReader while collecting only some subparts of the document. (Note that the XMLReader functions require libxml2 version later than 2.6.) - reader3 - reader3 > reader3.tmp ; diff reader3.tmp reader3.res ; rm reader3.tmp - Daniel Veillard - see Copyright for the status of this software. -
xmlReader
- - <libxml/xmlreader.h> - - - - - - - - - - - - - - - - - - use various APIs for the xmlWriter - tests a number of APIs for the xmlWriter, especially the various methods to write to a filename, to a memory buffer, to a new document, or to a subtree. It shows how to do encoding string conversions too. The resulting documents are then serialized. - testWriter - testWriter ; for i in 1 2 3 4 ; do diff writer.xml writer$$i.res ; done ; rm writer*.res - Alfred Mickautsch - see Copyright for the status of this software. -
xmlWriter
- - <libxml/encoding.h> - <libxml/xmlwriter.h> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Navigates a tree to print element names Parse a file to a tree, use xmlDocGetRootElement() to get the root element, then walk the document and print all the element name in document order. @@ -216,10 +95,12 @@ <libxml/parser.h> - - - - + + + + + + @@ -235,65 +116,184 @@ <libxml/parser.h> - - - - - - - - - + + + + + + + + + + + + + - - Evaluate XPath expression and prints result node set. - Shows how to evaluate XPath expression and register known namespaces in XPath context. - xpath1 <xml-file> <xpath-expr> [<known-ns-list>] - Aleksey Sanin + + use various APIs for the xmlWriter + tests a number of APIs for the xmlWriter, especially the various methods to write to a filename, to a memory buffer, to a new document, or to a subtree. It shows how to do encoding string conversions too. The resulting documents are then serialized. + testWriter + testWriter ; for i in 1 2 3 4 ; do diff writer.xml writer$$i.res ; done ; rm writer*.res + Alfred Mickautsch see Copyright for the status of this software. -
XPath
+
xmlWriter
- <libxml/xpath.h> - <libxml/parser.h> - <libxml/xpathInternals.h> - <libxml/tree.h> + <libxml/encoding.h> + <libxml/xmlwriter.h> - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Parse an XML file with an xmlReader + Demonstrate the use of xmlReaderForFile() to parse an XML file and dump the informations about the nodes found in the process. (Note that the XMLReader functions require libxml2 version later than 2.6.) + reader1 <filename> + reader1 test2.xml > reader1.tmp ; diff reader1.tmp reader1.res ; rm reader1.tmp + Daniel Veillard + see Copyright for the status of this software. +
xmlReader
+ + <libxml/xmlreader.h> + + + + + + + + + + + + + + + + + + Parse and validate an XML file with an xmlReader + Demonstrate the use of xmlReaderForFile() to parse an XML file validating the content in the process and activating options like entities substitution, and DTD attributes defaulting. (Note that the XMLReader functions require libxml2 version later than 2.6.) + reader2 <valid_xml_filename> + reader2 test2.xml > reader1.tmp ; diff reader1.tmp reader1.res ; rm reader1.tmp + Daniel Veillard + see Copyright for the status of this software. +
xmlReader
+ + <libxml/xmlreader.h> + + + + + + + + + + + + + + + + + + + + + Show how to extract subdocuments with xmlReader + Demonstrate the use of xmlTextReaderPreservePattern() to parse an XML file with the xmlReader while collecting only some subparts of the document. (Note that the XMLReader functions require libxml2 version later than 2.6.) + reader3 + reader3 > reader3.tmp ; diff reader3.tmp reader3.res ; rm reader3.tmp + Daniel Veillard + see Copyright for the status of this software. +
xmlReader
+ + <libxml/xmlreader.h> + + + + + + + + + + + + + + Example of custom Input/Output + Demonstrate the use of xmlRegisterInputCallbacks to build a custom I/O layer, this is used in an XInclude method context to show how dynamic document can be built in a clean way. + io1 + io1 > io1.tmp ; diff io1.tmp io1.res ; rm -f io1.tmp + Daniel Veillard + see Copyright for the status of this software. +
InputOutput
+ + <libxml/parser.h> + <libxml/xinclude.h> + <libxml/tree.h> + <libxml/xmlIO.h> + + + + + + + - + - - - + + + - + @@ -324,12 +324,12 @@ - + - - - + + + @@ -338,38 +338,38 @@ - + - + - - + + - + - + - + - - + + @@ -389,19 +389,19 @@ - + + + - - - + @@ -431,15 +431,15 @@ - + - + diff --git a/doc/examples/index.py b/doc/examples/index.py index b1ca83aa..c3a85de3 100755 --- a/doc/examples/index.py +++ b/doc/examples/index.py @@ -221,10 +221,6 @@ def dump_Makefile(): for file in glob.glob('*.res'): extras.append(file) Makefile="""# Beware this is autogenerated by index.py -HTML_DIR=$(datadir)/doc -DOC_MODULE=libxml2-$(VERSION) -TARGET_DIR=$(HTML_DIR)/$(DOC_MODULE)/examples - INCLUDES = -I$(top_builddir)/include -I$(top_srcdir)/include -I@srcdir@/include @THREAD_CFLAGS@ @Z_CFLAGS@ DEPS = $(top_builddir)/libxml2.la LDADDS = @STATIC_BINARIES@ $(top_builddir)/libxml2.la @THREAD_LIBS@ @Z_LIBS@ $(ICONV_LIBS) -lm @WIN32_EXTRA_LIBADD@ @@ -238,8 +234,8 @@ index.html: examples.xml examples.xsl -@(xsltproc examples.xsl examples.xml && echo "Rebuilt web page" && xmllint --valid --noout index.html) install-data-local: - $(mkinstalldirs) $(DESTDIR)$(TARGET_DIR) - -@INSTALL@ -m 0644 $(srcdir)/*.html $(srcdir)/*.c $(srcdir)/*.xml $(srcdir)/*.xsl $(srcdir)/*.res $(DESTDIR)$(TARGET_DIR) + $(mkinstalldirs) $(DESTDIR)$(HTML_DIR) + -@INSTALL@ -m 0644 $(srcdir)/*.html $(srcdir)/*.c $(srcdir)/*.xml $(srcdir)/*.xsl $(srcdir)/*.res $(DESTDIR)$(HTML_DIR) """ EXTRA_DIST="" diff --git a/doc/html/book1.html b/doc/html/book1.html index 27a45486..5edc0f79 100644 --- a/doc/html/book1.html +++ b/doc/html/book1.html @@ -10,4 +10,4 @@ A:link, A:visited, A:active { text-decoration: underline } Reference Manual for libxml2
Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
Made with Libxml2 Logo

Reference Manual for libxml2

API Menu
API Indexes
Related links

Table of Contents

  • DOCBparser: old DocBook SGML parser
  • HTMLparser: interface for an HTML 4.0 non-verifying parser
  • HTMLtree: specific APIs to process HTML tree, especially serialization
  • SAX: Old SAX version 1 handler, deprecated
  • SAX2: SAX2 parser interface used to build the DOM tree
  • c14n: Provide Canonical XML and Exclusive XML Canonicalization
  • catalog: interfaces to the Catalog handling system
  • chvalid: Unicode character range checking
  • debugXML: Tree debugging APIs
  • dict: string dictionnary
  • encoding: interface for the encoding conversion functions
  • entities: interface for the XML entities handling
  • globals: interface for all global variables of the library
  • hash: chained hash tables
  • list: lists interfaces
  • nanoftp: minimal FTP implementation
  • nanohttp: minimal HTTP implementation
  • parser: the core parser module
  • parserInternals: internals routines exported by the parser.
  • pattern: pattern expression handling
  • relaxng: implementation of the Relax-NG validation
  • schemasInternals: internal interfaces for XML Schemas
  • threads: interfaces for thread handling
  • tree: interfaces for tree manipulation
  • uri: library of generic URI related routines
  • valid: The DTD validation
  • xinclude: implementation of XInclude
  • xlink: unfinished XLink detection module
  • xmlIO: interface for the I/O interfaces used by the parser
  • xmlautomata: API to build regexp automata
  • xmlerror: error handling
  • xmlexports: macros for marking symbols as exportable/importable.
  • xmlmemory: interface for the memory allocator
  • xmlreader: the XMLReader implementation
  • xmlregexp: regular expressions handling
  • xmlschemas: incomplete XML Schemas structure implementation
  • xmlschemastypes: implementation of XML Schema Datatypes
  • xmlstring: set of routines to process strings
  • xmlunicode: Unicode character APIs
  • xmlversion: compile-time version informations
  • xmlwriter: text writing API for XML
  • xpath: XML Path Language implementation
  • xpathInternals: internal interfaces for XML Path Language implementation
  • xpointer: API to handle XML Pointers

Daniel Veillard

+ Reference Manual for libxml2
Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
Made with Libxml2 Logo

Reference Manual for libxml2

API Menu
API Indexes
Related links

Table of Contents

  • DOCBparser: old DocBook SGML parser
  • HTMLparser: interface for an HTML 4.0 non-verifying parser
  • HTMLtree: specific APIs to process HTML tree, especially serialization
  • SAX: Old SAX version 1 handler, deprecated
  • SAX2: SAX2 parser interface used to build the DOM tree
  • c14n: Provide Canonical XML and Exclusive XML Canonicalization
  • catalog: interfaces to the Catalog handling system
  • chvalid: Unicode character range checking
  • debugXML: Tree debugging APIs
  • dict: string dictionnary
  • encoding: interface for the encoding conversion functions
  • entities: interface for the XML entities handling
  • globals: interface for all global variables of the library
  • hash: chained hash tables
  • list: lists interfaces
  • nanoftp: minimal FTP implementation
  • nanohttp: minimal HTTP implementation
  • parser: the core parser module
  • parserInternals: internals routines exported by the parser.
  • pattern: pattern expression handling
  • relaxng: implementation of the Relax-NG validation
  • schemasInternals: internal interfaces for XML Schemas
  • threads: interfaces for thread handling
  • tree: interfaces for tree manipulation
  • uri: library of generic URI related routines
  • valid: The DTD validation
  • xinclude: implementation of XInclude
  • xlink: unfinished XLink detection module
  • xmlIO: interface for the I/O interfaces used by the parser
  • xmlautomata: API to build regexp automata
  • xmlerror: error handling
  • xmlexports: macros for marking symbols as exportable/importable.
  • xmlmemory: interface for the memory allocator
  • xmlreader: the XMLReader implementation
  • xmlregexp: regular expressions handling
  • xmlsave: the XML document serializer
  • xmlschemas: incomplete XML Schemas structure implementation
  • xmlschemastypes: implementation of XML Schema Datatypes
  • xmlstring: set of routines to process strings
  • xmlunicode: Unicode character APIs
  • xmlversion: compile-time version informations
  • xmlwriter: text writing API for XML
  • xpath: XML Path Language implementation
  • xpathInternals: internal interfaces for XML Path Language implementation
  • xpointer: API to handle XML Pointers

Daniel Veillard

diff --git a/doc/html/index.html b/doc/html/index.html index 27a45486..5edc0f79 100644 --- a/doc/html/index.html +++ b/doc/html/index.html @@ -10,4 +10,4 @@ A:link, A:visited, A:active { text-decoration: underline } Reference Manual for libxml2
Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
Made with Libxml2 Logo

Reference Manual for libxml2

API Menu
API Indexes
Related links

Table of Contents

  • DOCBparser: old DocBook SGML parser
  • HTMLparser: interface for an HTML 4.0 non-verifying parser
  • HTMLtree: specific APIs to process HTML tree, especially serialization
  • SAX: Old SAX version 1 handler, deprecated
  • SAX2: SAX2 parser interface used to build the DOM tree
  • c14n: Provide Canonical XML and Exclusive XML Canonicalization
  • catalog: interfaces to the Catalog handling system
  • chvalid: Unicode character range checking
  • debugXML: Tree debugging APIs
  • dict: string dictionnary
  • encoding: interface for the encoding conversion functions
  • entities: interface for the XML entities handling
  • globals: interface for all global variables of the library
  • hash: chained hash tables
  • list: lists interfaces
  • nanoftp: minimal FTP implementation
  • nanohttp: minimal HTTP implementation
  • parser: the core parser module
  • parserInternals: internals routines exported by the parser.
  • pattern: pattern expression handling
  • relaxng: implementation of the Relax-NG validation
  • schemasInternals: internal interfaces for XML Schemas
  • threads: interfaces for thread handling
  • tree: interfaces for tree manipulation
  • uri: library of generic URI related routines
  • valid: The DTD validation
  • xinclude: implementation of XInclude
  • xlink: unfinished XLink detection module
  • xmlIO: interface for the I/O interfaces used by the parser
  • xmlautomata: API to build regexp automata
  • xmlerror: error handling
  • xmlexports: macros for marking symbols as exportable/importable.
  • xmlmemory: interface for the memory allocator
  • xmlreader: the XMLReader implementation
  • xmlregexp: regular expressions handling
  • xmlschemas: incomplete XML Schemas structure implementation
  • xmlschemastypes: implementation of XML Schema Datatypes
  • xmlstring: set of routines to process strings
  • xmlunicode: Unicode character APIs
  • xmlversion: compile-time version informations
  • xmlwriter: text writing API for XML
  • xpath: XML Path Language implementation
  • xpathInternals: internal interfaces for XML Path Language implementation
  • xpointer: API to handle XML Pointers

Daniel Veillard

+ Reference Manual for libxml2
Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
Made with Libxml2 Logo

Reference Manual for libxml2

API Menu
API Indexes
Related links

Table of Contents

  • DOCBparser: old DocBook SGML parser
  • HTMLparser: interface for an HTML 4.0 non-verifying parser
  • HTMLtree: specific APIs to process HTML tree, especially serialization
  • SAX: Old SAX version 1 handler, deprecated
  • SAX2: SAX2 parser interface used to build the DOM tree
  • c14n: Provide Canonical XML and Exclusive XML Canonicalization
  • catalog: interfaces to the Catalog handling system
  • chvalid: Unicode character range checking
  • debugXML: Tree debugging APIs
  • dict: string dictionnary
  • encoding: interface for the encoding conversion functions
  • entities: interface for the XML entities handling
  • globals: interface for all global variables of the library
  • hash: chained hash tables
  • list: lists interfaces
  • nanoftp: minimal FTP implementation
  • nanohttp: minimal HTTP implementation
  • parser: the core parser module
  • parserInternals: internals routines exported by the parser.
  • pattern: pattern expression handling
  • relaxng: implementation of the Relax-NG validation
  • schemasInternals: internal interfaces for XML Schemas
  • threads: interfaces for thread handling
  • tree: interfaces for tree manipulation
  • uri: library of generic URI related routines
  • valid: The DTD validation
  • xinclude: implementation of XInclude
  • xlink: unfinished XLink detection module
  • xmlIO: interface for the I/O interfaces used by the parser
  • xmlautomata: API to build regexp automata
  • xmlerror: error handling
  • xmlexports: macros for marking symbols as exportable/importable.
  • xmlmemory: interface for the memory allocator
  • xmlreader: the XMLReader implementation
  • xmlregexp: regular expressions handling
  • xmlsave: the XML document serializer
  • xmlschemas: incomplete XML Schemas structure implementation
  • xmlschemastypes: implementation of XML Schema Datatypes
  • xmlstring: set of routines to process strings
  • xmlunicode: Unicode character APIs
  • xmlversion: compile-time version informations
  • xmlwriter: text writing API for XML
  • xpath: XML Path Language implementation
  • xpathInternals: internal interfaces for XML Path Language implementation
  • xpointer: API to handle XML Pointers

Daniel Veillard

diff --git a/doc/html/libxml-lib.html b/doc/html/libxml-lib.html index 27a45486..5edc0f79 100644 --- a/doc/html/libxml-lib.html +++ b/doc/html/libxml-lib.html @@ -10,4 +10,4 @@ A:link, A:visited, A:active { text-decoration: underline } Reference Manual for libxml2
Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
Made with Libxml2 Logo

Reference Manual for libxml2

API Menu
API Indexes
Related links

Table of Contents

  • DOCBparser: old DocBook SGML parser
  • HTMLparser: interface for an HTML 4.0 non-verifying parser
  • HTMLtree: specific APIs to process HTML tree, especially serialization
  • SAX: Old SAX version 1 handler, deprecated
  • SAX2: SAX2 parser interface used to build the DOM tree
  • c14n: Provide Canonical XML and Exclusive XML Canonicalization
  • catalog: interfaces to the Catalog handling system
  • chvalid: Unicode character range checking
  • debugXML: Tree debugging APIs
  • dict: string dictionnary
  • encoding: interface for the encoding conversion functions
  • entities: interface for the XML entities handling
  • globals: interface for all global variables of the library
  • hash: chained hash tables
  • list: lists interfaces
  • nanoftp: minimal FTP implementation
  • nanohttp: minimal HTTP implementation
  • parser: the core parser module
  • parserInternals: internals routines exported by the parser.
  • pattern: pattern expression handling
  • relaxng: implementation of the Relax-NG validation
  • schemasInternals: internal interfaces for XML Schemas
  • threads: interfaces for thread handling
  • tree: interfaces for tree manipulation
  • uri: library of generic URI related routines
  • valid: The DTD validation
  • xinclude: implementation of XInclude
  • xlink: unfinished XLink detection module
  • xmlIO: interface for the I/O interfaces used by the parser
  • xmlautomata: API to build regexp automata
  • xmlerror: error handling
  • xmlexports: macros for marking symbols as exportable/importable.
  • xmlmemory: interface for the memory allocator
  • xmlreader: the XMLReader implementation
  • xmlregexp: regular expressions handling
  • xmlschemas: incomplete XML Schemas structure implementation
  • xmlschemastypes: implementation of XML Schema Datatypes
  • xmlstring: set of routines to process strings
  • xmlunicode: Unicode character APIs
  • xmlversion: compile-time version informations
  • xmlwriter: text writing API for XML
  • xpath: XML Path Language implementation
  • xpathInternals: internal interfaces for XML Path Language implementation
  • xpointer: API to handle XML Pointers

Daniel Veillard

+ Reference Manual for libxml2
Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
Made with Libxml2 Logo

Reference Manual for libxml2

API Menu
API Indexes
Related links

Table of Contents

  • DOCBparser: old DocBook SGML parser
  • HTMLparser: interface for an HTML 4.0 non-verifying parser
  • HTMLtree: specific APIs to process HTML tree, especially serialization
  • SAX: Old SAX version 1 handler, deprecated
  • SAX2: SAX2 parser interface used to build the DOM tree
  • c14n: Provide Canonical XML and Exclusive XML Canonicalization
  • catalog: interfaces to the Catalog handling system
  • chvalid: Unicode character range checking
  • debugXML: Tree debugging APIs
  • dict: string dictionnary
  • encoding: interface for the encoding conversion functions
  • entities: interface for the XML entities handling
  • globals: interface for all global variables of the library
  • hash: chained hash tables
  • list: lists interfaces
  • nanoftp: minimal FTP implementation
  • nanohttp: minimal HTTP implementation
  • parser: the core parser module
  • parserInternals: internals routines exported by the parser.
  • pattern: pattern expression handling
  • relaxng: implementation of the Relax-NG validation
  • schemasInternals: internal interfaces for XML Schemas
  • threads: interfaces for thread handling
  • tree: interfaces for tree manipulation
  • uri: library of generic URI related routines
  • valid: The DTD validation
  • xinclude: implementation of XInclude
  • xlink: unfinished XLink detection module
  • xmlIO: interface for the I/O interfaces used by the parser
  • xmlautomata: API to build regexp automata
  • xmlerror: error handling
  • xmlexports: macros for marking symbols as exportable/importable.
  • xmlmemory: interface for the memory allocator
  • xmlreader: the XMLReader implementation
  • xmlregexp: regular expressions handling
  • xmlsave: the XML document serializer
  • xmlschemas: incomplete XML Schemas structure implementation
  • xmlschemastypes: implementation of XML Schema Datatypes
  • xmlstring: set of routines to process strings
  • xmlunicode: Unicode character APIs
  • xmlversion: compile-time version informations
  • xmlwriter: text writing API for XML
  • xpath: XML Path Language implementation
  • xpathInternals: internal interfaces for XML Path Language implementation
  • xpointer: API to handle XML Pointers

Daniel Veillard

diff --git a/doc/html/libxml-xmlregexp.html b/doc/html/libxml-xmlregexp.html index 2082531c..4c371eb2 100644 --- a/doc/html/libxml-xmlregexp.html +++ b/doc/html/libxml-xmlregexp.html @@ -10,7 +10,7 @@ A:link, A:visited, A:active { text-decoration: underline } Module xmlregexp from libxml2
Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
Made with Libxml2 Logo

Module xmlregexp from libxml2

API Menu
API Indexes
Related links
PrevxmlreaderUpAPI documentationHomeThe XML C parser and toolkit of GnomexmlschemasNext

basic API for libxml regular expressions handling used for XML Schemas and validation.

Table of Contents

Structure xmlRegExecCtxt
struct _xmlRegExecCtxt
+    Module xmlregexp from libxml2
Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
Made with Libxml2 Logo
Module xmlregexp from libxml2
API Menu
API Indexes
Related links
PrevxmlreaderUpAPI documentationHomeThe XML C parser and toolkit of GnomexmlsaveNext
basic API for libxml regular expressions handling used for XML Schemas and validation. 
Table of Contents
Structure xmlRegExecCtxt
struct _xmlRegExecCtxt
 The content of this structure is not made public by the API.
 
Typedef xmlRegExecCtxt * xmlRegExecCtxtPtr
 
Structure xmlRegexp
struct _xmlRegexp
diff --git a/doc/html/libxml-xmlsave.html b/doc/html/libxml-xmlsave.html
new file mode 100644
index 00000000..9af9c195
--- /dev/null
+++ b/doc/html/libxml-xmlsave.html
@@ -0,0 +1,43 @@
+
+
+Module xmlsave from libxml2
Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
Made with Libxml2 Logo
Module xmlsave from libxml2
API Menu
API Indexes
Related links
PrevxmlregexpUpAPI documentationHomeThe XML C parser and toolkit of GnomexmlschemasNext
API to save document or subtree of document 
Table of Contents
Structure xmlSaveCtxt
struct _xmlSaveCtxt
+The content of this structure is not made public by the API.
+
Typedef xmlSaveCtxt * xmlSaveCtxtPtr
+
int	xmlSaveClose			(xmlSaveCtxtPtr ctxt)

+
long	xmlSaveDoc			(xmlSaveCtxtPtr ctxt, 
					 xmlDocPtr doc)

+
int	xmlSaveFlush			(xmlSaveCtxtPtr ctxt)

+
xmlSaveCtxtPtr	xmlSaveToBuffer		(xmlBufferPtr buffer, 
					 const char * encoding, 
					 int options)

+
xmlSaveCtxtPtr	xmlSaveToFd		(int fd, 
					 const char * encoding, 
					 int options)

+
xmlSaveCtxtPtr	xmlSaveToFilename	(const char * filename, 
					 const char * encoding, 
					 int options)

+
xmlSaveCtxtPtr	xmlSaveToIO		(xmlOutputWriteCallback iowrite, 
					 xmlOutputCloseCallback ioclose, 
					 void * ioctx, 
					 const char * encoding, 
					 int options)

+
long	xmlSaveTree			(xmlSaveCtxtPtr ctxt, 
					 xmlNodePtr node)

+
Description

+
Structure xmlSaveCtxt
Structure xmlSaveCtxt
struct _xmlSaveCtxt {
+The content of this structure is not made public by the API.
+}
Function: xmlSaveClose
int	xmlSaveClose			(xmlSaveCtxtPtr ctxt)

+
Close a document saving context, i.e. make sure that all bytes have been output and free the associated data.

+
ctxt:a document saving context
Returns:the number of byte written or -1 in case of error.
Function: xmlSaveDoc
long	xmlSaveDoc			(xmlSaveCtxtPtr ctxt, 
					 xmlDocPtr doc)

+
Save a full document to a saving context

+
ctxt:a document saving context
doc:a document
Returns:the number of byte written or -1 in case of error
Function: xmlSaveFlush
int	xmlSaveFlush			(xmlSaveCtxtPtr ctxt)

+
Flush a document saving context, i.e. make sure that all bytes have been output.

+
ctxt:a document saving context
Returns:the number of byte written or -1 in case of error.
Function: xmlSaveToBuffer
xmlSaveCtxtPtr	xmlSaveToBuffer		(xmlBufferPtr buffer, 
					 const char * encoding, 
					 int options)

+
Create a document saving context serializing to a buffer with the encoding and the options given

+
buffer:a buffer
encoding:the encoding name to use or NULL
options:a set of xmlSaveOptions
Returns:a new serialization context or NULL in case of error.
Function: xmlSaveToFd
xmlSaveCtxtPtr	xmlSaveToFd		(int fd, 
					 const char * encoding, 
					 int options)

+
Create a document saving context serializing to a file descriptor with the encoding and the options given.

+
fd:a file descriptor number
encoding:the encoding name to use or NULL
options:a set of xmlSaveOptions
Returns:a new serialization context or NULL in case of error.
Function: xmlSaveToFilename
xmlSaveCtxtPtr	xmlSaveToFilename	(const char * filename, 
					 const char * encoding, 
					 int options)

+
Create a document saving context serializing to a filename or possibly to an URL (but this is less reliable) with the encoding and the options given.

+
filename:a file name or an URL
encoding:the encoding name to use or NULL
options:a set of xmlSaveOptions
Returns:a new serialization context or NULL in case of error.
Function: xmlSaveToIO
xmlSaveCtxtPtr	xmlSaveToIO		(xmlOutputWriteCallback iowrite, 
					 xmlOutputCloseCallback ioclose, 
					 void * ioctx, 
					 const char * encoding, 
					 int options)

+
Create a document saving context serializing to a file descriptor with the encoding and the options given

+
iowrite:an I/O write function
ioclose:an I/O close function
ioctx:an I/O handler
encoding:the encoding name to use or NULL
options:a set of xmlSaveOptions
Returns:a new serialization context or NULL in case of error.
Function: xmlSaveTree
long	xmlSaveTree			(xmlSaveCtxtPtr ctxt, 
					 xmlNodePtr node)

+
Save a subtree starting at the node parameter to a saving context

+
ctxt:a document saving context
node:a document
Returns:the number of byte written or -1 in case of error
Daniel Veillard

diff --git a/doc/html/libxml-xmlschemas.html b/doc/html/libxml-xmlschemas.html
index 4c298be5..68584f10 100644
--- a/doc/html/libxml-xmlschemas.html
+++ b/doc/html/libxml-xmlschemas.html
@@ -10,7 +10,7 @@ A:link, A:visited, A:active { text-decoration: underline }
 Module xmlschemas from libxml2
Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
Made with Libxml2 Logo
Module xmlschemas from libxml2
API Menu
API Indexes
Related links
PrevxmlregexpUpAPI documentationHomeThe XML C parser and toolkit of GnomexmlschemastypesNext
interface to the XML Schemas handling and schema validity checking, it is incomplete right now. 
Table of Contents
Structure xmlSchema
struct _xmlSchema
+    Module xmlschemas from libxml2
Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
Made with Libxml2 Logo
Module xmlschemas from libxml2
API Menu
API Indexes
Related links
PrevxmlsaveUpAPI documentationHomeThe XML C parser and toolkit of GnomexmlschemastypesNext
interface to the XML Schemas handling and schema validity checking, it is incomplete right now. 
Table of Contents
Structure xmlSchema
struct _xmlSchema
 
Structure xmlSchemaParserCtxt
struct _xmlSchemaParserCtxt
 The content of this structure is not made public by the API.
 
Typedef xmlSchemaParserCtxt * xmlSchemaParserCtxtPtr
diff --git a/doc/libxml2-api.xml b/doc/libxml2-api.xml
index e6108a65..1162e1a4 100644
--- a/doc/libxml2-api.xml
+++ b/doc/libxml2-api.xml
@@ -2372,6 +2372,21 @@
      
      
     
+    
+     the XML document serializer
+     API to save document or subtree of document 
+     Daniel Veillard 
+     
+     
+     
+     
+     
+     
+     
+     
+     
+     
+    
     
      incomplete XML Schemas structure implementation
      interface to the XML Schemas handling and schema validity checking, it is incomplete right now. 
@@ -5096,6 +5111,8 @@ actually an xmlCharEncoding'/>
       
     
     
+    
+    
     
       
       
@@ -10920,6 +10937,17 @@ actually an xmlCharEncoding'/>
       
       
     
+    
+      Close a document saving context, i.e. make sure that all bytes have been output and free the associated data.
+      
+      
+    
+    
+      Save a full document to a saving context
+      
+      
+      
+    
     
       Dump an XML document to a file. Will use compression if compiled in and enabled. If @filename is "-" the stdout file is used.
       
@@ -10940,6 +10968,11 @@ actually an xmlCharEncoding'/>
       
       
     
+    
+      Flush a document saving context, i.e. make sure that all bytes have been output.
+      
+      
+    
     
       Dump an XML document to a file. Will use compression if compiled in and enabled. If @filename is "-" the stdout file is used. If @format is set then the document will be indented on output. Note that @format = 1 provide node indenting only if xmlIndentTreeOutput = 1 or xmlKeepBlanksDefault(0) was called
       
@@ -10963,6 +10996,42 @@ actually an xmlCharEncoding'/>
       
       
     
+    
+      Create a document saving context serializing to a buffer with the encoding and the options given
+      
+      
+      
+      
+    
+    
+      Create a document saving context serializing to a file descriptor with the encoding and the options given.
+      
+      
+      
+      
+    
+    
+      Create a document saving context serializing to a filename or possibly to an URL (but this is less reliable) with the encoding and the options given.
+      
+      
+      
+      
+    
+    
+      Create a document saving context serializing to a file descriptor with the encoding and the options given
+      
+      
+      
+      
+      
+      
+    
+    
+      Save a subtree starting at the node parameter to a saving context
+      
+      
+      
+    
     
       Save the URI as an escaped string
       
diff --git a/doc/libxml2-refs.xml b/doc/libxml2-refs.xml
index 007642c7..0bdf8a4f 100644
--- a/doc/libxml2-refs.xml
+++ b/doc/libxml2-refs.xml
@@ -2100,13 +2100,23 @@
     
     
     
+    
+    
+    
+    
     
     
     
+    
     
     
     
     
+    
+    
+    
+    
+    
     
     
     
@@ -5004,13 +5014,23 @@
       
       
       
+      
+      
+      
+      
       
       
       
+      
       
       
       
       
+      
+      
+      
+      
+      
       
       
       
@@ -5844,6 +5864,8 @@
     
       
       
+      
+      
       
     
     
@@ -6326,6 +6348,12 @@
     
       
     
+    
+      
+      
+      
+      
+    
     
       
     
@@ -7297,6 +7325,7 @@
       
       
       
+      
       
       
       
@@ -7433,6 +7462,7 @@
       
       
       
+      
     
     
       
@@ -7650,6 +7680,7 @@
       
       
       
+      
       
       
       
@@ -8004,6 +8035,7 @@
       
       
       
+      
       
       
       
@@ -8165,6 +8197,7 @@
     
       
       
+      
     
     
       
@@ -8175,6 +8208,7 @@
     
       
       
+      
     
     
       
@@ -8426,6 +8460,12 @@
       
       
     
+    
+      
+      
+      
+      
+    
     
       
       
@@ -11092,6 +11132,18 @@
       
       
     
+    
+      
+      
+      
+      
+      
+      
+      
+      
+      
+      
+    
     
       
       
@@ -12387,6 +12439,7 @@
           
           
           
+          
         
         
           
@@ -13170,6 +13223,7 @@
           
         
         
+          
           
         
         
@@ -14817,6 +14871,8 @@
         
         
           
+          
+          
           
         
         
@@ -16758,6 +16814,7 @@
           
           
           
+          
           
           
           
@@ -17183,6 +17240,7 @@
           
           
           
+          
           
         
         
@@ -18199,6 +18257,8 @@
           
           
           
+          
+          
         
         
           
@@ -19523,6 +19583,7 @@
           
           
           
+          
           
           
           
@@ -19855,6 +19916,8 @@
           
           
           
+          
+          
           
           
           
@@ -20850,6 +20913,7 @@
           
         
         
+          
           
           
           
@@ -21168,6 +21232,8 @@
         
         
           
+          
+          
         
         
           
@@ -22157,6 +22223,10 @@
         
           
           
+          
+          
+          
+          
         
         
           
@@ -22565,6 +22635,7 @@
           
           
           
+          
           
         
         
@@ -23420,6 +23491,9 @@
         
           
         
+        
+          
+        
         
           
         
@@ -23854,6 +23928,14 @@
           
           
           
+          
+          
+          
+          
+          
+          
+          
+          
         
         
           
@@ -24014,11 +24096,21 @@
         
         
           
+          
+          
+          
+          
           
           
           
           
         
+        
+          
+          
+          
+          
+        
         
           
           
@@ -24463,6 +24555,7 @@
           
           
           
+          
           
           
           
@@ -24796,6 +24889,7 @@
           
           
           
+          
           
           
           
@@ -24889,6 +24983,8 @@
           
         
         
+          
+          
           
           
         
@@ -25997,6 +26093,7 @@
           
           
           
+          
           
         
         
@@ -26733,6 +26830,12 @@
         
           
         
+        
+          
+          
+          
+          
+        
         
           
           
diff --git a/include/libxml/Makefile.am b/include/libxml/Makefile.am
index c2f0a53d..70bf5f32 100644
--- a/include/libxml/Makefile.am
+++ b/include/libxml/Makefile.am
@@ -46,7 +46,8 @@ xmlinc_HEADERS = \
 		xmlexports.h \
 		xmlwriter.h \
 		chvalid.h \
-		pattern.h
+		pattern.h \
+		xmlsave.h
 
 install-exec-hook:
 	$(mkinstalldirs) $(DESTDIR)$(xmlincdir)