[asterisk-commits] eliel: branch group/appdocsxml r137402 - in /team/group/appdocsxml: include/a...
SVN commits to the Asterisk project
asterisk-commits at lists.digium.com
Wed Aug 13 08:39:17 CDT 2008
Author: eliel
Date: Wed Aug 13 08:39:13 2008
New Revision: 137402
URL: http://svn.digium.com/view/asterisk?view=rev&rev=137402
Log:
- Documentation fixes, use \internal for static functions.
- Preprocessor fixes.
Modified:
team/group/appdocsxml/include/asterisk/xml.h
team/group/appdocsxml/main/pbx.c
team/group/appdocsxml/main/xml.c
Modified: team/group/appdocsxml/include/asterisk/xml.h
URL: http://svn.digium.com/view/asterisk/team/group/appdocsxml/include/asterisk/xml.h?view=diff&rev=137402&r1=137401&r2=137402
==============================================================================
--- team/group/appdocsxml/include/asterisk/xml.h (original)
+++ team/group/appdocsxml/include/asterisk/xml.h Wed Aug 13 08:39:13 2008
@@ -17,12 +17,14 @@
#ifndef _ASTERISK_XML_H
#define _ASTERISK_XML_H
-/*
- * Implementation specific code.
+/*! \file
+ * \brief Asterisk XML abstraction layer
*/
-#if defined(HAVE_LIBXML2) && !defined(AST_XML_IMPLEMENTATION)
+
+/* Implementation specific code. */
+#if defined(HAVE_LIBXML2) && !defined(AST_XML_H_IMPLEMENTATION)
/* AST_XML_IMPLEMENTATION must be defined if an XML implementation is available. */
-#define AST_XML_IMPLEMENTATION
+#define AST_XML_H_IMPLEMENTATION
/* libxml2 specific definitions */
#include <libxml/parser.h>
@@ -40,13 +42,11 @@
#define AST_XML_PARENT parent
#define AST_XML_NAME name
-#endif /* defined(HAVE_LIBXML2) && !defined(AST_XML_IMPLEMENTATION) */
+#endif /* defined(HAVE_LIBXML2) && !defined(AST_XML_H_IMPLEMENTATION) */
/* Compile this if we have a working XML implementation. */
-#ifdef AST_XML_IMPLEMENTATION
-#define AST_XML_DESCEND 0
-#define AST_XML_NO_DESCEND 1
+#ifdef AST_XML_H_IMPLEMENTATION
/*! \brief Initialize the XML library implementation.
* This function is used to setup everything needed
@@ -125,7 +125,7 @@
/* Features using ast_xml_ */
#define XML_DOCUMENTATION
-#endif /* AST_XML_IMPLEMENTATION */
+#endif /* AST_XML_H_IMPLEMENTATION */
#endif /* _ASTERISK_XML_H */
Modified: team/group/appdocsxml/main/pbx.c
URL: http://svn.digium.com/view/asterisk/team/group/appdocsxml/main/pbx.c?view=diff&rev=137402&r1=137401&r2=137402
==============================================================================
--- team/group/appdocsxml/main/pbx.c (original)
+++ team/group/appdocsxml/main/pbx.c Wed Aug 13 08:39:13 2008
@@ -287,7 +287,9 @@
#ifdef XML_DOCUMENTATION
#define DEFAULT_DOCUMENTATION_LANGUAGE "en_US"
+/*! \brief XML documentation language. */
static char documentation_language[80];
+/*! \brief XML documentation tree. */
static ast_xml_doc *documentation_tree = NULL;
#endif
@@ -2793,7 +2795,8 @@
#ifdef XML_DOCUMENTATION
-/*! \brief Get the application/function node for 'name' application/function with language 'language'
+/*! \internal
+ * \brief Get the application/function node for 'name' application/function with language 'language'
* if we don't find any, get the first application with 'name' no matter which language with.
* \param doc XML documentation tree structure.
* \param type 'application', 'function', ...
@@ -2836,7 +2839,8 @@
return node;
}
-/*! \brief Helper function used to build the syntax, it allocates the needed buffer (or reallocates it),
+/*! \internal
+ * \brief Helper function used to build the syntax, it allocates the needed buffer (or reallocates it),
* and based on the reverse value it makes use of fmt or fmtrev to print the parameter list inside the
* realloced buffer (syntax).
* \param reverse We are going backwards while generating the syntax?
@@ -2881,7 +2885,8 @@
ast_free(tmpfmt);
}
-/*! \brief Build the syntax for an application or a function.
+/*! \internal
+ * \brief Build the syntax for an application or a function.
* \param type 'application' or 'function' ?
* \param name Name of the application or function to build the syntax.
* \retval NULL on error.
@@ -3062,7 +3067,8 @@
#undef GOTONEXT
}
-/*! \brief Parse a <para> element.
+/*! \internal
+ * \brief Parse a <para> element.
* \param node The <para> element pointer.
* \param tabs Added this string before the content of the <para> element.
* \param posttabs Added this string after the content of the <para> element.
@@ -3095,7 +3101,8 @@
return 1;
}
-/*! \brief Parse a <variable> node inside a <variablelist> node.
+/*! \internal
+ * \brief Parse a <variable> node inside a <variablelist> node.
* \param node The variable node to parse.
* \param tabs A string to be appended at the begining of the output that will be stored
* in buffer.
@@ -3146,7 +3153,8 @@
}
-/*! \brief Parse a <variablelist> node and put all the output inside 'buffer'.
+/*! \internal
+ * \brief Parse a <variablelist> node and put all the output inside 'buffer'.
* \param node The variablelist node pointer.
* \param tabs A string to be appended at the begining of the output that will be stored
* in buffer.
@@ -3194,7 +3202,8 @@
return 1;
}
-/*! \brief Return the string within a node formatted with
+/*! \internal
+ * \brief Return the string within a node formatted with
* <para> and <variablelist> elements.
* \param node Parent node where content resides.
* \param raw If set, return the node's content without further processing.
@@ -3230,7 +3239,8 @@
return ret;
}
-/*! \brief Get the content of a field (synopsis, description, etc) from an asterisk document tree
+/*! \internal
+ * \brief Get the content of a field (synopsis, description, etc) from an asterisk document tree
* \param type Type of element (application, function, ...).
* \param name Name of element (Dial, Echo, Playback, ...).
* \param var Name of field to return (synopsis, description, etc).
Modified: team/group/appdocsxml/main/xml.c
URL: http://svn.digium.com/view/asterisk/team/group/appdocsxml/main/xml.c?view=diff&rev=137402&r1=137401&r2=137402
==============================================================================
--- team/group/appdocsxml/main/xml.c (original)
+++ team/group/appdocsxml/main/xml.c Wed Aug 13 08:39:13 2008
@@ -26,7 +26,8 @@
ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
-#ifdef HAVE_LIBXML2
+#if defined(HAVE_LIBXML2) && !defined(AST_XML_IMPLEMENTATION)
+#define AST_XML_IMPLEMENTATION
/* libxml2 ast_xml implementation. */
@@ -167,5 +168,5 @@
return (char *)xmlNodeListGetString(node->doc, node->children, 0);
}
-#endif /* HAVE_LIBXML2 */
+#endif /* defined(HAVE_LIBXML2) && !defined(AST_XML_IMPLEMENTATION) */
More information about the asterisk-commits
mailing list