diff options
author | Garrett Rooney <rooneg@apache.org> | 2005-12-13 21:00:34 +0000 |
---|---|---|
committer | Garrett Rooney <rooneg@apache.org> | 2005-12-13 21:00:34 +0000 |
commit | 90ae5305f7f5321526f5765e08f55f7cec4a08ac (patch) | |
tree | a29ff2453a466b266dd9b82d439a36888672aae0 /include/apr_file_info.h | |
parent | c432f366b20756c2144cfd56c96a2b6188b566c9 (diff) | |
download | apr-90ae5305f7f5321526f5765e08f55f7cec4a08ac.tar.gz |
Clean up the documentation surrounding the APR_INCOMPLETE status code,
* include/apr_file_info.h
(apr_stat, apr_dir_read): Note that APR_INCOMPLETE can be returned, and
that if it is you can use the finfo->valid bitfield to determine which
parts of the finfo are filled in. Also break some overly long lines.
* include/apr_errno.h
(APR_STATUS_IS_INCOMPLETE): Update docs since this is no longer specific
to the xlate code.
* CHANGES: Note change.
git-svn-id: https://svn.apache.org/repos/asf/apr/apr/trunk@356615 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to 'include/apr_file_info.h')
-rw-r--r-- | include/apr_file_info.h | 14 |
1 files changed, 12 insertions, 2 deletions
diff --git a/include/apr_file_info.h b/include/apr_file_info.h index 4680caba2..bb417041e 100644 --- a/include/apr_file_info.h +++ b/include/apr_file_info.h @@ -224,8 +224,13 @@ struct apr_finfo_t { * @param finfo Where to store the information about the file, which is * never touched if the call fails. * @param fname The name of the file to stat. - * @param wanted The desired apr_finfo_t fields, as a bit flag of APR_FINFO_ values + * @param wanted The desired apr_finfo_t fields, as a bit flag of APR_FINFO_ + values * @param pool the pool to use to allocate the new file. + * + * @note If @c APR_INCOMPLETE is returned all the fields in @a finfo may + * not be filled in, and you need to check the @c finfo->valid bitmask + * to verify that what you're looking for is there. */ APR_DECLARE(apr_status_t) apr_stat(apr_finfo_t *finfo, const char *fname, apr_int32_t wanted, apr_pool_t *pool); @@ -255,9 +260,14 @@ APR_DECLARE(apr_status_t) apr_dir_close(apr_dir_t *thedir); /** * Read the next entry from the specified directory. * @param finfo the file info structure and filled in by apr_dir_read - * @param wanted The desired apr_finfo_t fields, as a bit flag of APR_FINFO_ values + * @param wanted The desired apr_finfo_t fields, as a bit flag of APR_FINFO_ + values * @param thedir the directory descriptor returned from apr_dir_open * @remark No ordering is guaranteed for the entries read. + * + * @note If @c APR_INCOMPLETE is returned all the fields in @a finfo may + * not be filled in, and you need to check the @c finfo->valid bitmask + * to verify that what you're looking for is there. */ APR_DECLARE(apr_status_t) apr_dir_read(apr_finfo_t *finfo, apr_int32_t wanted, apr_dir_t *thedir); |