From 26849a92603d2af2e8b723e53943229d3e7eef8b Mon Sep 17 00:00:00 2001 From: Daniel Veillard Date: Wed, 12 Sep 2001 20:51:09 +0000 Subject: [PATCH] preparing for 1.0.4 updated and regenerated docs Daniel * configure.in: preparing for 1.0.4 * doc/xslt.html doc/html/*: updated and regenerated docs Daniel --- ChangeLog | 5 + configure.in | 7 +- doc/html/libxslt-attributes.html | 20 +- doc/html/libxslt-functions.html | 260 +++++++++++-- doc/html/libxslt-imports.html | 40 +- doc/html/libxslt-keys.html | 28 +- doc/html/libxslt-namespaces.html | 32 +- doc/html/libxslt-numbersinternals.html | 16 +- doc/html/libxslt-pattern.html | 47 +-- doc/html/libxslt-templates.html | 44 +-- doc/html/libxslt-transform.html | 669 ++++++++++++++++++++++++++++++--- doc/html/libxslt-variables.html | 541 ++++++++++++++++++++++++-- doc/html/libxslt-xslt.html | 70 +++- doc/html/libxslt-xsltinternals.html | 562 +++++++++++++++++++++------ doc/html/libxslt-xsltutils.html | 279 ++++++-------- doc/xslt.html | 9 + libxslt/xsltwin32config.h | 6 +- 17 files changed, 2124 insertions(+), 511 deletions(-) diff --git a/ChangeLog b/ChangeLog index c80ed68..a94a83e 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,8 @@ +Wed Sep 12 21:09:53 CEST 2001 Daniel Veillard + + * configure.in: preparing for 1.0.4 + * doc/xslt.html doc/html/*: updated and regenerated docs + Wed Sep 12 18:10:33 CEST 2001 Thomas Broyer * libexslt/date.c: fixed some compile warnings and disabled diff --git a/configure.in b/configure.in index d21c979..d65fcdc 100644 --- a/configure.in +++ b/configure.in @@ -2,14 +2,15 @@ AC_INIT(libxslt/xslt.c) dnl dnl libxslt is the main part of the package +dnl libexslt is an extension dnl LIBXSLT_MAJOR_VERSION=1 LIBXSLT_MINOR_VERSION=0 -LIBXSLT_MICRO_VERSION=3 +LIBXSLT_MICRO_VERSION=4 PACKAGE=libxslt LIBEXSLT_MAJOR_VERSION=0 -LIBEXSLT_MINOR_VERSION=3 -LIBEXSLT_MICRO_VERSION=1 +LIBEXSLT_MINOR_VERSION=4 +LIBEXSLT_MICRO_VERSION=0 LIBXML_REQUIRED_VERSION=2.4.3 diff --git a/doc/html/libxslt-attributes.html b/doc/html/libxslt-attributes.html index c342744..3f154e1 100644 --- a/doc/html/libxslt-attributes.html +++ b/doc/html/libxslt-attributes.html @@ -122,7 +122,7 @@ NAME="LIBXSLT-ATTRIBUTES" >

Name

Synopsis

Description

Details

Name

Synopsis

+#define XSLT_REGISTER_FUNCTION_LOOKUP (ctxt) +xmlXPathFunction xsltXPathFunctionLookup (xmlXPathContextPtr ctxt, + const xmlChar *name, + const xmlChar *ns_uri); void xsltDocumentFunction

Description

Details

XSLT_REGISTER_FUNCTION_LOOKUP()

#define     XSLT_REGISTER_FUNCTION_LOOKUP(ctxt)

registering macro, not general purpose at all but used in different modules

ctxt : 

xsltXPathFunctionLookup ()

xmlXPathFunction xsltXPathFunctionLookup    (xmlXPathContextPtr ctxt,
+                                             const xmlChar *name,
+                                             const xmlChar *ns_uri);

This is the entry point when a function is needed by the XPath +interpretor.

ctxt : a void * but the XSLT transformation context actually
name : the function name
ns_uri : the function namespace URI
Returns :the callback function or NULL if not found

Name

Synopsis

Description

Details

a macro to import pointers from the stylesheet cascading order

a macro to import intergers from the stylesheet cascading order

Name

Synopsis

Description

Details

Name

Synopsis

Description

Details

Name

Synopsis

Description

Details

Name

Synopsis

Description

Details

Data structure used for the implementation of patterns. +It is kept private (in pattern.c)

Name

Synopsis

Description

Details

Name

Synopsis

xsltGetXIncludeDefault (void); +xsltTransformContextPtr xsltNewTransformContext + (xsltStylesheetPtr style, + xmlDocPtr doc); +void xsltFreeTransformContext (xsltTransformContextPtr ctxt); +xmlDocPtr xsltApplyStylesheetUser (xsltStylesheetPtr style, + xmlDocPtr doc, + const char **params, + const char *output, + FILE *profile, + xsltTransformContextPtr userCtxt); +xsltTransformFunction xsltExtElementLookup (xsltTransformContextPtr ctxt, + const xmlChar *name, + const xmlChar *URI); xmlDocPtr

Description

Details

xsltNewTransformContext ()

xsltTransformContextPtr xsltNewTransformContext
+                                            (xsltStylesheetPtr style,
+                                             xmlDocPtr doc);

Create a new XSLT TransformContext

style : a parsed XSLT stylesheet
doc : the input document
Returns :the newly allocated xsltTransformContextPtr or NULL in case of error

xsltFreeTransformContext ()

void        xsltFreeTransformContext        (xsltTransformContextPtr ctxt);

Free up the memory allocated by ctxt

ctxt : an XSLT parser context

xsltApplyStylesheetUser ()

xmlDocPtr   xsltApplyStylesheetUser         (xsltStylesheetPtr style,
+                                             xmlDocPtr doc,
+                                             const char **params,
+                                             const char *output,
+                                             FILE *profile,
+                                             xsltTransformContextPtr userCtxt);

Apply the stylesheet to the document and allow the user to provide +its own transformation context.

style : a parsed XSLT stylesheet
doc : a parsed XML document
params : a NULL terminated arry of parameters names/values tuples
output : the targetted output
profile : profile FILE * output or NULL
userCtxt : user provided transform context
Returns :the result document or NULL in case of error

xsltExtElementLookup ()

xsltTransformFunction xsltExtElementLookup  (xsltTransformContextPtr ctxt,
+                                             const xmlChar *name,
+                                             const xmlChar *URI);

Looks up an extension element. ctxt can be NULL to search only in +module elements.

ctxt : an XSLT process context
name : the element name
URI : the element namespace URI
Returns :the element callback or NULL if not found

Name

Synopsis

xsltTransformContextPtr ctxt, const char **params); +int xsltQuoteUserParams (xsltTransformContextPtr ctxt, + const char **params); +int xsltEvalOneUserParam (xsltTransformContextPtr ctxt, + const xmlChar *name, + const xmlChar *value); +int xsltQuoteOneUserParam (xsltTransformContextPtr ctxt, + const xmlChar *name, + const xmlChar *value); void xsltParseGlobalVariable

Description

Details

registering macro, not general purpose at all but used in different modules

ctxt: the XSLT transformation context +params: a NULL terminated array of parameters name/value tuples

Evaluate the global variables of a stylesheet. This needs to be -done on parsed stylesheets before starting to apply transformations

the XSLT transformation context  a NULL terminated arry of parameters names/values tuples 

xsltQuoteUserParams ()

int         xsltQuoteUserParams             (xsltTransformContextPtr ctxt,
+                                             const char **params);

ctxt: the XSLT transformation context +params: a NULL terminated arry of parameters names/values tuples

Similar to xsltEvalUserParams, but the values are treated literally and +are * *not* evaluated as XPath expressions. This should be done on parsed +stylesheets before starting to apply transformations.

ctxt : 
params : 
Returns :0 in case of success, -1 in case of error.

xsltEvalOneUserParam ()

int         xsltEvalOneUserParam            (xsltTransformContextPtr ctxt,
+                                             const xmlChar *name,
+                                             const xmlChar *value);

ctxt: the XSLT transformation context +name: a null terminated string giving the name of the parameter +value a null terminated string giving the XPath expression to be evaluated

This is normally called from xsltEvalUserParams to process a single +parameter from a list of parameters. The value is evaluated as an +XPath expression and the result is stored in the context's global +variable/parameter hash table.

To have a parameter treated literally (not as an XPath expression) +use xsltQuoteUserParams (or xsltQuoteOneUserParam). For more +details see description of xsltProcessOneUserParamInternal.

ctxt : 
name : 
value : 
Returns :0 in case of success, -1 in case of error.

xsltQuoteOneUserParam ()

int         xsltQuoteOneUserParam           (xsltTransformContextPtr ctxt,
+                                             const xmlChar *name,
+                                             const xmlChar *value);

ctxt: the XSLT transformation context +name: a null terminated string giving the name of the parameter +value a null terminated string giving the parameter value

This is normally called from xsltQuoteUserParams to process a single +parameter from a list of parameters. The value is stored in the +context's global variable/parameter hash table.

ctxt : 
name : 
value : 
Returns :0 in case of success, -1 in case of error.

xsltLibxmlVersion;; +void xsltCleanupGlobals (void);

Description

Details

The default version of XSLT supported

The XSLT "vendor" string for this processor

The XSLT "vendor" URL for this processor

The XSLT specification namespace

This value is used to detect templates loops

The version string for libxslt

The version of libxslt compiled

The version of libxml libxslt was compiled against

xsltCleanupGlobals ()

void        xsltCleanupGlobals              (void);

Unregister all global variables set up by the XSLT library

Name

Synopsis

xsltTransformContextPtr; struct xsltStylePreComp; -typedef xsltStylePreCompPtrxsltElemPreComp; +typedef xsltElemPreCompPtr (); void (*xsltTransformFunctionxmlNodePtr inst, xsltStylePreCompPtrxsltElemPreCompPtr comp); enum xsltStyleType; +void (*xsltElemPreCompDeallocator) (xsltElemPreCompPtr comp); +struct xsltStylePreComp; +typedef xsltStylePreCompPtr; struct xsltStackElemxmlChar **result); **result); +void xsltParseTemplateContent (xsltStylesheetPtr style, + xmlNodePtr templ);

Description

Details

Max number of specified xsl:sort on an element

specific value for pattern without priority expressed

The in-memory structure corresponding to an XSLT Template

Data structure of decimal-format

Data structure associated to a parsed document

struct xsltStylePreComp

struct xsltElemPreComp

struct xsltStylePreComp {
-    struct _xsltStylePreComp *next;/* chained list */
-    xsltStyleType type;		/* type of the element */
-    xsltTransformFunction func; /* handling function */
-    xmlNodePtr inst;		/* the instruction */
+>struct xsltElemPreComp {
+    xsltElemPreCompPtr next;		/* chained list */
+    xsltStyleType type;			/* type of the element */
+    xsltTransformFunction func; 	/* handling function */
+    xmlNodePtr inst;			/* the instruction */
 
-    /*
-     * Pre computed values
-     */
-
-    xmlChar *stype;             /* sort */
-    int      has_stype;		/* sort */
-    int      number;		/* sort */
-    xmlChar *order;             /* sort */
-    int      has_order;		/* sort */
-    int      descending;	/* sort */
-
-    xmlChar *use;		/* copy, element */
-    int      has_use;		/* copy, element */
-
-    int      noescape;		/* text */
-
-    xmlChar *name;		/* element, attribute, pi */
-    int      has_name;		/* element, attribute, pi */
-    xmlChar *ns;		/* element */
-    int      has_ns;		/* element */
-
-    xmlChar *mode;		/* apply-templates */
-    xmlChar *modeURI;		/* apply-templates */
-
-    xmlChar *test;		/* if */
-
-    xsltTemplatePtr templ;	/* call-template */
-
-    xmlChar *select;		/* sort, copy-of, value-of, apply-templates */
-
-    int      ver11;		/* document */
-    xmlChar *filename;		/* document URL */
-    int      has_filename;	/* document */
-
-    xsltNumberData numdata;	/* number */
-
-    xmlXPathCompExprPtr comp;	/* a precompiled XPath expression */
-    xmlNsPtr *nsList;		/* the namespaces in scope */
-    int nsNr;			/* the number of namespaces in scope */
+    /* end of common part */
+    xsltElemPreCompDeallocator free;	/* the deallocator */
 };

The in-memory structure corresponding to element precomputed data, +designed to be extended by extension implementors.

xsltStylePreCompPtr

xsltElemPreCompPtr ()

typedef xsltStylePreComp *xsltStylePreCompPtr;
typedef xsltElemPreCompPtr ();

Returns : 

xmlNodePtr inst, xsltStylePreCompPtrxsltElemPreCompPtr comp);

signature of the function associated to elements part of the +stylesheet language like xsl:if or xsl:apply-templates.

  the XSLT transformation context  the input node  the stylesheet node  the compiled information from the stylesheet

xsltElemPreCompDeallocator ()

void        (*xsltElemPreCompDeallocator)   (xsltElemPreCompPtr comp);

Deallocates an xsltElemPreComp structure

comp : the xsltElemPreComp to free up

struct xsltStylePreComp

struct xsltStylePreComp {
+    xsltElemPreCompPtr next;	/* chained list */
+    xsltStyleType type;		/* type of the element */
+    xsltTransformFunction func; /* handling function */
+    xmlNodePtr inst;		/* the instruction */
+
+    /*
+     * Pre computed values
+     */
+
+    xmlChar *stype;             /* sort */
+    int      has_stype;		/* sort */
+    int      number;		/* sort */
+    xmlChar *order;             /* sort */
+    int      has_order;		/* sort */
+    int      descending;	/* sort */
+
+    xmlChar *use;		/* copy, element */
+    int      has_use;		/* copy, element */
+
+    int      noescape;		/* text */
+
+    xmlChar *name;		/* element, attribute, pi */
+    int      has_name;		/* element, attribute, pi */
+    xmlChar *ns;		/* element */
+    int      has_ns;		/* element */
+
+    xmlChar *mode;		/* apply-templates */
+    xmlChar *modeURI;		/* apply-templates */
+
+    xmlChar *test;		/* if */
+
+    xsltTemplatePtr templ;	/* call-template */
+
+    xmlChar *select;		/* sort, copy-of, value-of, apply-templates */
+
+    int      ver11;		/* document */
+    xmlChar *filename;		/* document URL */
+    int      has_filename;	/* document */
+
+    xsltNumberData numdata;	/* number */
+
+    xmlXPathCompExprPtr comp;	/* a precompiled XPath expression */
+    xmlNsPtr *nsList;		/* the namespaces in scope */
+    int nsNr;			/* the number of namespaces in scope */
+};

The in-memory structure corresponding to XSLT stylesheet constructs +precomputed data.

xsltStylePreCompPtr

typedef xsltStylePreComp *xsltStylePreCompPtr;

Macro to check if the XSLT processing should be stopped +will return from the function

Macro to check if the XSLT processing should be stopped +will goto the error: label

Macro to check if the XSLT processing should be stopped +will return from the function with a 0 value

xsltParseTemplateContent ()

void        xsltParseTemplateContent        (xsltStylesheetPtr style,
+                                             xmlNodePtr templ);

parse a template content-model +Clean-up the template content from unwanted ignorable blank nodes +and process xslt:text

style : the XSLT stylesheet
templ : the container node (can be a document for literal results)

Name

Synopsis

IS_XSLT_NAME (n, val) +#define IS_XSLT_REAL_NODE (n) xmlCharxmlChar *nameSpace); -extern xmlGenericErrorFunc xsltGenericError; -extern void *xsltGenericErrorContext; -extern xmlGenericErrorFunc xsltGenericDebug; -extern void *xsltGenericDebugContext; void xsltPrintErrorContext

Description

Details

macro to flag unimplemented blocks

macro to flag that a problem was detected internally

Checks that the element pertains to XSLt namespace

Checks the value of an element in XSLT namespace

IS_XSLT_REAL_NODE()

#define     IS_XSLT_REAL_NODE(n)

check that a node is a 'real' one: document, element, text or attribute

n : 

xsltGenericError

extern xmlGenericErrorFunc xsltGenericError;

xsltGenericErrorContext

extern void *xsltGenericErrorContext;

xsltGenericDebug

extern xmlGenericErrorFunc xsltGenericDebug;

xsltGenericDebugContext

extern void *xsltGenericDebugContext;

Changelog file for a really accurate description

+

1.0.4: Sep 12 2001

+
    +
  • Documentation updates from John fleck
    • +
  • bug fixes (DocBook FO generation should be fixed) and portability + improvements
    • +
  • Thomas Broyer improved the existing EXSLT support and added String, + Time and Date core functions support
    • +
+

1.0.3: Aug 23 2001

  • XML Catalog support see the doc
    • diff --git a/libxslt/xsltwin32config.h b/libxslt/xsltwin32config.h index 4252831..b1024e7 100644 --- a/libxslt/xsltwin32config.h +++ b/libxslt/xsltwin32config.h @@ -21,21 +21,21 @@ extern "C" { * * the version string like "1.2.3" */ -#define LIBXSLT_DOTTED_VERSION "1.0.3" +#define LIBXSLT_DOTTED_VERSION "1.0.4" /** * LIBXSLT_VERSION: * * the version number: 1.2.3 value is 1002003 */ -#define LIBXSLT_VERSION 10003 +#define LIBXSLT_VERSION 10004 /** * LIBXSLT_VERSION_STRING: * * the version number string, 1.2.3 value is "1002003" */ -#define LIBXSLT_VERSION_STRING "10003" +#define LIBXSLT_VERSION_STRING "10004" /** * WITH_XSLT_DEBUG: -- 2.7.4