Commit a65da37d by Jonathan Wakely

basic_string.h, [...]: Fix Doxygen comments that use wrong parameter and function names.

	* include/bits/basic_string.h, include/bits/locale_facets.h: Fix
	Doxygen comments that use wrong parameter and function names.

From-SVN: r101419
parent 7d31a1f4
2005-06-29 Jonathan Wakely <redi@gcc.gnu.org>
* include/bits/basic_string.h, include/bits/locale_facets.h: Fix
Doxygen comments that use wrong parameter and function names.
2005-06-29 Paolo Carlini <pcarlini@suse.de>
* docs/html/ext/lwg-active.html, lwg-defects.html: Import Revision 37.
......
......@@ -404,7 +404,7 @@ namespace std
basic_string();
/**
* @brief Construct an empty string using allocator a.
* @brief Construct an empty string using allocator @a a.
*/
explicit
basic_string(const _Alloc& __a);
......@@ -439,7 +439,7 @@ namespace std
* @param n Number of characters to copy.
* @param a Allocator to use (default is default allocator).
*
* NB: s must have at least n characters, '\0' has no special
* NB: @a s must have at least @a n characters, '\0' has no special
* meaning.
*/
basic_string(const _CharT* __s, size_type __n,
......@@ -636,8 +636,8 @@ namespace std
/**
* @brief Attempt to preallocate enough memory for specified number of
* characters.
* @param n Number of characters required.
* @throw std::length_error If @a n exceeds @c max_size().
* @param res_arg Number of characters required.
* @throw std::length_error If @a res_arg exceeds @c max_size().
*
* This function attempts to reserve enough memory for the
* %string to hold the specified number of characters. If the
......@@ -670,7 +670,7 @@ namespace std
// Element access:
/**
* @brief Subscript access to the data contained in the %string.
* @param n The index of the character to access.
* @param pos The index of the character to access.
* @return Read-only (constant) reference to the character.
*
* This operator allows for easy, array-style, data access.
......@@ -687,7 +687,7 @@ namespace std
/**
* @brief Subscript access to the data contained in the %string.
* @param n The index of the character to access.
* @param pos The index of the character to access.
* @return Read/write reference to the character.
*
* This operator allows for easy, array-style, data access.
......@@ -765,7 +765,7 @@ namespace std
/**
* @brief Append a character.
* @param s The character to append.
* @param c The character to append.
* @return Reference to this string.
*/
basic_string&
......@@ -1204,15 +1204,15 @@ namespace std
* @brief Replace characters with value of a C substring.
* @param pos Index of first character to replace.
* @param n1 Number of characters to be replaced.
* @param str C string to insert.
* @param n2 Number of characters from str to use.
* @param s C string to insert.
* @param n2 Number of characters from @a s to use.
* @return Reference to this string.
* @throw std::out_of_range If @a pos1 > size().
* @throw std::length_error If new length exceeds @c max_size().
*
* Removes the characters in the range [pos,pos + n1) from this string.
* In place, the first @a n2 characters of @a str are inserted, or all
* of @a str if @a n2 is too large. If @a pos is beyond end of string,
* In place, the first @a n2 characters of @a s are inserted, or all
* of @a s if @a n2 is too large. If @a pos is beyond end of string,
* out_of_range is thrown. If the length of result exceeds max_size(),
* length_error is thrown. The value of the string doesn't change if
* an error is thrown.
......@@ -1225,13 +1225,13 @@ namespace std
* @brief Replace characters with value of a C string.
* @param pos Index of first character to replace.
* @param n1 Number of characters to be replaced.
* @param str C string to insert.
* @param s C string to insert.
* @return Reference to this string.
* @throw std::out_of_range If @a pos > size().
* @throw std::length_error If new length exceeds @c max_size().
*
* Removes the characters in the range [pos,pos + n1) from this string.
* In place, the first @a n characters of @a str are inserted. If @a
* In place, the first @a n characters of @a s are inserted. If @a
* pos is beyond end of string, out_of_range is thrown. If the length
* of result exceeds max_size(), length_error is thrown. The value of
* the string doesn't change if an error is thrown.
......
......@@ -1950,7 +1950,7 @@ namespace std
* @brief Numeric parsing.
*
* Parses the input stream into the bool @a v. It does so by calling
* num_put::do_put().
* num_get::do_get().
*
* If ios_base::boolalpha is set, attempts to read
* ctype<CharT>::truename() or ctype<CharT>::falsename(). Sets
......@@ -1979,7 +1979,7 @@ namespace std
* @brief Numeric parsing.
*
* Parses the input stream into the integral variable @a v. It does so
* by calling num_put::do_put().
* by calling num_get::do_get().
*
* Parsing is affected by the flag settings in @a io.
*
......@@ -2043,7 +2043,7 @@ namespace std
* @brief Numeric parsing.
*
* Parses the input stream into the integral variable @a v. It does so
* by calling num_put::do_put().
* by calling num_get::do_get().
*
* The input characters are parsed like the scanf %g specifier. The
* matching type length modifier is also used.
......@@ -2084,7 +2084,7 @@ namespace std
* @brief Numeric parsing.
*
* Parses the input stream into the pointer variable @a v. It does so
* by calling num_put::do_put().
* by calling num_get::do_get().
*
* The input characters are parsed like the scanf %p specifier.
*
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment