1 Fix apr_hash_first() doxygen syntax.

     2 http://svn.apache.org/viewvc?view=revision&revision=829490

     3 

     4 Doxgen would generate html file with full Userland build path in name

     5 for this header.

     6 

     7 --- include/apr_hash.h	2009/10/25 03:52:40	829489

     8 +++ include/apr_hash.h	2009/10/25 04:12:21	829490

     9 @@ -122,16 +122,15 @@

    10   * @param p The pool to allocate the apr_hash_index_t iterator. If this

    11   *          pool is NULL, then an internal, non-thread-safe iterator is used.

    12   * @param ht The hash table

    13 + * @return The iteration state

    14   * @remark  There is no restriction on adding or deleting hash entries during

    15   * an iteration (although the results may be unpredictable unless all you do

    16   * is delete the current entry) and multiple iterations can be in

    17   * progress at the same time.

    18 - */

    19 -/**

    20 - * @example

    21   *

    22 - * <PRE>

    23 - * 

    24 + * @par Example:

    25 + *

    26 + * @code

    27   * int sum_values(apr_pool_t *p, apr_hash_t *ht)

    28   * {

    29   *     apr_hash_index_t *hi;

    30 @@ -143,7 +142,7 @@

    31   *     }

    32   *     return sum;

    33   * }

    34 - * </PRE>

    35 + * @endcode

    36   */

    37  APR_DECLARE(apr_hash_index_t *) apr_hash_first(apr_pool_t *p, apr_hash_t *ht);

    38