Return-Path: Delivered-To: apmail-apache-cvs-archive@apache.org Received: (qmail 52754 invoked by uid 500); 23 Jul 2000 16:03:08 -0000 Mailing-List: contact apache-cvs-help@apache.org; run by ezmlm Precedence: bulk X-No-Archive: yes Reply-To: new-httpd@apache.org list-help: list-unsubscribe: list-post: Delivered-To: mailing list apache-cvs@apache.org Received: (qmail 52743 invoked by uid 500); 23 Jul 2000 16:03:08 -0000 Delivered-To: apmail-apache-2.0-cvs@apache.org Date: 23 Jul 2000 16:03:08 -0000 Message-ID: <20000723160308.52739.qmail@locus.apache.org> From: rbb@locus.apache.org To: apache-2.0-cvs@apache.org Subject: cvs commit: apache-2.0/src/lib/apr/include apr_mmap.h rbb 00/07/23 09:03:07 Modified: src/lib/apr/include apr_mmap.h Log: Update apr_mmap.h to use ScanDoc Revision Changes Path 1.12 +19 -33 apache-2.0/src/lib/apr/include/apr_mmap.h Index: apr_mmap.h =================================================================== RCS file: /home/cvs/apache-2.0/src/lib/apr/include/apr_mmap.h,v retrieving revision 1.11 retrieving revision 1.12 diff -u -r1.11 -r1.12 --- apr_mmap.h 2000/07/07 19:14:52 1.11 +++ apr_mmap.h 2000/07/23 16:03:07 1.12 @@ -64,6 +64,10 @@ extern "C" { #endif /* __cplusplus */ +/** + * @package APR MMAP library + */ + typedef struct ap_mmap_t ap_mmap_t; /* As far as I can tell the only really sane way to store an MMAP is as a * void * and a length. BeOS requires this area_id, but that's just a little @@ -81,47 +85,29 @@ }; /* Function definitions */ - -/* - -=head1 ap_status_t ap_mmap_create(ap_mmap_t **new, ap_file_t *file, ap_off_t offset) -B - - arg 1) The newly created mmap'ed file. - arg 2) The file turn into an mmap. - arg 3) The offset into the file to start the data pointer at. - arg 4) The size of the file - arg 5) The pool to use when creating the mmap. - -=cut +/** + * Create a new mmap'ed file out of an existing APR file. + * @param newmmap The newly created mmap'ed file. + * @param file The file turn into an mmap. + * @param offset The offset into the file to start the data pointer at. + * @param size The size of the file + * @param cntxt The pool to use when creating the mmap. */ ap_status_t ap_mmap_create(ap_mmap_t ** newmmap, ap_file_t *file, ap_off_t offset, ap_size_t size, ap_pool_t *cntxt); - -/* -=head1 ap_status_t ap_mmap_delete(ap_mmap_t *mmap) - -B - - arg 1) The mmap'ed file. - -=cut +/** + * Remove a mmap'ed. + * @param mmap The mmap'ed file. */ ap_status_t ap_mmap_delete(ap_mmap_t *mmap); - -/* - -=head1 ap_status_t ap_mmap_offset(void **addr, ap_mmap_t *mmap, ap_offset_t offset) - -B - - arg 1) The pointer to the offset specified. - arg 2) The mmap'ed file. - arg 3) The offset to move to. -=cut +/** + * Move the pointer into the mmap'ed file to the specified offset. + * @param addr The pointer to the offset specified. + * @param mmap The mmap'ed file. + * @param offset The offset to move to. */ ap_status_t ap_mmap_offset(void **addr, ap_mmap_t *mmap, ap_off_t offset);