modified the file header to add more informations, painful... updated to
* include/libxml/*.h include/libxml/*.h.in: modified the file
header to add more informations, painful...
* genChRanges.py genUnicode.py: updated to generate said changes
in headers
* doc/apibuild.py: extract headers, add them to libxml2-api.xml
* *.html *.xsl *.xml: updated the stylesheets to flag geprecated
APIs modules. Updated the stylesheets, some cleanups, regenerated
* doc/html/*.html: regenerated added back book1 and libxml-lib.html
Daniel
diff --git a/include/libxml/DOCBparser.h b/include/libxml/DOCBparser.h
index 3be1f98..f97d2bf 100644
--- a/include/libxml/DOCBparser.h
+++ b/include/libxml/DOCBparser.h
@@ -1,9 +1,11 @@
/*
- * DOCBparser.h : interface for a DocBook SGML non-verifying parser
+ * Summary: old DocBook SGML parser
+ * Description: interface for a DocBook SGML non-verifying parser
+ * This code is DEPRECATED, and should not be used anymore.
*
- * See Copyright for the status of this software.
+ * Copy: See Copyright for the status of this software.
*
- * daniel@veillard.com
+ * Author: Daniel Veillard
*/
#ifndef __DOCB_PARSER_H__
diff --git a/include/libxml/HTMLparser.h b/include/libxml/HTMLparser.h
index 6bab1a5..f39f0bb 100644
--- a/include/libxml/HTMLparser.h
+++ b/include/libxml/HTMLparser.h
@@ -1,9 +1,13 @@
/*
- * HTMLparser.h : interface for an HTML 4.0 non-verifying parser
+ * Summary: interface for an HTML 4.0 non-verifying parser
+ * Description: this module implements an HTML 4.0 non-verifying parser
+ * with API compatible with the XML parser ones. It should
+ * be able to parse "real world" HTML, even if severely
+ * broken from a specification point of view.
*
- * See Copyright for the status of this software.
+ * Copy: See Copyright for the status of this software.
*
- * daniel@veillard.com
+ * Author: Daniel Veillard
*/
#ifndef __HTML_PARSER_H__
diff --git a/include/libxml/HTMLtree.h b/include/libxml/HTMLtree.h
index 832c7c8..157aa67 100644
--- a/include/libxml/HTMLtree.h
+++ b/include/libxml/HTMLtree.h
@@ -1,10 +1,11 @@
/*
- * HTMLtree.h : describes the structures found in an tree resulting
- * from an XML parsing.
+ * Summary: specific APIs to process HTML tree, especially serialization
+ * Description: this module implements a few function needed to process
+ * tree in an HTML specific way.
*
- * See Copyright for the status of this software.
+ * Copy: See Copyright for the status of this software.
*
- * daniel@veillard.com
+ * Author: Daniel Veillard
*/
#ifndef __HTML_TREE_H__
diff --git a/include/libxml/SAX.h b/include/libxml/SAX.h
index 3d5896e..a305b69 100644
--- a/include/libxml/SAX.h
+++ b/include/libxml/SAX.h
@@ -1,9 +1,11 @@
/*
- * SAX.h : Old SAX vewrsion1 handler interfaces.
+ * Summary: Old SAX version 1 handler, deprecated
+ * Description: DEPRECATED set of SAX version 1 interfaces used to
+ * build the DOM tree.
*
- * See Copyright for the status of this software.
+ * Copy: See Copyright for the status of this software.
*
- * Daniel Veillard <daniel@veillard.com>
+ * Author: Daniel Veillard
*/
diff --git a/include/libxml/SAX2.h b/include/libxml/SAX2.h
index 1793f91..f5cc53c 100644
--- a/include/libxml/SAX2.h
+++ b/include/libxml/SAX2.h
@@ -1,9 +1,11 @@
/*
- * SAX.h : Default SAX2 handler interfaces to build a tree.
+ * Summary: SAX2 parser interface used to build the DOM tree
+ * Description: those are the default SAX2 interfaces used by
+ * the library when building DOM tree.
*
- * See Copyright for the status of this software.
+ * Copy: See Copyright for the status of this software.
*
- * Daniel Veillard <daniel@veillard.com>
+ * Author: Daniel Veillard
*/
diff --git a/include/libxml/c14n.h b/include/libxml/c14n.h
index 8a78929..4bc441c 100644
--- a/include/libxml/c14n.h
+++ b/include/libxml/c14n.h
@@ -1,11 +1,16 @@
/*
+ * Summary: Provide Canonical XML and Exclusive XML Canonicalization
+ * Description: the c14n modules provides a
+ *
* "Canonical XML" implementation
* http://www.w3.org/TR/xml-c14n
*
+ * and an
+ *
* "Exclusive XML Canonicalization" implementation
* http://www.w3.org/TR/xml-exc-c14n
- * See Copyright for the status of this software.
+ * Copy: See Copyright for the status of this software.
*
* Author: Aleksey Sanin <aleksey@aleksey.com>
*/
diff --git a/include/libxml/catalog.h b/include/libxml/catalog.h
index c8a5ac3..9701da0 100644
--- a/include/libxml/catalog.h
+++ b/include/libxml/catalog.h
@@ -1,15 +1,17 @@
/**
- * catalog.h: interfaces of the Catalog handling system
+ * Summary: interfaces to the Catalog handling system
+ * Description: the catalog module implements the support for
+ * XML Catalogs and SGML catalogs
*
- * Reference: SGML Open Technical Resolution TR9401:1997.
- * http://www.jclark.com/sp/catalog.htm
+ * SGML Open Technical Resolution TR9401:1997.
+ * http://www.jclark.com/sp/catalog.htm
*
- * XML Catalogs Working Draft 12 Jun 2001
- * http://www.oasis-open.org/committees/entity/spec-2001-06-12.html
+ * XML Catalogs Working Draft 06 August 2001
+ * http://www.oasis-open.org/committees/entity/spec-2001-08-06.html
*
- * See Copyright for the status of this software.
+ * Copy: See Copyright for the status of this software.
*
- * daniel@veillard.com
+ * Author: Daniel Veillard
*/
#ifndef __XML_CATALOG_H__
diff --git a/include/libxml/chvalid.h b/include/libxml/chvalid.h
index 0e0c7f4..db12263 100644
--- a/include/libxml/chvalid.h
+++ b/include/libxml/chvalid.h
@@ -1,5 +1,6 @@
/*
- * chvalid.h: this header exports interfaces for the character
+ * Summary: Unicode character range checking
+ * Description: this module exports interfaces for the character
* range validation APIs
*
* This file is automatically generated from the cvs source
@@ -7,7 +8,7 @@
*
* Generation date: Tue Nov 18 08:14:21 2003
* Sources: chvalid.def
- * William Brack <wbrack@mmm.com.hk>
+ * Author: William Brack <wbrack@mmm.com.hk>
*/
#ifndef __XML_CHVALID_H__
diff --git a/include/libxml/debugXML.h b/include/libxml/debugXML.h
index 58211eb..85966e5 100644
--- a/include/libxml/debugXML.h
+++ b/include/libxml/debugXML.h
@@ -1,8 +1,11 @@
/*
- * debugXML.h : Interfaces to a set of routines used for debugging the tree
+ * Summary: Tree debugging APIs
+ * Description: Interfaces to a set of routines used for debugging the tree
* produced by the XML parser.
*
- * Daniel Veillard <daniel@veillard.com>
+ * Copy: See Copyright for the status of this software.
+ *
+ * Author: Daniel Veillard
*/
#ifndef __DEBUG_XML__
diff --git a/include/libxml/dict.h b/include/libxml/dict.h
index d04a973..e3390b3 100644
--- a/include/libxml/dict.h
+++ b/include/libxml/dict.h
@@ -1,19 +1,11 @@
/*
- * dict.h: dictionary of reusable strings, just used to avoid allocation
+ * Summary: string dictionnary
+ * Description: dictionary of reusable strings, just used to avoid allocation
* and freeing operations.
*
- * Copyright (C) 2003 Daniel Veillard.
+ * Copy: See Copyright for the status of this software.
*
- * Permission to use, copy, modify, and distribute this software for any
- * purpose with or without fee is hereby granted, provided that the above
- * copyright notice and this permission notice appear in all copies.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
- * WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
- * MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE AUTHORS AND
- * CONTRIBUTORS ACCEPT NO RESPONSIBILITY IN ANY CONCEIVABLE MANNER.
- *
- * Author: daniel@veillard.com
+ * Author: Daniel Veillard
*/
#ifndef __XML_DICT_H__
diff --git a/include/libxml/encoding.h b/include/libxml/encoding.h
index 4c6b7a8..74b4c4a 100644
--- a/include/libxml/encoding.h
+++ b/include/libxml/encoding.h
@@ -1,8 +1,9 @@
/*
- * encoding.h : interface for the encoding conversion functions needed for
- * XML
+ * Summary: interface for the encoding conversion functions
+ * Description: interface for the encoding conversion functions needed for
+ * XML basic encoding and iconv() support.
*
- * Related specs:
+ * Related specs are
* rfc2044 (UTF-8 and UTF-16) F. Yergeau Alis Technologies
* [ISO-10646] UTF-8 and UTF-16 in Annexes
* [ISO-8859-1] ISO Latin-1 characters codes.
@@ -13,9 +14,9 @@
* [US-ASCII] Coded Character Set--7-bit American Standard Code for
* Information Interchange, ANSI X3.4-1986.
*
- * See Copyright for the status of this software.
+ * Copy: See Copyright for the status of this software.
*
- * daniel@veillard.com
+ * Author: Daniel Veillard
*/
#ifndef __XML_CHAR_ENCODING_H__
diff --git a/include/libxml/entities.h b/include/libxml/entities.h
index 515913d..2dc1217 100644
--- a/include/libxml/entities.h
+++ b/include/libxml/entities.h
@@ -1,9 +1,11 @@
/*
- * entities.h : interface for the XML entities handling
+ * Summary: interface for the XML entities handling
+ * Description: this module provides some of the entity API needed
+ * for the parser and applications.
*
- * See Copyright for the status of this software.
+ * Copy: See Copyright for the status of this software.
*
- * daniel@veillard.com
+ * Author: Daniel Veillard
*/
#ifndef __XML_ENTITIES_H__
diff --git a/include/libxml/globals.h b/include/libxml/globals.h
index 733632c..e38c103 100644
--- a/include/libxml/globals.h
+++ b/include/libxml/globals.h
@@ -1,13 +1,14 @@
/*
- * globals.h: interface for all global variables of the library
+ * Summary: interface for all global variables of the library
+ * Description: all the global variables and thread handling for
+ * those variables is handled by this module.
*
* The bottom of this file is automatically generated by build_glob.py
* based on the description file global.data
*
- * See Copyright for the status of this software.
+ * Copy: See Copyright for the status of this software.
*
- * Gary Pennington <Gary.Pennington@uk.sun.com>
- * daniel@veillard.com
+ * Author: Gary Pennington <Gary.Pennington@uk.sun.com>, Daniel Veillard
*/
#ifndef __XML_GLOBALS_H
diff --git a/include/libxml/hash.h b/include/libxml/hash.h
index 8e5d0bb..0c52eeb 100644
--- a/include/libxml/hash.h
+++ b/include/libxml/hash.h
@@ -1,18 +1,11 @@
/*
- * hash.h: chained hash tables
+ * Summary: chained hash tables
+ * description: this module implement the hash table support used in
+ * various place in the library.
*
- * Copyright (C) 2000 Bjorn Reese and Daniel Veillard.
+ * Copy: See Copyright for the status of this software.
*
- * Permission to use, copy, modify, and distribute this software for any
- * purpose with or without fee is hereby granted, provided that the above
- * copyright notice and this permission notice appear in all copies.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
- * WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
- * MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE AUTHORS AND
- * CONTRIBUTORS ACCEPT NO RESPONSIBILITY IN ANY CONCEIVABLE MANNER.
- *
- * Author: bjorn.reese@systematic.dk
+ * Author: Bjorn Reese <bjorn.reese@systematic.dk>
*/
#ifndef __XML_HASH_H__
diff --git a/include/libxml/list.h b/include/libxml/list.h
index 297831a..1d83482 100644
--- a/include/libxml/list.h
+++ b/include/libxml/list.h
@@ -1,18 +1,11 @@
/*
- * list.h: lists interfaces
+ * Summary: lists interfaces
+ * Description: this module implement the list support used in
+ * various place in the library.
*
- * Copyright (C) 2000 Gary Pennington and Daniel Veillard.
+ * Copy: See Copyright for the status of this software.
*
- * Permission to use, copy, modify, and distribute this software for any
- * purpose with or without fee is hereby granted, provided that the above
- * copyright notice and this permission notice appear in all copies.
- *
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
- * WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
- * MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE AUTHORS AND
- * CONTRIBUTORS ACCEPT NO RESPONSIBILITY IN ANY CONCEIVABLE MANNER.
- *
- * Author: Gary.Pennington@uk.sun.com
+ * Author: Gary Pennington <Gary.Pennington@uk.sun.com>
*/
#ifndef __XML_LINK_INCLUDE__
diff --git a/include/libxml/nanoftp.h b/include/libxml/nanoftp.h
index 2156c79..01fadb8 100644
--- a/include/libxml/nanoftp.h
+++ b/include/libxml/nanoftp.h
@@ -1,9 +1,11 @@
/*
- * nanohttp.c: minimalist FTP implementation to fetch external subsets.
+ * Summary: minimal FTP implementation
+ * Description: minimal FTP implementation allowing to fetch resources
+ * like external subset.
*
- * See Copyright for the status of this software.
+ * Copy: See Copyright for the status of this software.
*
- * daniel@veillard.com
+ * Author: Daniel Veillard
*/
#ifndef __NANO_FTP_H__
diff --git a/include/libxml/nanohttp.h b/include/libxml/nanohttp.h
index f404c7b..2853184 100644
--- a/include/libxml/nanohttp.h
+++ b/include/libxml/nanohttp.h
@@ -1,9 +1,11 @@
/*
- * nanohttp.c: minimalist HTTP implementation to fetch external subsets.
+ * Summary: minimal HTTP implementation
+ * Description: minimal HTTP implementation allowing to fetch resources
+ * like external subset.
*
- * See Copyright for the status of this software.
+ * Copy: See Copyright for the status of this software.
*
- * daniel@veillard.com
+ * Author: Daniel Veillard
*/
#ifndef __NANO_HTTP_H__
diff --git a/include/libxml/parser.h b/include/libxml/parser.h
index d7f8ce7..c4b5ff3 100644
--- a/include/libxml/parser.h
+++ b/include/libxml/parser.h
@@ -1,9 +1,10 @@
/*
- * parser.h : Interfaces, constants and types related to the XML parser.
+ * Summary: the core parser module
+ * Description: Interfaces, constants and types related to the XML parser
*
- * See Copyright for the status of this software.
+ * Copy: See Copyright for the status of this software.
*
- * daniel@veillard.com
+ * Author: Daniel Veillard
*/
#ifndef __XML_PARSER_H__
diff --git a/include/libxml/parserInternals.h b/include/libxml/parserInternals.h
index e139199..7e4503d 100644
--- a/include/libxml/parserInternals.h
+++ b/include/libxml/parserInternals.h
@@ -1,10 +1,12 @@
/*
- * parserInternals.h : internals routines exported by the parser.
+ * Summary: internals routines exported by the parser.
+ * Description: this module exports a number of internal parsing routines
+ * they are not really all intended for applications but
+ * can prove useful doing low level processing.
*
- * See Copyright for the status of this software.
+ * Copy: See Copyright for the status of this software.
*
- * daniel@veillard.com
- *
+ * Author: Daniel Veillard
*/
#ifndef __XML_PARSER_INTERNALS_H__
diff --git a/include/libxml/relaxng.h b/include/libxml/relaxng.h
index 519616a..3cf95c2 100644
--- a/include/libxml/relaxng.h
+++ b/include/libxml/relaxng.h
@@ -1,9 +1,10 @@
/*
- * relaxng.h: header for the implementation of the Relax-NG validation
+ * Summary: implementation of the Relax-NG validation
+ * Description: implementation of the Relax-NG validation
*
- * See Copyright for the status of this software.
+ * Copy: See Copyright for the status of this software.
*
- * daniel@veillard.com
+ * Author: Daniel Veillard
*/
#ifndef __XML_RELAX_NG__
diff --git a/include/libxml/schemasInternals.h b/include/libxml/schemasInternals.h
index db42d3e..a044b67 100644
--- a/include/libxml/schemasInternals.h
+++ b/include/libxml/schemasInternals.h
@@ -1,10 +1,11 @@
/*
- * schemasInternals.h : internal interfaces for the XML Schemas handling
- * and schema validity checking
+ * Summary: internal interfaces for XML Schemas
+ * Description: internal interfaces for the XML Schemas handling
+ * and schema validity checking
*
- * See Copyright for the status of this software.
+ * Copy: See Copyright for the status of this software.
*
- * Daniel.Veillard@w3.org
+ * Author: Daniel Veillard
*/
diff --git a/include/libxml/threads.h b/include/libxml/threads.h
index 193c9ae..fb6b704 100644
--- a/include/libxml/threads.h
+++ b/include/libxml/threads.h
@@ -1,9 +1,11 @@
/**
- * threads.c: set of generic threading related routines
+ * Summary: interfaces for thread handling
+ * Description: set of generic threading related routines
+ * should work with pthreads, Windows native or TLS threads
*
- * See Copyright for the status of this software.
+ * Copy: See Copyright for the status of this software.
*
- * daniel@veillard.com
+ * Author: Daniel Veillard
*/
#ifndef __XML_THREADS_H__
diff --git a/include/libxml/tree.h b/include/libxml/tree.h
index 82b757a..cfa95ec 100644
--- a/include/libxml/tree.h
+++ b/include/libxml/tree.h
@@ -1,11 +1,12 @@
/*
- * tree.h : describes the structures found in an tree resulting
- * from an XML parsing.
+ * Summary: interfaces for tree manipulation
+ * Description: this module describes the structures found in an tree resulting
+ * from an XML or HTML parsing, as well as the API provided for
+ * various processing on that tree
*
- * See Copyright for the status of this software.
+ * Copy: See Copyright for the status of this software.
*
- * daniel@veillard.com
- *
+ * Author: Daniel Veillard
*/
#ifndef __XML_TREE_H__
diff --git a/include/libxml/uri.h b/include/libxml/uri.h
index 7c89641..5e29e63 100644
--- a/include/libxml/uri.h
+++ b/include/libxml/uri.h
@@ -1,11 +1,11 @@
/**
- * uri.c: library of generic URI related routines
+ * Summary: library of generic URI related routines
+ * Description: library of generic URI related routines
+ * Implements RFC 2396
*
- * Reference: RFC 2396
+ * Copy: See Copyright for the status of this software.
*
- * See Copyright for the status of this software.
- *
- * daniel@veillard.com
+ * Author: Daniel Veillard
*/
#ifndef __XML_URI_H__
diff --git a/include/libxml/valid.h b/include/libxml/valid.h
index 4444650..1ff3f0b 100644
--- a/include/libxml/valid.h
+++ b/include/libxml/valid.h
@@ -1,9 +1,10 @@
/*
- * valid.h : interface to the DTD handling and the validity checking
+ * Summary: The DTD validation
+ * Description: API for the DTD handling and the validity checking
*
- * See Copyright for the status of this software.
+ * Copy: See Copyright for the status of this software.
*
- * daniel@veillard.com
+ * Author: Daniel Veillard
*/
diff --git a/include/libxml/xinclude.h b/include/libxml/xinclude.h
index c952d3a..a779931 100644
--- a/include/libxml/xinclude.h
+++ b/include/libxml/xinclude.h
@@ -1,12 +1,13 @@
/*
- * xinclude.c : API to handle XInclude processing
- *
+ * Summary: implementation of XInclude
+ * Description: API to handle XInclude processing,
+ * implements the
* World Wide Web Consortium Working Draft 26 October 2000
* http://www.w3.org/TR/2000/WD-xinclude-20001026
*
- * See Copyright for the status of this software.
+ * Copy: See Copyright for the status of this software.
*
- * daniel@veillard.com
+ * Author: Daniel Veillard
*/
#ifndef __XML_XINCLUDE_H__
diff --git a/include/libxml/xlink.h b/include/libxml/xlink.h
index cb7ad71..4b99611 100644
--- a/include/libxml/xlink.h
+++ b/include/libxml/xlink.h
@@ -1,13 +1,10 @@
/*
- * xlink.h : interfaces to the hyperlinks detection module
+ * Summary: unfinished XLink detection module
+ * Description: unfinished XLink detection module
*
- * See Copyright for the status of this software.
+ * Copy: See Copyright for the status of this software.
*
- * Related specification: http://www.w3.org/TR/xlink
- * http://www.w3.org/HTML/
- * and XBase
- *
- * daniel@veillard.com
+ * Author: Daniel Veillard
*/
#ifndef __XML_XLINK_H__
diff --git a/include/libxml/xmlIO.h b/include/libxml/xmlIO.h
index ac390ce..2ab845d 100644
--- a/include/libxml/xmlIO.h
+++ b/include/libxml/xmlIO.h
@@ -1,10 +1,10 @@
/*
- * xmlIO.h : interface for the I/O interfaces used by the parser
+ * Summary: interface for the I/O interfaces used by the parser
+ * Description: interface for the I/O interfaces used by the parser
*
- * See Copyright for the status of this software.
+ * Copy: See Copyright for the status of this software.
*
- * daniel@veillard.com
- *
+ * Author: Daniel Veillard
*/
#ifndef __XML_IO_H__
diff --git a/include/libxml/xmlautomata.h b/include/libxml/xmlautomata.h
index c51284b..16a1467 100644
--- a/include/libxml/xmlautomata.h
+++ b/include/libxml/xmlautomata.h
@@ -1,9 +1,10 @@
/*
- * automata.h : description of the API to build regexp automats
+ * Summary: API to build regexp automata
+ * Description: the API to build regexp automata
*
- * See Copyright for the status of this software.
+ * Copy: See Copyright for the status of this software.
*
- * Daniel Veillard <veillard@redhat.com>
+ * Author: Daniel Veillard
*/
#ifndef __XML_AUTOMATA_H__
diff --git a/include/libxml/xmlerror.h b/include/libxml/xmlerror.h
index 3532023..648ddff 100644
--- a/include/libxml/xmlerror.h
+++ b/include/libxml/xmlerror.h
@@ -1,3 +1,12 @@
+/*
+ * Summary: error handling
+ * Description: the API used to report errors
+ *
+ * Copy: See Copyright for the status of this software.
+ *
+ * Author: Daniel Veillard
+ */
+
#include <libxml/parser.h>
#ifndef __XML_ERROR_H__
diff --git a/include/libxml/xmlexports.h b/include/libxml/xmlexports.h
index 4b40da7..c90e420 100644
--- a/include/libxml/xmlexports.h
+++ b/include/libxml/xmlexports.h
@@ -1,9 +1,10 @@
/*
- * xmlexports.h : macros for marking symbols as exportable/importable.
+ * Summary: macros for marking symbols as exportable/importable.
+ * Description: macros for marking symbols as exportable/importable.
*
- * See Copyright for the status of this software.
+ * Copy: See Copyright for the status of this software.
*
- * igor@zlatkovic.com
+ * Author: Igor Zlatovic <igor@zlatkovic.com>
*/
#ifndef __XML_EXPORTS_H__
diff --git a/include/libxml/xmlmemory.h b/include/libxml/xmlmemory.h
index c78f65a..3d890d0 100644
--- a/include/libxml/xmlmemory.h
+++ b/include/libxml/xmlmemory.h
@@ -1,7 +1,11 @@
/*
- * xmlmemory.h: interface for the memory allocation debug.
+ * Summary: interface for the memory allocator
+ * Description: provides interfaces for the memory allocator,
+ * including debugging capabilities.
*
- * daniel@veillard.com
+ * Copy: See Copyright for the status of this software.
+ *
+ * Author: Daniel Veillard
*/
diff --git a/include/libxml/xmlreader.h b/include/libxml/xmlreader.h
index d273681..a144764 100644
--- a/include/libxml/xmlreader.h
+++ b/include/libxml/xmlreader.h
@@ -1,9 +1,10 @@
/*
- * xmlreader.h : Interfaces, constants and types of the XML streaming API.
+ * Summary: the XMLReader implementation
+ * Description: API of the XML streaming API based on C# interfaces.
*
- * See Copyright for the status of this software.
+ * Copy: See Copyright for the status of this software.
*
- * daniel@veillard.com
+ * Author: Daniel Veillard
*/
#ifndef __XML_XMLREADER_H__
diff --git a/include/libxml/xmlregexp.h b/include/libxml/xmlregexp.h
index 0e332b6..6a9bcf1 100644
--- a/include/libxml/xmlregexp.h
+++ b/include/libxml/xmlregexp.h
@@ -1,9 +1,11 @@
/*
- * regexp.h : describes the basic API for libxml regular expressions handling
+ * Summary: regular expressions handling
+ * Description: basic API for libxml regular expressions handling used
+ * for XML Schemas and validation.
*
- * See Copyright for the status of this software.
+ * Copy: See Copyright for the status of this software.
*
- * Daniel Veillard <veillard@redhat.com>
+ * Author: Daniel Veillard
*/
#ifndef __XML_REGEXP_H__
diff --git a/include/libxml/xmlschemas.h b/include/libxml/xmlschemas.h
index ea469a3..49bf3b4 100644
--- a/include/libxml/xmlschemas.h
+++ b/include/libxml/xmlschemas.h
@@ -1,10 +1,11 @@
/*
- * schemas.h : interface to the XML Schemas handling and schema validity
- * checking
+ * Summary: incomplete XML Schemas structure implementation
+ * Description: interface to the XML Schemas handling and schema validity
+ * checking, it is incomplete right now.
*
- * See Copyright for the status of this software.
+ * Copy: See Copyright for the status of this software.
*
- * Daniel.Veillard@w3.org
+ * Author: Daniel Veillard
*/
diff --git a/include/libxml/xmlschemastypes.h b/include/libxml/xmlschemastypes.h
index 873101e..4514c59 100644
--- a/include/libxml/xmlschemastypes.h
+++ b/include/libxml/xmlschemastypes.h
@@ -1,10 +1,11 @@
/*
- * schemastypes.c : interface of the XML Schema Datatypes
- * definition and validity checking
+ * Summary: implementation of XML Schema Datatypes
+ * Description: module providing the XML Schema Datatypes implementation
+ * both definition and validity checking
*
- * See Copyright for the status of this software.
+ * Copy: See Copyright for the status of this software.
*
- * Daniel Veillard <veillard@redhat.com>
+ * Author: Daniel Veillard
*/
diff --git a/include/libxml/xmlunicode.h b/include/libxml/xmlunicode.h
index 48ac131..b8537dc 100644
--- a/include/libxml/xmlunicode.h
+++ b/include/libxml/xmlunicode.h
@@ -1,5 +1,6 @@
/*
- * xmlunicode.h: this header exports interfaces for the Unicode character APIs
+ * Summary: Unicode character APIs
+ * Description: API for the Unicode character APIs
*
* This file is automatically generated from the
* UCS description files of the Unicode Character Database
@@ -8,7 +9,7 @@
*
* Generation date: Mon Nov 10 22:35:10 2003
* Sources: Blocks-4.0.1d1b.txt UnicodeData-4.0.1d1b.txt
- * Daniel Veillard <veillard@redhat.com>
+ * Author: Daniel Veillard
*/
#ifndef __XML_UNICODE_H__
diff --git a/include/libxml/xmlversion.h.in b/include/libxml/xmlversion.h.in
index 91c6107..dd78b88 100644
--- a/include/libxml/xmlversion.h.in
+++ b/include/libxml/xmlversion.h.in
@@ -1,9 +1,10 @@
/*
- * xmlversion.h : compile-time version informations for the XML parser.
+ * Summary: compile-time version informations
+ * Description: compile-time version informations for the XML library
*
- * See Copyright for the status of this software.
+ * Copy: See Copyright for the status of this software.
*
- * daniel@veillard.com
+ * Author: Daniel Veillard
*/
#ifndef __XML_VERSION_H__
diff --git a/include/libxml/xmlwin32version.h b/include/libxml/xmlwin32version.h
index f19be59..d09dd03 100644
--- a/include/libxml/xmlwin32version.h
+++ b/include/libxml/xmlwin32version.h
@@ -1,10 +1,11 @@
/*
- * xmlwin32version.h : compile-time version informations for the XML parser
- * when compiled on the Windows platform
+ * Summary: compile-time version informations on Windows
+ * Description: compile-time version informations for the XML library
+ * when compiled on the Windows platform
*
- * See Copyright for the status of this software.
+ * Copy: See Copyright for the status of this software.
*
- * daniel@veillard.com
+ * Author: Daniel Veillard
*/
#ifndef __XML_VERSION_H__
diff --git a/include/libxml/xmlwin32version.h.in b/include/libxml/xmlwin32version.h.in
index 3ecdf75..7554966 100644
--- a/include/libxml/xmlwin32version.h.in
+++ b/include/libxml/xmlwin32version.h.in
@@ -1,10 +1,11 @@
/*
- * xmlwin32version.h : compile-time version informations for the XML parser
- * when compiled on the Windows platform
+ * Summary: compile-time version informations on Windows
+ * Description: compile-time version informations for the XML library
+ * when compiled on the Windows platform
*
- * See Copyright for the status of this software.
+ * Copy: See Copyright for the status of this software.
*
- * daniel@veillard.com
+ * Author: Daniel Veillard
*/
#ifndef __XML_VERSION_H__
diff --git a/include/libxml/xmlwriter.h b/include/libxml/xmlwriter.h
index 224d030..23635de 100644
--- a/include/libxml/xmlwriter.h
+++ b/include/libxml/xmlwriter.h
@@ -1,13 +1,10 @@
-
/*
- * xmlwriter.h : Interfaces,
- constants and types of the
- * text writing API.for XML
+ * Summary: text writing API for XML
+ * Description: text writing API for XML
*
- * For license and disclaimer see the license and disclaimer of
- * libxml2.
+ * Copy: See Copyright for the status of this software.
*
- * alfred@mickautsch.de
+ * Author: Alfred Mickautsch <alfred@mickautsch.de>
*/
#ifndef __XML_XMLWRITER_H__
diff --git a/include/libxml/xpath.h b/include/libxml/xpath.h
index dbd1b77..5172e93 100644
--- a/include/libxml/xpath.h
+++ b/include/libxml/xpath.h
@@ -1,12 +1,19 @@
/*
- * xpath.c: interface for XML Path Language implementation
+ * Summary: XML Path Language implementation
+ * Description: API for the XML Path Language implementation
*
- * Reference: W3C Working Draft 5 July 1999
- * http://www.w3.org/Style/XSL/Group/1999/07/xpath-19990705.html
+ * XML Path Language implementation
+ * XPath is a language for addressing parts of an XML document,
+ * designed to be used by both XSLT and XPointer
+ * http://www.w3.org/TR/xpath
*
- * See COPYRIGHT for the status of this software
+ * Implements
+ * W3C Recommendation 16 November 1999
+ * http://www.w3.org/TR/1999/REC-xpath-19991116
*
- * Author: daniel@veillard.com
+ * Copy: See Copyright for the status of this software.
+ *
+ * Author: Daniel Veillard
*/
#ifndef __XML_XPATH_H__
diff --git a/include/libxml/xpathInternals.h b/include/libxml/xpathInternals.h
index 896742b..75e5d74 100644
--- a/include/libxml/xpathInternals.h
+++ b/include/libxml/xpathInternals.h
@@ -1,10 +1,12 @@
/*
- * xpathInternals.c: internal interfaces for XML Path Language implementation
- * used to build new modules on top of XPath
+ * Summary: internal interfaces for XML Path Language implementation
+ * Description: internal interfaces for XML Path Language implementation
+ * used to build new modules on top of XPath like XPointer and
+ * XSLT
*
- * See COPYRIGHT for the status of this software
+ * Copy: See Copyright for the status of this software.
*
- * Author: daniel@veillard.com
+ * Author: Daniel Veillard
*/
#ifndef __XML_XPATH_INTERNALS_H__
diff --git a/include/libxml/xpointer.h b/include/libxml/xpointer.h
index 67e17db..7f59eb7 100644
--- a/include/libxml/xpointer.h
+++ b/include/libxml/xpointer.h
@@ -1,12 +1,17 @@
/*
- * xpointer.h : API to handle XML Pointers
+ * Summary: API to handle XML Pointers
+ * Description: API to handle XML Pointers
+ * Base implementation was made accordingly to
+ * W3C Candidate Recommendation 7 June 2000
+ * http://www.w3.org/TR/2000/CR-xptr-20000607
*
- * World Wide Web Consortium Working Draft 03-March-1998
- * http://www.w3.org/TR/1998/WD-xptr-19980303
+ * Added support for the element() scheme described in:
+ * W3C Proposed Recommendation 13 November 2002
+ * http://www.w3.org/TR/2002/PR-xptr-element-20021113/
*
- * See Copyright for the status of this software.
+ * Copy: See Copyright for the status of this software.
*
- * daniel@veillard.com
+ * Author: Daniel Veillard
*/
#ifndef __XML_XPTR_H__