diff options
author | dimitri <dimitri@afe2bf4a-e733-0410-8a33-86f594647bc7> | 2004-04-27 19:44:46 (GMT) |
---|---|---|
committer | dimitri <dimitri@afe2bf4a-e733-0410-8a33-86f594647bc7> | 2004-04-27 19:44:46 (GMT) |
commit | 9b0cf1e08f786c5fbc0583fdeecd9b6fefda2b76 (patch) | |
tree | 73dfea63810e8b2a57aee5b37ecd2f360c69f440 /doc/commands.doc | |
parent | 4088d90d9abafaa51250e55a5f48a787a921ed98 (diff) | |
download | Doxygen-9b0cf1e08f786c5fbc0583fdeecd9b6fefda2b76.zip Doxygen-9b0cf1e08f786c5fbc0583fdeecd9b6fefda2b76.tar.gz Doxygen-9b0cf1e08f786c5fbc0583fdeecd9b6fefda2b76.tar.bz2 |
Release-1.3.6-20040427
Diffstat (limited to 'doc/commands.doc')
-rw-r--r-- | doc/commands.doc | 25 |
1 files changed, 22 insertions, 3 deletions
diff --git a/doc/commands.doc b/doc/commands.doc index a7baae6..309a852 100644 --- a/doc/commands.doc +++ b/doc/commands.doc @@ -922,9 +922,28 @@ ALIASES = "english=\if english" \ \addindex \\param Starts a parameter description for a function parameter with name \<parameter-name\>. Followed by a description of the parameter. - The existence of the parameter is not checked. - The text of the paragraph has no special internal structure. All visual - enhancement commands may be used inside the paragraph. + The existence of the parameter is checked and a warning is given if + the documentation of this (or any other) parameter is missing or not + present in the function declaration or definition. + + The \\param command has an optional attribute specifying the direction + of the attribute. Possible values are "in" and "out". Here is an example + for the function memcpy: + \code +/*! + * Copies bytes from a source memory area to a destination memory area, + * where both areas may not overlap. + * @param[out] dest The memory area to copy to. + * @param[in] src The memory area to copy from. + * @param[in] n The number of bytes to copy + */ +void memcpy(void *dest, const void *src, size_t n); + \endcode + If a parameter is both input and output, use [in,out] as an attribute. + + The parameter description is a paragraph with no special internal structure. + All visual enhancement commands may be used inside the paragraph. + Multiple adjacent \\param commands will be joined into a single paragraph. Each parameter description will start on a new line. The \\param description ends when a blank line or some other |