httpd-apreq-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Philip M. Gollucci" <pgollu...@p6m7g8.com>
Subject Re: 2.06-dev-rc2 (was Re: 2.0.6-dev [docs preview])
Date Wed, 13 Jul 2005 08:58:35 GMT
Philip M. Gollucci wrote:
> Philip M. Gollucci wrote:
> 
>> Philip M. Gollucci wrote:
>>
>>>
>>>> Cool.  I just posted rc2 in the usual place
>>>>
>>>>    http://people.apache.org/~joes/libapreq2-2.06-dev.rc2.tar.gz
> Next up, I'll try to fix some of the 10million warnings during the 
> genration of docs.
> 

With the attached patch, all the remaining doxygen warnings/errors come 
from externally used projects or "not documented" (I take it we should 
fix those).  For reference a list of these is below the patch.  I'll 
look at documenting them later in the week. This patch(also attached) 
fixes the following errors/warnings:

/usr/local/dev/repos/ASF/httpd/apreq/trunk/CHANGES:2: Warning: Found 
unknown command `\brief'

/usr/local/dev/repos/ASF/httpd/apreq/trunk/CHANGES:366: Warning: End of 
list marker found has invalid indent level

/usr/local/dev/repos/ASF/httpd/apreq/trunk/include/apreq_module.h:421:Warning: 
argument `key' of command @param is not found in the argument list of 
apreq_cookie(req, name)

svn diff
Index: CHANGES
===================================================================
--- CHANGES     (revision 216120)
+++ CHANGES     (working copy)
@@ -1,5 +1,5 @@
  /** @page apreq_changes CHANGES
-@brief List of major changes.
+//! brief List of major changes.


  @section v2_06 Changes with libapreq2-2.06
@@ -362,7 +362,7 @@
    apreq_jar_t and added args_status field to apreq_request_t. Parsers
    also must return their public status code when a NULL brigade is passed.
    apreq_hook_disable_uploads() is also added.
-  .
+
    This is an ABI change affecting all versions of libapreq2 prior to 
2.0.12.

  - Perl API [joes]

Index: /usr/local/dev/repos/ASF/httpd/apreq/trunk/include/apreq_module.h
===================================================================
--- /usr/local/dev/repos/ASF/httpd/apreq/trunk/include/apreq_module.h 
(revision 216120)
+++ /usr/local/dev/repos/ASF/httpd/apreq/trunk/include/apreq_module.h 
(working copy)
@@ -423,7 +423,7 @@
   * The match is case-insensitive.
   *
   * @param req request handle.
- * @param key desired cookie name
+ * @param name desired cookie name
   *
   * @return The first matching parameter (with args searched first) or 
NULL.
   */


/include/apreq.h:41: Warning: Member APREQ_DECLARE_NONSTD(d) of file 
apreq.h is not documented.
/include/apreq.h:42: Warning: Member APREQ_DECLARE_DATA of file apreq.h 
is not documented.
/include/apreq.h:49: Warning: Member APREQ_DEFAULT_READ_BLOCK_SIZE of 
file apreq.h is not documented.
/include/apreq.h:50: Warning: Member APREQ_DEFAULT_READ_LIMIT of file 
apreq.h is not documented.
/include/apreq.h:51: Warning: Member APREQ_DEFAULT_BRIGADE_LIMIT of file 
apreq.h is not documented.
/include/apreq.h:52: Warning: Member APREQ_DEFAULT_NELTS of file apreq.h 
is not documented.
/include/apreq.h:56: Warning: Member APREQ_FLAGS_OFF(f, name) of file 
apreq.h is not documented.
/include/apreq.h:57: Warning: Member APREQ_FLAGS_ON(f, name) of file 
apreq.h is not documented.
/include/apreq.h:58: Warning: Member APREQ_FLAGS_GET(f, name) of file 
apreq.h is not documented.
/include/apreq.h:61: Warning: Member APREQ_FLAGS_SET(f, name, value) of 
file apreq.h is not documented.
/include/apreq.h:64: Warning: Member APREQ_CHARSET_BIT of file apreq.h 
is not documented.
/include/apreq.h:65: Warning: Member APREQ_CHARSET_MASK of file apreq.h 
is not documented.
/include/apreq.h:67: Warning: Member APREQ_TAINTED_BIT of file apreq.h 
is not documented.
/include/apreq.h:68: Warning: Member APREQ_TAINTED_MASK of file apreq.h 
is not documented.
/include/apreq.h:70: Warning: Member APREQ_COOKIE_VERSION_BIT of file 
apreq.h is not documented.
/include/apreq.h:71: Warning: Member APREQ_COOKIE_VERSION_MASK of file 
apreq.h is not documented.
/include/apreq.h:73: Warning: Member APREQ_COOKIE_SECURE_BIT of file 
apreq.h is not documented.
/include/apreq.h:74: Warning: Member APREQ_COOKIE_SECURE_MASK of file 
apreq.h is not documented.
/include/apreq.h:119: Warning: Member apreq_attr_to_type(T, A, P) of 
file apreq.h is not documented.
/include/apreq.h:115: Warning: Member apreq_value_table_add(const 
apreq_value_t *v, apr_table_t *t) of file apreq.h is not documented.
/include/apreq_error.h:43: Warning: Member APR_EBADARG of file 
apreq_error.h is not documented.
/module/apache2/apreq_module_apache2.h:142: Warning: Member 
APREQ_FILTER_NAME of group mod_apreq2 is not documented.
/module/apache2/apreq_module_apache2.h:143: Warning: Member 
APREQ_APACHE2_MMN of group mod_apreq2 is not documented

~ 


-- 
END
------------------------------------------------------------
     What doesn't kill us can only make us stronger.
                 Nothing is impossible.
				
Philip M. Gollucci (pgollucci@p6m7g8.com) 301.254.5198
Consultant / http://p6m7g8.net/Resume/
Senior Developer / Liquidity Services, Inc.
   http://www.liquidityservicesinc.com
        http://www.liquidation.com
        http://www.uksurplus.com
        http://www.govliquidation.com
        http://www.gowholesale.com


Mime
View raw message