summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorWilliam A. Rowe Jr <wrowe@apache.org>2003-03-05 21:22:26 +0000
committerWilliam A. Rowe Jr <wrowe@apache.org>2003-03-05 21:22:26 +0000
commit26a1251cd50b032176c0c5d9bb6626c1a2b7bb52 (patch)
tree665a1cf9958bf86499a3a742b654fe391c3a5705 /docs
parent1f3331ec7ac24dc7dbefd1ffcd179c7a5f1fbfc0 (diff)
downloadapr-26a1251cd50b032176c0c5d9bb6626c1a2b7bb52.tar.gz
Rebalance our exposed headers such that everything is nested properly
between extern "C" blocks and doxygen blocks, that we never include other headers within our own header's extern "C" block, that we always tag the entire file contents for doxygen (within the APR_HEADER_H only-once block), and generally clean up doxygen so that it is all consistent and generates respectable (although not yet 'great') results. Major TODO after 0.9.2 releases; fill in the apr.h APR_HAVE/APR_HAS and apr_type_t documentation!!! git-svn-id: https://svn.apache.org/repos/asf/apr/apr/trunk@64397 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to 'docs')
-rw-r--r--docs/doxygen.conf13
1 files changed, 10 insertions, 3 deletions
diff --git a/docs/doxygen.conf b/docs/doxygen.conf
index 36b623264..2efb55476 100644
--- a/docs/doxygen.conf
+++ b/docs/doxygen.conf
@@ -13,14 +13,21 @@ EXPAND_ONLY_PREDEF=YES
# not sure why this doesn't work as EXPAND_AS_DEFINED, it should!
PREDEFINED="APR_DECLARE(x)=x" \
"APR_DECLARE_NONSTD(x)=x" \
+ "APR_DECLARE_DATA" \
+ "APR_POOL_DECLARE_ACCESSOR(x)=apr_pool_t* apr_##x##_pool_get (const apr_##x##_t *the##x)" \
+ "APR_DECLARE_INHERIT_SET(x)=apr_status_t apr_##x##_inherit_set(apr_##x##_t *the##x)" \
+ "APR_DECLARE_INHERIT_UNSET(x)=apr_status_t apr_##x##_inherit_unset(apr_##x##_t *the##x)" \
"APR_HAS_THREADS" \
+ "__attribute__(x)=" \
DOXYGEN=
OPTIMIZE_OUTPUT_FOR_C=YES
-FULL_PATH_NAMES=YES
+FULL_PATH_NAMES=NO
# some autoconf guru needs to make configure set this correctly...
-STRIP_FROM_PATH=/home/rbb/httpd-2.0/srclib/apr
+# in the meantime, simply listing the headers should be alright
+STRIP_FROM_PATH=/buildpath/apr
-EXCLUDE_PATTERNS="*/test/*" \
+EXCLUDE_PATTERNS="*/acconfig.h" \
+ "*/test/*" \
"*/arch/*"