From edfb29b8afda78c0abbd1c8ff2adf1f3ca4949f8 Mon Sep 17 00:00:00 2001 From: Daniel Veillard Date: Tue, 14 Mar 2000 19:59:05 +0000 Subject: [PATCH] Updated the docs, and configuratio/spec stuff to release is at libxml2 , daniel. --- ChangeLog | 5 + configure.in | 4 +- doc/html/gnome-xml-debugxml.html | 38 +- doc/html/gnome-xml-encoding.html | 164 ++++- doc/html/gnome-xml-entities.html | 519 ++++++++----- doc/html/gnome-xml-htmlparser.html | 62 +- doc/html/gnome-xml-htmltree.html | 24 +- doc/html/gnome-xml-nanoftp.html | 54 +- doc/html/gnome-xml-nanohttp.html | 28 +- doc/html/gnome-xml-parser.html | 812 ++++++++++++++++++--- doc/html/gnome-xml-parserinternals.html | 925 ++++++++++++++++-------- doc/html/gnome-xml-sax.html | 82 +-- doc/html/gnome-xml-tree.html | 758 ++++++++++++++----- doc/html/gnome-xml-valid.html | 870 ++++++++++++++++++++-- doc/html/gnome-xml-xml-error.html | 38 +- doc/html/gnome-xml-xmlio.html | 33 +- doc/html/gnome-xml-xmlmemory.html | 40 +- doc/html/gnome-xml-xpath.html | 76 +- doc/html/index.sgml | 31 +- doc/xml.html | 38 +- libxml.spec.in | 17 +- 21 files changed, 3474 insertions(+), 1144 deletions(-) diff --git a/ChangeLog b/ChangeLog index 6a9f277e..34197850 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,8 @@ +Tue Mar 14 20:52:35 CET 2000 Daniel Veillard + + * configure.in, libxml.spec.in : libxml2 + * doc/* : updated the doc page, rebuilt the docs + Tue Mar 14 19:11:29 CET 2000 Daniel Veillard * all: tagged LIB_XML_1_X diff --git a/configure.in b/configure.in index 55d67a9d..01e8dfd7 100644 --- a/configure.in +++ b/configure.in @@ -15,9 +15,9 @@ AC_SUBST(LIBXML_MICRO_VERSION) AC_SUBST(LIBXML_VERSION) AC_SUBST(LIBXML_VERSION_INFO) -VERSION=$LIBXML_VERSION-beta +VERSION=${LIBXML_VERSION}beta -AM_INIT_AUTOMAKE(libxml, $VERSION) +AM_INIT_AUTOMAKE(libxml2, $VERSION) AC_ARG_WITH(html-dir, [ --with-html-dir=PATH path to installed docs ]) diff --git a/doc/html/gnome-xml-debugxml.html b/doc/html/gnome-xml-debugxml.html index 97694588..addee22a 100644 --- a/doc/html/gnome-xml-debugxml.html +++ b/doc/html/gnome-xml-debugxml.html @@ -115,7 +115,7 @@ SIZE="3" >

Name

Synopsis

Description

Details

Name

Synopsis

) (unsigned char *out, int outlen, unsigned char *in, - int inlen); + int *inlen); int (*xmlCharEncodingOutputFunc) (unsigned char *out, int outlen, unsigned char *in, - int inlen); + int *inlen); struct xmlCharEncodingHandler xmlDetectCharEncoding (unsigned char *in); +> (unsigned char *in, + int len); xmlCharEncodingxmlFindCharEncodingHandler - (const char *name);xmlCheckUTF8 (unsigned char *utf);

Description

Details

int (*xmlCharEncodingInputFunc) (unsigned char *out, int outlen, unsigned char *in, - int inlen);

int (*xmlCharEncodingOutputFunc) (unsigned char *out, int outlen, unsigned char *in, - int inlen);

xmlCharEncoding xmlDetectCharEncoding (unsigned char *in); xmlDetectCharEncoding (unsigned char *in, + int len);len : pointer to the length of the bufferReturns

xmlCheckUTF8 ()

int         xmlCheckUTF8                    (unsigned char *utf);

Checks utf for being valid utf-8. utf is assumed to be +null-terminated. This function is not super-strict, as it will +allow longer utf-8 sequences than necessary. Note that Java is +capable of producing these sequences if provoked. Also note, this +routine checks for the 4-byte maxiumum size, but does not check for +0x10ffff maximum value.

utf : Pointer to putative utf-8 encoded string.
Returns : true if utf is valid.

Name

Synopsis

-#define XML_INTERNAL_GENERAL_ENTITY -#define XML_EXTERNAL_GENERAL_PARSED_ENTITY -#define XML_EXTERNAL_GENERAL_UNPARSED_ENTITY -#define XML_INTERNAL_PARAMETER_ENTITY -#define XML_EXTERNAL_PARAMETER_ENTITY -#define XML_INTERNAL_PREDEFINED_ENTITY +enum xmlEntityType; struct xmlEntityxmlEntitiesTablePtr; -void xmlEntityPtr xmlAddDocEntity ( (xmlDocPtr doc, @@ -206,10 +189,13 @@ HREF="gnome-xml-tree.html#XMLCHAR" HREF="gnome-xml-tree.html#XMLCHAR" >xmlChar *content); -void xmlEntityPtr xmlAddDtdEntity ( (xmlDocPtr doc, @@ -346,9 +332,31 @@ HREF="gnome-xml-entities.html#XMLENTITIESTABLEPTR" >xmlEntitiesTablePtr table); void xmlDumpEntityDecl (xmlBufferPtr buf, + xmlEntityPtr ent); +void xmlCleanupPredefinedEntities (void); (void); +int xmlEntityAddReference (xmlEntityPtr ent, + const xmlChar *to);

Description

Details

XML_INTERNAL_GENERAL_ENTITY

enum xmlEntityType

#define XML_INTERNAL_GENERAL_ENTITY		1
typedef enum { + XML_INTERNAL_GENERAL_ENTITY = 1, + XML_EXTERNAL_GENERAL_PARSED_ENTITY = 2, + XML_EXTERNAL_GENERAL_UNPARSED_ENTITY = 3, + XML_INTERNAL_PARAMETER_ENTITY = 4, + XML_EXTERNAL_PARAMETER_ENTITY = 5, + XML_INTERNAL_PREDEFINED_ENTITY = 6 +} xmlEntityType;

XML_EXTERNAL_GENERAL_PARSED_ENTITY

#define XML_EXTERNAL_GENERAL_PARSED_ENTITY	2

XML_EXTERNAL_GENERAL_UNPARSED_ENTITY

#define XML_EXTERNAL_GENERAL_UNPARSED_ENTITY	3

XML_INTERNAL_PARAMETER_ENTITY

#define XML_INTERNAL_PARAMETER_ENTITY		4

XML_EXTERNAL_PARAMETER_ENTITY

#define XML_EXTERNAL_PARAMETER_ENTITY		5

XML_INTERNAL_PREDEFINED_ENTITY

#define XML_INTERNAL_PREDEFINED_ENTITY		6

struct xmlEntity {
-    int type;			/* The entity type */
-    int len;			/* The lenght of the name */
-    const xmlChar  *name;	/* Name of the entity */
-    const xmlChar  *ExternalID;	/* External identifier for PUBLIC Entity */
-    const xmlChar  *SystemID;	/* URI for a SYSTEM or PUBLIC Entity */
-    xmlChar *content;		/* The entity content or ndata if unparsed */
-    int length;			/* the content length */
-    xmlChar *orig;		/* The entity cont without ref substitution */
+#ifndef XML_WITHOUT_CORBA
+    void           *_private;	        /* for Corba, must be first ! */
+#endif
+    xmlElementType          type;       /* XML_ENTITY_DECL, must be second ! */
+    const xmlChar          *name;	/* Attribute name */
+    struct _xmlNode    *children;	/* NULL */
+    struct _xmlNode        *last;	/* NULL */
+    struct _xmlDtd       *parent;	/* -> DTD */
+    struct _xmlNode        *next;	/* next sibling link  */
+    struct _xmlNode        *prev;	/* previous sibling link  */
+    struct _xmlDoc          *doc;       /* the containing document */
+
+    xmlChar                *orig;	/* content without ref substitution */
+    xmlChar             *content;	/* content or ndata if unparsed */
+    int                   length;	/* the content length */
+    xmlEntityType          etype;	/* The entity type */
+    const xmlChar    *ExternalID;	/* External identifier for PUBLIC */
+    const xmlChar      *SystemID;	/* URI for a SYSTEM or PUBLIC Entity */
+
+#ifdef WITH_EXTRA_ENT_DETECT
+    /* Referenced entities name stack */
+    xmlChar           *ent;             /* Current parsed Node */
+    int                entNr;           /* Depth of the parsing stack */
+    int                entMax;          /* Max depth of the parsing stack */
+    xmlChar *         *entTab;          /* array of nodes */
+#endif
 };

struct xmlEntitiesTable { int nb_entities; /* number of elements stored */ int max_entities; /* maximum number of elements */ - xmlEntityPtr table; /* the table of entities */ + xmlEntityPtr *table; /* the table of entities */ };

void        xmlAddDocEntity                 (xmlEntityPtr xmlAddDocEntity                (xmlDocPtr doc,
@@ -829,6 +735,21 @@ ALIGN="LEFT"
 VALIGN="TOP"
 >  the entity contentReturns :a pointer to the entity or NULL in case of error
void        xmlAddDtdEntity                 (xmlEntityPtr xmlAddDtdEntity                (xmlDocPtr doc,
@@ -878,7 +802,7 @@ HREF="gnome-xml-tree.html#XMLCHAR"
 >
Register a new entity for this document DTD.
Register a new entity for this document DTD external subset.
  the entity contentReturns :a pointer to the entity or NULL in case of error
xmlDumpEntityDecl ()
void        xmlDumpEntityDecl               (xmlBufferPtr buf,
+                                             xmlEntityPtr ent);
This will dump the content of the entity table as an XML DTD definition
buf :  An XML buffer.
ent :  An entity table
xmlEntityAddReference ()
int         xmlEntityAddReference           (xmlEntityPtr ent,
+                                             const xmlChar *to);
Function to register reuse of an existing entity from a (new) one
+Used to keep track of references and detect cycles (well formedness 
+errors !).
ent :  an existing entity
to :  the entity name it's referencing
Returns : 0 if Okay, -1 in case of general error, 1 in case of loop 
+detection.
Name
Synopsis
Description
Details
Name
Synopsis
Description
Details
Name
Synopsis
Description
Details
Name
Synopsis
Description
Details
xmlChar *SystemID);
+void        (*externalSubsetSAXFunc)        (void *ctx,
+                                             const xmlChar *name,
+                                             const xmlChar *ExternalID,
+                                             const xmlChar *SystemID);
 xmlEntityPtrxmlSubstituteEntitiesDefaultValue;
+extern      int xmlGetWarningsDefaultValue;
 void        xmlCleanupParserxmlChar *SystemID);
+int         xmlParseBalancedChunkMemory     (xmlDocPtr doc,
+                                             xmlSAXHandlerPtr sax,
+                                             void *user_data,
+                                             int depth,
+                                             const xmlChar *string,
+                                             xmlNodePtr *list);
+int         xmlParseExternalEntity          (xmlDocPtr doc,
+                                             xmlSAXHandlerPtr sax,
+                                             void *user_data,
+                                             int depth,
+                                             const xmlChar *URL,
+                                             const xmlChar *ID,
+                                             xmlNodePtr *list);
 void        xmlDefaultSAXHandlerInit
Description
Details
externalSubsetSAXFunc ()
void        (*externalSubsetSAXFunc)        (void *ctx,
+                                             const xmlChar *name,
+                                             const xmlChar *ExternalID,
+                                             const xmlChar *SystemID);
ctx : 
name : 
ExternalID : 
SystemID : 
xmlGetWarningsDefaultValue
extern int xmlGetWarningsDefaultValue;
a strdup for array of xmlChar's
a strdup for array of xmlChar's. Since they are supposed to be
+encoded in UTF-8 or an encoding with 8bit based chars, we assume
+a termination mark of '0'.
a strcat for array of xmlChar's
a strcat for array of xmlChar's. Since they are supposed to be
+encoded in UTF-8 or an encoding with 8bit based chars, we assume
+a termination mark of '0'.
xmlParseBalancedChunkMemory ()
int         xmlParseBalancedChunkMemory     (xmlDocPtr doc,
+                                             xmlSAXHandlerPtr sax,
+                                             void *user_data,
+                                             int depth,
+                                             const xmlChar *string,
+                                             xmlNodePtr *list);
doc : 
sax : 
user_data : 
depth : 
string : 
list : 
Returns : 
xmlParseExternalEntity ()
int         xmlParseExternalEntity          (xmlDocPtr doc,
+                                             xmlSAXHandlerPtr sax,
+                                             void *user_data,
+                                             int depth,
+                                             const xmlChar *URL,
+                                             const xmlChar *ID,
+                                             xmlNodePtr *list);
Parse an external general entity
+An external general parsed entity is well-formed if it matches the
+production labeled extParsedEnt.
[78] extParsedEnt ::= TextDecl? content
doc :  the document the chunk pertains to
sax :  the SAX handler bloc (possibly NULL)
user_data :  The user data returned on SAX callbacks (possibly NULL)
depth :  Used for loop detection, use 0
URL :  the URL for the entity to load
ID :  the System ID for the entity to load
list :  the return value for the set of parsed nodes
Returns :0 if the entity is well formed, -1 in case of args problem and
+the parser error code otherwise
Name
Synopsis
XML_MAX_NAMELEN
-typedef     CHARVAL;
-#define     NEXTCHARVAL                     (p)
-#define     SKIPCHARVAL                     (p)
 #define     IS_CHARxmlCreateMemoryParserCtxt  (char *buffer,
                                              int size);
-void        xmlFreeParserCtxt               (xmlParserCtxtPtr ctxt);
 xmlParserCtxtPtrxmlNewParserCtxt           (void);
+xmlParserCtxtPtr xmlCreateEntityParserCtxt  (const xmlChar *URL,
+                                             const xmlChar *ID,
+                                             const xmlChar *base);
 void        xmlSwitchEncodingxmlCharEncoding enc);
 void        xmlFreeParserCtxt               (xmlParserCtxtPtr ctxt);
+void        xmlHandleEntity                 (*    xmlSplitQName                   (const                    (xmlParserCtxtPtr ctxt,
+                                             const xmlChar *name,
@@ -772,6 +782,13 @@ HREF="gnome-xml-parser.html#XMLPARSERCTXTPTR"
 >xmlParserCtxtPtr ctxt);
 void        xmlParseTextDecl                (xmlParserCtxtPtr ctxt);
+void        xmlParseMisc                    (xmlChar end3);
+xmlChar*    xmlStringDecodeEntities         (xmlParserCtxtPtr ctxt,
+                                             const xmlChar *str,
+                                             int what,
+                                             xmlChar end,
+                                             xmlChar end2,
+                                             xmlChar end3);
 int         nodePush
Description
Details
CHARVAL
NEXTCHARVAL()
#define     NEXTCHARVAL(p)
p : 
SKIPCHARVAL()
#define SKIPCHARVAL(p) (p)++;
p : 
  an pointer to a zero terminated char array  a pointer to a zero terminated char array
xmlFreeParserCtxt ()
void        xmlFreeParserCtxt               (xmlParserCtxtPtr ctxt);
Free all the memory used by a parser context. However the parsed
-document in ctxt->myDoc is not freed.
ctxt : 
xmlCreateEntityParserCtxt ()
xmlParserCtxtPtr xmlCreateEntityParserCtxt  (const xmlChar *URL,
+                                             const xmlChar *ID,
+                                             const xmlChar *base);
Create a parser context for an external entity
+Automatic support for ZLIB/Compress compressed document is provided
+by default if found at compile-time.
URL :  the entity URL
ID :  the entity PUBLIC ID
base :  a posible base for the target URI
Returns :the new parser context or NULL
xmlFreeParserCtxt ()
void        xmlFreeParserCtxt               (xmlParserCtxtPtr ctxt);
Free all the memory used by a parser context. However the parsed
+document in ctxt->myDoc is not freed.
ctxt : 
xmlChar*    xmlSplitQName                   (const *    xmlSplitQName                   (xmlParserCtxtPtr ctxt,
+                                             const xmlChar *name,
@@ -2794,6 +2838,23 @@ VALIGN="TOP"
 >ctxt :  an XML parser contextname :
parse a CharData section.
 if we are within a CDATA section ']]>' marks an end of section.
The right angle bracket (>) may be represented using the string ">",
+and must, for compatibility, be escaped using ">" or a character
+reference when it appears in the string "]]>" in content, when that
+string is not marking the end of a CDATA section. 
[14] CharData ::= [^<&]* - ([^<&]* ']]>' [^<&]*)
xmlParseTextDecl ()
void        xmlParseTextDecl                (xmlParserCtxtPtr ctxt);
parse an XML declaration header for external entities
[77] TextDecl ::= '<?xml' VersionInfo? EncodingDecl S? '?>'
Question: Seems that EncodingDecl is mandatory ? Is that a typo ?
ctxt :  an XML parser context
xmlStringDecodeEntities ()
xmlChar*    xmlStringDecodeEntities         (xmlParserCtxtPtr ctxt,
+                                             const xmlChar *str,
+                                             int what,
+                                             xmlChar end,
+                                             xmlChar end2,
+                                             xmlChar end3);
[67] Reference ::= EntityRef | CharRef
[69] PEReference ::= '%' Name ';'
ctxt :  the parser context
str :  the input string
what :  combination of XML_SUBSTITUTE_REF and XML_SUBSTITUTE_PEREF
end :  an end marker xmlChar, 0 if none
end2 :  an end marker xmlChar, 0 if none
end3 :  an end marker xmlChar, 0 if none
Returns :A newly allocated string with the substitution done. The caller
+must deallocate it !
Name
Synopsis
Description
Details
  the attribute name  
Name
Synopsis
xmlNodePtr  xmlNewCharRef                   (xmlDocPtr doc,
+                                             const xmlChar *name);
+xmlNodePtr  xmlNewReference                 (xmlChar *lang);
+int         xmlNodeGetSpacePreserve         (xmlNodePtr cur);
 xmlCharxmlChar *string);
+int         xmlReconciliateNs               (xmlDocPtr doc,
+                                             xmlNodePtr tree);
 void        xmlDocDumpMemory
Description
Details
xmlChar
typedef unsigned char xmlChar;
struct xmlAttribute {
-    const xmlChar         *elem;	/* Element holding the attribute */
-    const xmlChar         *name;	/* Attribute name */
-    struct _xmlAttribute   *next;       /* list of attributes of an element */
-    xmlAttributeType       type;	/* The type */
-    xmlAttributeDefault    def;		/* the default */
-    const xmlChar         *defaultValue;/* or the default value */
-    xmlEnumerationPtr      tree;        /* or the enumeration tree if any */
-    const xmlChar         *prefix;      /* the namespace prefix if any */
+#ifndef XML_WITHOUT_CORBA
+    void           *_private;	        /* for Corba, must be first ! */
+#endif
+    xmlElementType          type;       /* XML_ATTRIBUTE_DECL, must be second ! */
+    const xmlChar          *name;	/* Attribute name */
+    struct _xmlNode    *children;	/* NULL */
+    struct _xmlNode        *last;	/* NULL */
+    struct _xmlDtd       *parent;	/* -> DTD */
+    struct _xmlNode        *next;	/* next sibling link  */
+    struct _xmlNode        *prev;	/* previous sibling link  */
+    struct _xmlDoc          *doc;       /* the containing document */
+
+    struct _xmlAttribute  *nexth;	/* next in hash table */
+    xmlAttributeType       atype;	/* The attribute type */
+    xmlAttributeDefault      def;	/* the default */
+    const xmlChar  *defaultValue;	/* or the default value */
+    xmlEnumerationPtr       tree;       /* or the enumeration tree if any */
+    const xmlChar        *prefix;	/* the namespace prefix if any */
+    const xmlChar          *elem;	/* Element holding the attribute */
 };
struct xmlElement {
+#ifndef XML_WITHOUT_CORBA
+    void           *_private;	        /* for Corba, must be first ! */
+#endif
+    xmlElementType          type;       /* XML_ELEMENT_DECL, must be second ! */
     const xmlChar          *name;	/* Element name */
-    xmlElementTypeVal       type;	/* The type */
+    struct _xmlNode    *children;	/* NULL */
+    struct _xmlNode        *last;	/* NULL */
+    struct _xmlDtd       *parent;	/* -> DTD */
+    struct _xmlNode        *next;	/* next sibling link  */
+    struct _xmlNode        *prev;	/* previous sibling link  */
+    struct _xmlDoc          *doc;       /* the containing document */
+
+    xmlElementTypeVal      etype;	/* The type */
     xmlElementContentPtr content;	/* the allowed element content */
     xmlAttributePtr   attributes;	/* List of the declared attributes */
 };
struct xmlDtd {
+#ifndef XML_WITHOUT_CORBA
+    void           *_private;	/* for Corba, must be first ! */
+#endif
+    xmlElementType  type;       /* XML_DTD_NODE, must be second ! */
     const xmlChar *name;	/* Name of the DTD */
-    const xmlChar *ExternalID;	/* External identifier for PUBLIC DTD */
-    const xmlChar *SystemID;	/* URI for a SYSTEM or PUBLIC DTD */
+    struct _xmlNode *children;	/* the value of the property link */
+    struct _xmlNode *last;	/* last child link */
+    struct _xmlDoc  *parent;	/* child->parent link */
+    struct _xmlNode *next;	/* next sibling link  */
+    struct _xmlNode *prev;	/* previous sibling link  */
+    struct _xmlDoc  *doc;	/* the containing document */
+
+    /* End of common part */
     void          *notations;   /* Hash table for notations if any */
     void          *elements;    /* Hash table for elements if any */
     void          *attributes;  /* Hash table for attributes if any */
     void          *entities;    /* Hash table for entities if any */
-    /* struct xmlDtd *next;	 * next  link for this document  */
+    const xmlChar *ExternalID;	/* External identifier for PUBLIC DTD */
+    const xmlChar *SystemID;	/* URI for a SYSTEM or PUBLIC DTD */
 };
struct xmlAttr {
 #ifndef XML_WITHOUT_CORBA
     void           *_private;	/* for Corba, must be first ! */
-    void           *vepv;	/* for Corba, must be next ! */
 #endif
-    xmlElementType  type;       /* XML_ATTRIBUTE_NODE, must be third ! */
-    struct _xmlNode *node;	/* attr->node link */
-    struct _xmlAttr *next;	/* attribute list link */
+    xmlElementType   type;      /* XML_ATTRIBUTE_NODE, must be second ! */
     const xmlChar   *name;      /* the name of the property */
-    struct _xmlNode *val;       /* the value of the property */
+    struct _xmlNode *children;	/* the value of the property */
+    struct _xmlNode *last;	/* NULL */
+    struct _xmlNode *parent;	/* child->parent link */
+    struct _xmlAttr *next;	/* next sibling link  */
+    struct _xmlAttr *prev;	/* previous sibling link  */
+    struct _xmlDoc  *doc;	/* the containing document */
     xmlNs           *ns;        /* pointer to the associated namespace */
+    xmlAttributeType atype;     /* the attribute type if validating */
 };

struct xmlNode { #ifndef XML_WITHOUT_CORBA void *_private; /* for Corba, must be first ! */ - void *vepv; /* for Corba, must be next ! */ #endif - xmlElementType type; /* type number in the DTD, must be third ! */ - struct _xmlDoc *doc; /* the containing document */ + xmlElementType type; /* type number, must be second ! */ + const xmlChar *name; /* the name of the node, or the entity */ + struct _xmlNode *children; /* parent->childs link */ + struct _xmlNode *last; /* last child link */ struct _xmlNode *parent; /* child->parent link */ struct _xmlNode *next; /* next sibling link */ struct _xmlNode *prev; /* previous sibling link */ - struct _xmlNode *childs; /* parent->childs link */ - struct _xmlNode *last; /* last child link */ - struct _xmlAttr *properties;/* properties list */ - const xmlChar *name; /* the name of the node, or the entity */ - xmlNs *ns; /* pointer to the associated namespace */ - xmlNs *nsDef; /* namespace definitions on this node */ + struct _xmlDoc *doc; /* the containing document */ + xmlNs *ns; /* pointer to the associated namespace */ #ifndef XML_USE_BUFFER_CONTENT - xmlChar *content; /* the content */ + xmlChar *content; /* the content */ #else - xmlBufferPtr content; /* the content in a buffer */ + xmlBufferPtr content; /* the content in a buffer */ #endif + + /* End of common part */ + struct _xmlAttr *properties;/* properties list */ + xmlNs *nsDef; /* namespace definitions on this node */ };

struct xmlDoc { #ifndef XML_WITHOUT_CORBA void *_private; /* for Corba, must be first ! */ - void *vepv; /* for Corba, must be next ! */ #endif xmlElementType type; /* XML_DOCUMENT_NODE, must be second ! */ char *name; /* name/filename/URI of the document */ - const xmlChar *version; /* the XML version string */ - const xmlChar *encoding; /* encoding, if any */ + struct _xmlNode *children; /* the document tree */ + struct _xmlNode *last; /* last child link */ + struct _xmlNode *parent; /* child->parent link */ + struct _xmlNode *next; /* next sibling link */ + struct _xmlNode *prev; /* previous sibling link */ + struct _xmlDoc *doc; /* autoreference to itself */ + + /* End of common part */ int compression;/* level of zlib compression */ int standalone; /* standalone document (no external refs) */ struct _xmlDtd *intSubset; /* the document internal subset */ struct _xmlDtd *extSubset; /* the document external subset */ struct _xmlNs *oldNs; /* Global namespace, the old way */ - struct _xmlNode *root; /* the document tree */ + const xmlChar *version; /* the XML version string */ + const xmlChar *encoding; /* encoding, if any */ void *ids; /* Hash table for ID attributes if any */ void *refs; /* Hash table for IDREFs attributes if any */ + const xmlChar *URL; /* The URI for that document */ };

Creation of a new DTD.

Creation of a new DTD for the external subset. To create an +internal subset, use xmlCreateIntSubset().

Free a property and all its siblings, all the childs are freed too.

Free a property and all its siblings, all the children are freed too.

parent childs list. +> children list.

parent childs list. +> children list.

xmlNewCharRef ()

xmlNodePtr  xmlNewCharRef                   (xmlDocPtr doc,
+                                             const xmlChar *name);

Creation of a new character reference node.

doc : the document
name : the char ref string, starting with # or "&# ... ;"
Returns :a pointer to the new node object.

Get the root element of the document (doc->root is a list +>Get the root element of the document (doc->children is a list containing possibly comments, PIs, etc ...).

Set the root element of the document (doc->root is a list +>Set the root element of the document (doc->children is a list containing possibly comments, PIs, etc ...).

Free a node and all its siblings, this is a recursive behaviour, all -the childs are freed too.

Free a node, this is a recursive behaviour, all the childs are freed too.

Free a node, this is a recursive behaviour, all the children are freed too. +This doesn't unlink the child from the list, use xmlUnlinkNode() first.

xmlNodeGetSpacePreserve ()

int         xmlNodeGetSpacePreserve         (xmlNodePtr cur);

Searches the language of a node, i.e. the values of the xml:space +attribute or the one carried by the nearest ancestor.

cur : the node being checked
Returns :-1 if xml:space is not inheried, 0 if "default", 1 if "preserve"

xmlReconciliateNs ()

int         xmlReconciliateNs               (xmlDocPtr doc,
+                                             xmlNodePtr tree);

This function checks that all the namespaces declared within the given +tree are properly declared. This is needed for example after Copy or Cut +and then paste operations. The subtree may still hold pointers to +namespace declarations outside the subtree or invalid/masked. As much +as possible the function try tu reuse the existing namespaces found in +the new environment. If not possible the new namespaces are redeclared +on tree at the top of the given subtree.

doc : the document
tree : a node defining the subtree to reconciliate
Returns :the number of namespace declarations created or -1 in case of error.

Name

Synopsis

xmlNotationTablePtr table); void xmlDumpNotationDecl (xmlBufferPtr buf, + xmlNotationPtr nota); +void xmlDumpNotationTable (xmlElementContentPtr cur); +void xmlSprintfElementContent (char *buf, + xmlElementContentPtr content, + int glob); xmlElementPtrxmlElementTablePtr table); +void xmlDumpElementDecl (xmlBufferPtr buf, + xmlElementPtr elem); xmlEnumerationPtrxmlChar *name, + const xmlChar *prefix, xmlAttributeTypexmlAttributeTablePtr table); +void xmlDumpAttributeDecl (xmlBufferPtr buf, + xmlAttributePtr attr); xmlIDPtrxmlElementPtr elem); +xmlChar* xmlValidNormalizeAttributeValue (xmlDocPtr doc, + xmlNodePtr elem, + const xmlChar *name, + const xmlChar *value); int xmlValidateAttributeDeclxmlDtdPtr dtd); int xmlValidateDtdFinal (xmlValidCtxtPtr ctxt, + xmlDocPtr doc); +int xmlValidateDocument (

Description

Details

xmlDumpNotationDecl ()

void        xmlDumpNotationDecl             (xmlBufferPtr buf,
+                                             xmlNotationPtr nota);

This will dump the content the notation declaration as an XML DTD definition

buf : the XML buffer output
nota : A notation declaration

xmlSprintfElementContent ()

void        xmlSprintfElementContent        (char *buf,
+                                             xmlElementContentPtr content,
+                                             int glob);

This will dump the content of the element content definition +Intended just for the debug routine

buf : an output buffer
content : An element table
glob : 1 if one must print the englobing parenthesis, 0 otherwise

xmlDumpElementDecl ()

void        xmlDumpElementDecl              (xmlBufferPtr buf,
+                                             xmlElementPtr elem);

This will dump the content of the element declaration as an XML +DTD definition

buf : the XML buffer output
elem : An element table

xmlChar *name, + const xmlChar *prefix, xmlAttributeTypeprefix : type :

xmlDumpAttributeDecl ()

void        xmlDumpAttributeDecl            (xmlBufferPtr buf,
+                                             xmlAttributePtr attr);

This will dump the content of the attribute declaration as an XML +DTD definition

buf : the XML buffer output
attr : An attribute declaration

xmlValidNormalizeAttributeValue ()

xmlChar*    xmlValidNormalizeAttributeValue (xmlDocPtr doc,
+                                             xmlNodePtr elem,
+                                             const xmlChar *name,
+                                             const xmlChar *value);

Does the validation related extra step of the normalization of attribute +values:

If the declared value is not CDATA, then the XML processor must further +process the normalized attribute value by discarding any leading and +trailing space (x20) characters, and by replacing sequences of space +(x20) characters by single space (x20) character.

doc : the document
elem : the parent
name : the attribute name
value : the attribute value
Returns :a new normalized string if normalization is needed, NULL otherwise +the caller must free the returned value.

xmlValidateDtdFinal ()

int         xmlValidateDtdFinal             (xmlValidCtxtPtr ctxt,
+                                             xmlDocPtr doc);

Does the final step for the dtds validation once all the +subsets have been parsed

basically it does the following checks described by the XML Rec +- check that ENTITY and ENTITIES type attributes default or +possible values matches one of the defined entities. +- check that NOTATION type attributes default or +possible values matches one of the defined notations.

ctxt : the validation context
doc : a document instance
Returns :1 if valid or 0 otherwise

Try to validate a single attribute for an element -basically it * does the following checks as described by the +basically it does the following checks as described by the XML-1.0 recommendation: - [ VC: Attribute Value Type ] - [ VC: Fixed Attribute Default ] @@ -5603,7 +6331,7 @@ VALIGN="TOP" >

Name

Synopsis

Description

Details

Name

Synopsis

Description

Details

Create a buffered parser input for the progressive parsing of a file If filename is "-' then we use stdin as the input. Automatic support for ZLIB/Compress compressed document is provided -by default if found at compile-time.

Name

Synopsis

Description

Details

Name

Synopsis

Description

Details

+ @@ -47,6 +48,7 @@ + @@ -76,6 +78,8 @@ + + @@ -216,6 +220,7 @@ + @@ -256,11 +261,13 @@ + + @@ -270,12 +277,7 @@ - - - - - - + @@ -293,7 +295,9 @@ + + @@ -317,14 +321,17 @@ + + + @@ -332,6 +339,7 @@ + @@ -345,10 +353,12 @@ + + @@ -490,9 +500,6 @@ - - - @@ -508,9 +515,10 @@ - + + @@ -565,6 +573,7 @@ + @@ -572,6 +581,7 @@ + @@ -589,6 +599,7 @@ + diff --git a/doc/xml.html b/doc/xml.html index 28cf5ea5..e0403f30 100644 --- a/doc/xml.html +++ b/doc/xml.html @@ -3,7 +3,7 @@ The XML library for Gnome - + @@ -61,7 +61,7 @@ building tag-based structured documents/data.

  • This library is released both under the W3C Copyright and the GNU LGPL. Basically, everybody should be happy; if not, drop me a mail.
  • There is a first set of instruction - concerning upgrade from libxml-1.x to libxml-2.x
    • + concerning upgrade from libxml-1.x to libxml-2.x

    Documentation

    @@ -163,25 +163,37 @@ for really accurate description

    • working on HTML and XML links recognition layers, get in touch with me if you want to test those.
      • -
    • huge work toward libxml-2.0: This work is available only in W3C CVs base - for the moment. You get the snapshot for - the updated version: +
    + +

    2.0.0beta: Mar 14 2000

    +
      +
    • This is a first Beta release of libxml version 2
      • +
    • It's available only from + rpmfind.net FTP, it's packaged as libxml2-2.0.0beta and available as + tar and RPMs
      • +
    • This version is now the head in the Gnome CVS base, the old one is + available under the tag LIB_XML_1_X
      • +
    • This includes a very large set of changes. Froma programmatic point of + view applications should not have to be modified too much, check the upgrade page
      • +
    • Some interfaces may changes (especially a bit about encoding).
      • +
    • the updates includes:
        -
      • fix I18N support. ISO-Latin-x/UTF-8/UTF-16 seems correctly handled - now
        • +
      • fix I18N support. ISO-Latin-x/UTF-8/UTF-16 (nearly) seems correctly + handled now
      • Better handling of entities, especially well formedness checking and proper PEref extensions in external subsets
      • DTD conditional sections
      • Validation now correcly handle entities content
      • change structures to accomodate DOM
        • -
      • Lot of work toward a better compliance. I'm now running and - debugging regression tests agains the OASIS - testsuite
      • +
    • Serious progress were made toward compliance, here are the result of the test against the + OASIS testsuite (except the japanese tests since I don't support that + encoding yet). This URL is rebuilt every couple of hours using the CVS + head version.

    1.8.7: Mar 6 2000

    @@ -1066,6 +1078,6 @@ base under gnome-xml/example

    Daniel Veillard

    -

    $Id: xml.html,v 1.27 2000/03/02 00:15:55 veillard Exp $

    +

    $Id: xml.html,v 1.28 2000/03/06 07:41:49 veillard Exp $

    diff --git a/libxml.spec.in b/libxml.spec.in index 33706b5f..fdd12c71 100644 --- a/libxml.spec.in +++ b/libxml.spec.in @@ -8,10 +8,10 @@ Version: %ver Release: 1 Copyright: LGPL Group: X11/Libraries -Source: ftp://ftp.gnome.org/pub/GNOME/sources/libxml/libxml-%{ver}.tar.gz -BuildRoot: /var/tmp/libxml-%{PACKAGE_VERSION}-root +Source: ftp://ftp.gnome.org/pub/GNOME/sources/libxml/libxml2-%{ver}.tar.gz +BuildRoot: /var/tmp/libxml2-%{PACKAGE_VERSION}-root -URL: http://rpmfind.net/veillard/XML/ +URL: http://xmlsoft.org/ Prereq: /sbin/install-info Docdir: %{prefix}/doc @@ -21,7 +21,7 @@ This library allows you to manipulate XML files. %package devel Summary: Libraries, includes, etc to develop libxml applications Group: X11/libraries -Requires: libxml +Requires: libxml2 %description devel Libraries, include files, etc you can use to develop libxml applications. @@ -79,15 +79,6 @@ fi rm -rf $RPM_BUILD_ROOT make prefix=$RPM_BUILD_ROOT%{prefix} install -# -# hack to get libxml.so.0 too ! -# Get rid of it once deps to libxml.so.0 have disapeared. -# -if [ -f $RPM_BUILD_ROOT/%{prefix}/lib/libxml.so.@VERSION@ ] -then - (cd $RPM_BUILD_ROOT/%{prefix}/lib/ ; cp libxml.so.@VERSION@ libxml.so.0.99.0 ; ln -sf libxml.so.0.99.0 libxml.so.0) -fi - %clean rm -rf $RPM_BUILD_ROOT