1
0
mirror of https://gitlab.gnome.org/GNOME/libxml2.git synced 2025-11-02 09:33:23 +03:00

removed extraneous xmlRemoveProp definition added item about

* tree.h: removed extraneous xmlRemoveProp definition
* TODO: added item about --disable-corba configure switch
* tree.c parser.c: fixed problems for xmlCopyDoc and postvalidation
* nanoftp.c: fixed include problems giving troubles on AIX and
  slowlaris
* xmlIO.[ch] valid.h tree.[ch] xlink.c xmlmemory.c uri.c
  parser.c nanoftp.c nanohttp.c SAX.c testSAX.c :
  comment and headers changes to lower gtk-doc number of warnings
* doc/html/*: rebuilt docs
Daniel
This commit is contained in:
Daniel Veillard
2000-04-24 11:33:38 +00:00
parent e0aed304b1
commit 06047432eb
37 changed files with 2837 additions and 14245 deletions

View File

@@ -4,7 +4,7 @@
>encoding</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.33"><LINK
CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK
REL="HOME"
TITLE="Gnome XML Library Reference Manual"
HREF="book1.html"><LINK
@@ -20,6 +20,9 @@ HREF="gnome-xml-debugxml.html"></HEAD
><BODY
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
@@ -111,19 +114,22 @@ SIZE="3"
></TABLE
></DIV
><H1
>encoding</H1
><A
NAME="GNOME-XML-ENCODING"
>encoding</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN13215"
NAME="AEN10933"
></A
><H2
>Name</H2
>encoding &#8212; </DIV
>encoding&nbsp;--&nbsp;</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN13218"
NAME="AEN10936"
></A
><H2
>Synopsis</H2
@@ -156,23 +162,11 @@ HREF="gnome-xml-encoding.html#XMLCHARENCODINGOUTPUTFUNC"
int outlen,
unsigned char *in,
int *inlen);
struct <A
HREF="gnome-xml-encoding.html#XMLCHARENCODINGHANDLER"
>xmlCharEncodingHandler</A
>;
typedef <A
HREF="gnome-xml-encoding.html#XMLCHARENCODINGHANDLERPTR"
>xmlCharEncodingHandlerPtr</A
>;
void <A
HREF="gnome-xml-encoding.html#XMLINITCHARENCODINGHANDLERS"
>xmlInitCharEncodingHandlers</A
> (void);
void <A
HREF="gnome-xml-encoding.html#XMLCLEANUPCHARENCODINGHANDLERS"
>xmlCleanupCharEncodingHandlers</A
> (void);
void <A
HREF="gnome-xml-encoding.html#XMLREGISTERCHARENCODINGHANDLER"
>xmlRegisterCharEncodingHandler</A
> (<A
@@ -180,21 +174,6 @@ HREF="gnome-xml-encoding.html#XMLCHARENCODINGHANDLERPTR"
>xmlCharEncodingHandlerPtr</A
> handler);
<A
HREF="gnome-xml-encoding.html#XMLCHARENCODING"
>xmlCharEncoding</A
> <A
HREF="gnome-xml-encoding.html#XMLDETECTCHARENCODING"
>xmlDetectCharEncoding</A
> (unsigned char *in,
int len);
<A
HREF="gnome-xml-encoding.html#XMLCHARENCODING"
>xmlCharEncoding</A
> <A
HREF="gnome-xml-encoding.html#XMLPARSECHARENCODING"
>xmlParseCharEncoding</A
> (const char *name);
<A
HREF="gnome-xml-encoding.html#XMLCHARENCODINGHANDLERPTR"
>xmlCharEncodingHandlerPtr</A
> <A
@@ -213,10 +192,25 @@ HREF="gnome-xml-encoding.html#XMLFINDCHARENCODINGHANDLER"
>xmlFindCharEncodingHandler</A
>
(const char *name);
int <A
HREF="gnome-xml-encoding.html#XMLCHECKUTF8"
>xmlCheckUTF8</A
> (unsigned char *utf);</PRE
<A
HREF="gnome-xml-encoding.html#XMLCHARENCODING"
>xmlCharEncoding</A
> <A
HREF="gnome-xml-encoding.html#XMLDETECTCHARENCODING"
>xmlDetectCharEncoding</A
> (unsigned char *in,
int len);
<A
HREF="gnome-xml-encoding.html#XMLCHARENCODING"
>xmlCharEncoding</A
> <A
HREF="gnome-xml-encoding.html#XMLPARSECHARENCODING"
>xmlParseCharEncoding</A
> (const char *name);
void <A
HREF="gnome-xml-encoding.html#XMLINITCHARENCODINGHANDLERS"
>xmlInitCharEncodingHandlers</A
> (void);</PRE
></TD
></TR
></TABLE
@@ -224,7 +218,7 @@ HREF="gnome-xml-encoding.html#XMLCHECKUTF8"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN13240"
NAME="AEN10955"
></A
><H2
>Description</H2
@@ -234,14 +228,14 @@ NAME="AEN13240"
><DIV
CLASS="REFSECT1"
><A
NAME="AEN13243"
NAME="AEN10958"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN13245"
NAME="AEN10960"
></A
><H3
><A
@@ -291,7 +285,7 @@ CLASS="PROGRAMLISTING"
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13250"
NAME="AEN10965"
></A
><H3
><A
@@ -418,7 +412,7 @@ VALIGN="TOP"
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13280"
NAME="AEN10995"
></A
><H3
><A
@@ -545,123 +539,20 @@ VALIGN="TOP"
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13310"
></A
><H3
><A
NAME="XMLCHARENCODINGHANDLER"
></A
>struct xmlCharEncodingHandler</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct xmlCharEncodingHandler {
char *name;
xmlCharEncodingInputFunc input;
xmlCharEncodingOutputFunc output;
};</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13315"
NAME="AEN11025"
></A
><H3
><A
NAME="XMLCHARENCODINGHANDLERPTR"
></A
>xmlCharEncodingHandlerPtr</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef xmlCharEncodingHandler *xmlCharEncodingHandlerPtr;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13320"
></A
><H3
><A
NAME="XMLINITCHARENCODINGHANDLERS"
></A
>xmlInitCharEncodingHandlers ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void xmlInitCharEncodingHandlers (void);</PRE
></TD
></TR
></TABLE
><P
>Initialize the char encoding support, it registers the default
encoding supported.
NOTE: while public, this function usually doesn't need to be called
in normal processing.</P
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13326"
></A
><H3
><A
NAME="XMLCLEANUPCHARENCODINGHANDLERS"
></A
>xmlCleanupCharEncodingHandlers ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void xmlCleanupCharEncodingHandlers (void);</PRE
></TD
></TR
></TABLE
><P
>Cleanup the memory allocated for the char encoding support, it
unregisters all the encoding handlers.</P
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13332"
NAME="AEN11029"
></A
><H3
><A
@@ -714,7 +605,7 @@ CLASS="PARAMETER"
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the xmlCharEncodingHandlerPtr handler block</TD
>&nbsp;</TD
></TR
></TABLE
><P
@@ -724,186 +615,7 @@ VALIGN="TOP"
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13348"
></A
><H3
><A
NAME="XMLDETECTCHARENCODING"
></A
>xmlDetectCharEncoding ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnome-xml-encoding.html#XMLCHARENCODING"
>xmlCharEncoding</A
> xmlDetectCharEncoding (unsigned char *in,
int len);</PRE
></TD
></TR
></TABLE
><P
>Guess the encoding of the entity using the first bytes of the entity content
accordingly of the non-normative appendix F of the XML-1.0 recommendation.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>in</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a pointer to the first bytes of the XML entity, must be at least
4 bytes long.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>len</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> pointer to the length of the buffer</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>one of the XML_CHAR_ENCODING_... values.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13372"
></A
><H3
><A
NAME="XMLPARSECHARENCODING"
></A
>xmlParseCharEncoding ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnome-xml-encoding.html#XMLCHARENCODING"
>xmlCharEncoding</A
> xmlParseCharEncoding (const char *name);</PRE
></TD
></TR
></TABLE
><P
>Conpare the string to the known encoding schemes already known. Note
that the comparison is case insensitive accordingly to the section
[XML] 4.3.3 Character Encoding in Entities.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the encoding name as parsed, in UTF-8 format (ASCII actually)</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>one of the XML_CHAR_ENCODING_... values or XML_CHAR_ENCODING_NONE
if not recognized.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13392"
NAME="AEN11045"
></A
><H3
><A
@@ -960,7 +672,7 @@ CLASS="PARAMETER"
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a string describing the char encoding.</TD
>&nbsp;</TD
></TR
><TR
><TD
@@ -975,7 +687,7 @@ CLASS="EMPHASIS"
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the handler or NULL if not found</TD
>&nbsp;</TD
></TR
></TABLE
><P
@@ -985,7 +697,7 @@ VALIGN="TOP"
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13413"
NAME="AEN11066"
></A
><H3
><A
@@ -1062,13 +774,13 @@ VALIGN="TOP"
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN13432"
NAME="AEN11085"
></A
><H3
><A
NAME="XMLCHECKUTF8"
NAME="XMLDETECTCHARENCODING"
></A
>xmlCheckUTF8 ()</H3
>xmlDetectCharEncoding ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
@@ -1078,27 +790,17 @@ CELLPADDING="6"
><TD
><PRE
CLASS="PROGRAMLISTING"
>int xmlCheckUTF8 (unsigned char *utf);</PRE
><A
HREF="gnome-xml-encoding.html#XMLCHARENCODING"
>xmlCharEncoding</A
> xmlDetectCharEncoding (unsigned char *in,
int len);</PRE
></TD
></TR
></TABLE
><P
>Checks <TT
CLASS="PARAMETER"
><I
>utf</I
></TT
> for being valid utf-8. <TT
CLASS="PARAMETER"
><I
>utf</I
></TT
> 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.</P
>Guess the encoding of the entity using the first bytes of the entity content
accordingly of the non-normative appendix F of the XML-1.0 recommendation.</P
><P
></P
><DIV
@@ -1120,14 +822,31 @@ VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>utf</I
>in</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to putative utf-8 encoded string.</TD
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>len</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
@@ -1142,18 +861,124 @@ CLASS="EMPHASIS"
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> true if <TT
CLASS="PARAMETER"
><I
>utf</I
></TT
> is valid.</TD
>&nbsp;</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN11109"
></A
><H3
><A
NAME="XMLPARSECHARENCODING"
></A
>xmlParseCharEncoding ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnome-xml-encoding.html#XMLCHARENCODING"
>xmlCharEncoding</A
> xmlParseCharEncoding (const char *name);</PRE
></TD
></TR
></TABLE
><P
>Conpare the string to the known encoding schemes already known. Note
that the comparison is case insensitive accordingly to the section
[XML] 4.3.3 Character Encoding in Entities.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN11129"
></A
><H3
><A
NAME="XMLINITCHARENCODINGHANDLERS"
></A
>xmlInitCharEncodingHandlers ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void xmlInitCharEncodingHandlers (void);</PRE
></TD
></TR
></TABLE
><P
>Initialize the char encoding support, it registers the default
encoding supported.
NOTE: while public theis function usually don't need to be called
in normal processing.</P
><P
></P
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"