diff options
author | rizzo <rizzo@f38db490-d61c-443f-a65b-d21fe96a405b> | 2006-12-15 14:33:59 +0000 |
---|---|---|
committer | rizzo <rizzo@f38db490-d61c-443f-a65b-d21fe96a405b> | 2006-12-15 14:33:59 +0000 |
commit | 5e8716ec8d1862952048e6cf28d77c5ddb2c7da8 (patch) | |
tree | a1042e7e9db851e3c9578f10b8ff648a78fa96c1 /include | |
parent | 3a4ba3f4b600b131295c37e0c0ad3f68e98671c2 (diff) |
small documentation improvements.
git-svn-id: http://svn.digium.com/svn/asterisk/trunk@48495 f38db490-d61c-443f-a65b-d21fe96a405b
Diffstat (limited to 'include')
-rw-r--r-- | include/asterisk/threadstorage.h | 14 |
1 files changed, 8 insertions, 6 deletions
diff --git a/include/asterisk/threadstorage.h b/include/asterisk/threadstorage.h index b5ad0b2b5..d087f81d0 100644 --- a/include/asterisk/threadstorage.h +++ b/include/asterisk/threadstorage.h @@ -162,13 +162,15 @@ void *ast_threadstorage_get(struct ast_threadstorage *ts, size_t init_size), void __ast_threadstorage_cleanup(void *); /*! - * \brief A dynamic length string + * A dynamic length string. This is just a C string prefixed by a length + * field. len reflects the actual space allocated, while the string is + * NUL-terminated as a regular C string. + * One should never declare a variable with this type, but only a pointer + * to it, and use ast_dynamic_str_create() to initialize it. */ struct ast_dynamic_str { - /* The current maximum length of the string */ - size_t len; - /* The string buffer */ - char str[0]; + size_t len; /*!< The current maximum length of the string */ + char str[0]; /*!< The string buffer */ }; /*! @@ -179,7 +181,7 @@ struct ast_dynamic_str { * \return This function returns a pointer to the dynamic string length. The * result will be NULL in the case of a memory allocation error. * - * /note The result of this function is dynamically allocated memory, and must + * \note The result of this function is dynamically allocated memory, and must * be free()'d after it is no longer needed. */ AST_INLINE_API( |