diff options
Diffstat (limited to 'libstdc++-v3/include')
98 files changed, 465 insertions, 435 deletions
diff --git a/libstdc++-v3/include/backward/auto_ptr.h b/libstdc++-v3/include/backward/auto_ptr.h index 4554d7a..aa3213d 100644 --- a/libstdc++-v3/include/backward/auto_ptr.h +++ b/libstdc++-v3/include/backward/auto_ptr.h @@ -1,6 +1,6 @@ // auto_ptr implementation -*- C++ -*- -// Copyright (C) 2007, 2008, 2009 Free Software Foundation, Inc. +// Copyright (C) 2007, 2008, 2009, 2010 Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free // software; you can redistribute it and/or modify it under the @@ -171,8 +171,8 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * @brief Smart pointer dereferencing. * * If this %auto_ptr no longer owns anything, then this - * operation will crash. (For a smart pointer, "no longer owns - * anything" is the same as being a null pointer, and you know + * operation will crash. (For a smart pointer, <em>no longer owns + * anything</em> is the same as being a null pointer, and you know * what happens when you dereference one of those...) */ element_type& diff --git a/libstdc++-v3/include/backward/binders.h b/libstdc++-v3/include/backward/binders.h index 9b059ce..5145860 100644 --- a/libstdc++-v3/include/backward/binders.h +++ b/libstdc++-v3/include/backward/binders.h @@ -1,6 +1,6 @@ // Functor implementations -*- C++ -*- -// Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2009 +// Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2009, 2010 // Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free @@ -63,15 +63,16 @@ _GLIBCXX_BEGIN_NAMESPACE(std) /** @defgroup binders Binder Classes * @ingroup functors * - * Binders turn functions/functors with two arguments into functors with - * a single argument, storing an argument to be applied later. For - * example, a variable @c B of type @c binder1st is constructed from a - * functor @c f and an argument @c x. Later, B's @c operator() is called - * with a single argument @c y. The return value is the value of @c f(x,y). - * @c B can be "called" with various arguments (y1, y2, ...) and will in - * turn call @c f(x,y1), @c f(x,y2), ... + * Binders turn functions/functors with two arguments into functors + * with a single argument, storing an argument to be applied later. + * For example, a variable @c B of type @c binder1st is constructed + * from a functor @c f and an argument @c x. Later, B's @c + * operator() is called with a single argument @c y. The return + * value is the value of @c f(x,y). @c B can be @a called with + * various arguments (y1, y2, ...) and will in turn call @c + * f(x,y1), @c f(x,y2), ... * - * The function @c bind1st is provided to save some typing. It takes the + * The function @c bind1st is provided to save some typing. It takes the * function and an argument as parameters, and returns an instance of * @c binder1st. * @@ -79,11 +80,11 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * thing, but the stored argument is passed as the second parameter instead * of the first, e.g., @c bind2nd(std::minus<float>,1.3) will create a * functor whose @c operator() accepts a floating-point number, subtracts - * 1.3 from it, and returns the result. (If @c bind1st had been used, - * the functor would perform "1.3 - x" instead. + * 1.3 from it, and returns the result. (If @c bind1st had been used, + * the functor would perform <em>1.3 - x</em> instead. * * Creator-wrapper functions like @c bind1st are intended to be used in - * calling algorithms. Their return values will be temporary objects. + * calling algorithms. Their return values will be temporary objects. * (The goal is to not require you to type names like * @c std::binder1st<std::plus<int>> for declaring a variable to hold the * return value from @c bind1st(std::plus<int>,5). diff --git a/libstdc++-v3/include/bits/allocator.h b/libstdc++-v3/include/bits/allocator.h index 4522051..ddf48db 100644 --- a/libstdc++-v3/include/bits/allocator.h +++ b/libstdc++-v3/include/bits/allocator.h @@ -76,7 +76,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) }; /** - * @brief The "standard" allocator, as per [20.4]. + * @brief The @a standard allocator, as per [20.4]. * @ingroup allocators * * Further details: diff --git a/libstdc++-v3/include/bits/basic_ios.h b/libstdc++-v3/include/bits/basic_ios.h index ee1b646..ba06316 100644 --- a/libstdc++-v3/include/bits/basic_ios.h +++ b/libstdc++-v3/include/bits/basic_ios.h @@ -1,7 +1,7 @@ // Iostreams base classes -*- C++ -*- // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, -// 2006, 2007, 2008, 2009 +// 2006, 2007, 2008, 2009, 2010 // Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free @@ -106,7 +106,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * @brief The quick-and-easy status check. * * This allows you to write constructs such as - * "if (!a_stream) ..." and "while (a_stream) ..." + * <code>if (!a_stream) ...</code> and <code>while (a_stream) ...</code> */ operator void*() const { return this->fail() ? 0 : const_cast<basic_ios*>(this); } @@ -351,7 +351,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) copyfmt(const basic_ios& __rhs); /** - * @brief Retrieves the "empty" character. + * @brief Retrieves the @a empty character. * @return The current fill character. * * It defaults to a space (' ') in the current locale. @@ -368,7 +368,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) } /** - * @brief Sets a new "empty" character. + * @brief Sets a new @a empty character. * @param ch The new character. * @return The previous fill character. * diff --git a/libstdc++-v3/include/bits/basic_string.h b/libstdc++-v3/include/bits/basic_string.h index 0b166f3..b0f1810 100644 --- a/libstdc++-v3/include/bits/basic_string.h +++ b/libstdc++-v3/include/bits/basic_string.h @@ -79,7 +79,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * This approach has the enormous advantage that a string object * requires only one allocation. All the ugliness is confined * within a single pair of inline functions, which each compile to - * a single "add" instruction: _Rep::_M_data(), and + * a single @a add instruction: _Rep::_M_data(), and * string::_M_rep(); and the allocation function which gets a * block of raw bytes and with room enough and constructs a _Rep * object at the front. @@ -91,7 +91,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * string length.) * * Note that the _Rep object is a POD so that you can have a - * static "empty string" _Rep object already "constructed" before + * static <em>empty string</em> _Rep object already @a constructed before * static constructors have run. The reference-count encoding is * chosen so that a 0 indicates one reference, so you never try to * destroy the empty-string _Rep object. @@ -462,8 +462,8 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * @param n Number of characters to copy. * @param a Allocator to use (default is default allocator). * - * NB: @a s must have at least @a n characters, '\\0' has no special - * meaning. + * NB: @a s must have at least @a n characters, '\\0' + * has no special meaning. */ basic_string(const _CharT* __s, size_type __n, const _Alloc& __a = _Alloc()); @@ -786,7 +786,8 @@ _GLIBCXX_BEGIN_NAMESPACE(std) { _M_mutate(0, this->size(), 0); } /** - * Returns true if the %string is empty. Equivalent to *this == "". + * Returns true if the %string is empty. Equivalent to + * <code>*this == ""</code>. */ bool empty() const @@ -2241,8 +2242,8 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * result of the comparison is nonzero returns it, otherwise the shorter * one is ordered first. * - * NB: s must have at least n2 characters, '\\0' has no special - * meaning. + * NB: s must have at least n2 characters, '\\0' has + * no special meaning. */ int compare(size_type __pos, size_type __n1, const _CharT* __s, @@ -2627,11 +2628,12 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * @param str Buffer to store into. * @return Reference to the input stream. * - * Stores characters from is into @a str until '\n' is found, the end of - * the stream is encountered, or str.max_size() is reached. If is.width() - * is non-zero, that is the limit on the number of characters stored into - * @a str. Any previous contents of @a str are erased. If end of line was - * encountered, it is extracted but not stored into @a str. + * Stores characters from is into @a str until '\n' is + * found, the end of the stream is encountered, or str.max_size() + * is reached. If is.width() is non-zero, that is the limit on the + * number of characters stored into @a str. Any previous contents + * of @a str are erased. If end of line was encountered, it is + * extracted but not stored into @a str. */ template<typename _CharT, typename _Traits, typename _Alloc> inline basic_istream<_CharT, _Traits>& diff --git a/libstdc++-v3/include/bits/char_traits.h b/libstdc++-v3/include/bits/char_traits.h index 5e52c75..412e75a 100644 --- a/libstdc++-v3/include/bits/char_traits.h +++ b/libstdc++-v3/include/bits/char_traits.h @@ -1,7 +1,7 @@ // Character Traits for use by standard string and iostream -*- C++ -*- // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, -// 2006, 2007, 2008, 2009 +// 2006, 2007, 2008, 2009, 2010 // Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free @@ -83,7 +83,7 @@ _GLIBCXX_BEGIN_NAMESPACE(__gnu_cxx) * namespace __gnu_cxx may be. * * See http://gcc.gnu.org/onlinedocs/libstdc++/manual/bk01pt05ch13s03.html - * for advice on how to make use of this class for "unusual" character + * for advice on how to make use of this class for @a unusual character * types. Also, check out include/ext/pod_char_traits.h. */ template<typename _CharT> @@ -224,7 +224,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * appropriate definition by specializing __gnu_cxx::char_traits. * * See http://gcc.gnu.org/onlinedocs/libstdc++/manual/bk01pt05ch13s03.html - * for advice on how to make use of this class for "unusual" character + * for advice on how to make use of this class for @a unusual character * types. Also, check out include/ext/pod_char_traits.h. */ template<class _CharT> diff --git a/libstdc++-v3/include/bits/cpp_type_traits.h b/libstdc++-v3/include/bits/cpp_type_traits.h index afb0049..0d7b9ff 100644 --- a/libstdc++-v3/include/bits/cpp_type_traits.h +++ b/libstdc++-v3/include/bits/cpp_type_traits.h @@ -1,6 +1,6 @@ // The -*- C++ -*- type traits classes for internal use in libstdc++ -// Copyright (C) 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2009 +// Copyright (C) 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2009, 2010 // Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free @@ -136,8 +136,8 @@ _GLIBCXX_BEGIN_NAMESPACE(std) }; // Thirteen specializations (yes there are eleven standard integer - // types; 'long long' and 'unsigned long long' are supported as - // extensions) + // types; <em>long long</em> and <em>unsigned long long</em> are + // supported as extensions) template<> struct __is_integer<bool> { diff --git a/libstdc++-v3/include/bits/ios_base.h b/libstdc++-v3/include/bits/ios_base.h index 2badd4c..f1be6ae 100644 --- a/libstdc++-v3/include/bits/ios_base.h +++ b/libstdc++-v3/include/bits/ios_base.h @@ -1,7 +1,7 @@ // Iostreams base classes -*- C++ -*- // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, -// 2006, 2007, 2008, 2009 +// 2006, 2007, 2008, 2009, 2010 // Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free @@ -238,7 +238,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) /** * @brief This is a bitmask type. * - * @c "_Ios_Fmtflags" is implementation-defined, but it is valid to + * @c @a _Ios_Fmtflags is implementation-defined, but it is valid to * perform bitwise operations on these values and expect the Right * Thing to happen. Defined objects of type fmtflags are: * - boolalpha @@ -327,7 +327,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) /** * @brief This is a bitmask type. * - * @c "_Ios_Iostate" is implementation-defined, but it is valid to + * @c @a _Ios_Iostate is implementation-defined, but it is valid to * perform bitwise operations on these values and expect the Right * Thing to happen. Defined objects of type iostate are: * - badbit @@ -356,7 +356,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) /** * @brief This is a bitmask type. * - * @c "_Ios_Openmode" is implementation-defined, but it is valid to + * @c @a _Ios_Openmode is implementation-defined, but it is valid to * perform bitwise operations on these values and expect the Right * Thing to happen. Defined objects of type openmode are: * - app @@ -392,7 +392,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) /** * @brief This is an enumerated type. * - * @c "_Ios_Seekdir" is implementation-defined. Defined values + * @c @a _Ios_Seekdir is implementation-defined. Defined values * of type seekdir are: * - beg * - cur, equivalent to @c SEEK_CUR in the C standard library. @@ -618,7 +618,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * @brief Flags access. * @return The precision to generate on certain output operations. * - * Be careful if you try to give a definition of "precision" here; see + * Be careful if you try to give a definition of @a precision here; see * DR 189. */ streamsize @@ -642,7 +642,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * @brief Flags access. * @return The minimum field width to generate on output operations. * - * "Minimum field width" refers to the number of characters. + * <em>Minimum field width</em> refers to the number of characters. */ streamsize width() const diff --git a/libstdc++-v3/include/bits/locale_classes.h b/libstdc++-v3/include/bits/locale_classes.h index 7ae9c53..d966a31 100644 --- a/libstdc++-v3/include/bits/locale_classes.h +++ b/libstdc++-v3/include/bits/locale_classes.h @@ -1,7 +1,7 @@ // Locale support -*- C++ -*- // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, -// 2006, 2007, 2008, 2009 +// 2006, 2007, 2008, 2009, 2010 // Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free @@ -111,7 +111,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * @brief Default constructor. * * Constructs a copy of the global locale. If no locale has been - * explicitly set, this is the "C" locale. + * explicitly set, this is the C locale. */ locale() throw(); @@ -268,7 +268,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) global(const locale&); /** - * @brief Return reference to the "C" locale. + * @brief Return reference to the C locale. */ static const locale& classic(); @@ -641,7 +641,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * This is a constructor for use by the library itself to set up new * locales. * - * @param cloc The "C" locale. + * @param cloc The C locale. * @param refs Passed to the base facet class. */ explicit @@ -671,7 +671,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * * This function is a wrapper for strxfrm functionality. It takes the * input string and returns a modified string that can be directly - * compared to other transformed strings. In the "C" locale, this + * compared to other transformed strings. In the C locale, this * function just returns a copy of the input string. In some other * locales, it may replace two chars with one, change a char for * another, etc. It does so by returning collate::do_transform(). diff --git a/libstdc++-v3/include/bits/locale_facets.h b/libstdc++-v3/include/bits/locale_facets.h index 5dec0f4..b3f2139 100644 --- a/libstdc++-v3/include/bits/locale_facets.h +++ b/libstdc++-v3/include/bits/locale_facets.h @@ -1,7 +1,7 @@ // Locale support -*- C++ -*- // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, -// 2006, 2007, 2008, 2009 +// 2006, 2007, 2008, 2009, 2010 // Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free @@ -1680,7 +1680,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * This is a constructor for use by the library itself to set up new * locales. * - * @param cloc The "C" locale. + * @param cloc The C locale. * @param refs Refcount to pass to the base class. */ explicit diff --git a/libstdc++-v3/include/bits/locale_facets_nonio.h b/libstdc++-v3/include/bits/locale_facets_nonio.h index 525a533..b1d4c60 100644 --- a/libstdc++-v3/include/bits/locale_facets_nonio.h +++ b/libstdc++-v3/include/bits/locale_facets_nonio.h @@ -200,7 +200,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * This is a constructor for use by the library itself to set up new * locales. * - * @param cloc The "C" locale. + * @param cloc The C locale. * @param s The name of a locale. * @param refs Passed to the base facet class. */ @@ -387,8 +387,8 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * @brief Return preferred order of month, day, and year. * * This function returns an enum from timebase::dateorder giving the - * preferred ordering if the format "x" given to time_put::put() only - * uses month, day, and year. If the format "x" for the associated + * preferred ordering if the format @a x given to time_put::put() only + * uses month, day, and year. If the format @a x for the associated * locale uses other fields, this function returns * timebase::dateorder::noorder. * @@ -403,11 +403,11 @@ _GLIBCXX_BEGIN_NAMESPACE(std) /** * @brief Parse input time string. * - * This function parses a time according to the format "x" and puts the + * This function parses a time according to the format @a x and puts the * results into a user-supplied struct tm. The result is returned by * calling time_get::do_get_time(). * - * If there is a valid time string according to format "x", @a tm will + * If there is a valid time string according to format @a x, @a tm will * be filled in accordingly and the returned iterator will point to the * first character beyond the time string. If an error occurs before * the end, err |= ios_base::failbit. If parsing reads all the @@ -428,11 +428,11 @@ _GLIBCXX_BEGIN_NAMESPACE(std) /** * @brief Parse input date string. * - * This function parses a date according to the format "X" and puts the + * This function parses a date according to the format @a X and puts the * results into a user-supplied struct tm. The result is returned by * calling time_get::do_get_date(). * - * If there is a valid date string according to format "X", @a tm will + * If there is a valid date string according to format @a X, @a tm will * be filled in accordingly and the returned iterator will point to the * first character beyond the date string. If an error occurs before * the end, err |= ios_base::failbit. If parsing reads all the @@ -542,7 +542,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * @brief Return preferred order of month, day, and year. * * This function returns an enum from timebase::dateorder giving the - * preferred ordering if the format "x" given to time_put::put() only + * preferred ordering if the format @a x given to time_put::put() only * uses month, day, and year. This function is a hook for derived * classes to change the value returned. * @@ -554,7 +554,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) /** * @brief Parse input time string. * - * This function parses a time according to the format "x" and puts the + * This function parses a time according to the format @a x and puts the * results into a user-supplied struct tm. This function is a hook for * derived classes to change the value returned. @see get_time() for * details. @@ -573,7 +573,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) /** * @brief Parse input date string. * - * This function parses a date according to the format "X" and puts the + * This function parses a date according to the format @a X and puts the * results into a user-supplied struct tm. This function is a hook for * derived classes to change the value returned. @see get_date() for * details. @@ -972,7 +972,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * This is a constructor for use by the library itself to set up new * locales. * - * @param cloc The "C" locale. + * @param cloc The C locale. * @param s The name of a locale. * @param refs Passed to the base facet class. */ @@ -1022,10 +1022,11 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * string are required to group a number, the last char is used * repeatedly. * - * For example, if the grouping() returns "\003\002" and is applied to - * the number 123456789, this corresponds to 12,34,56,789. Note that - * if the string was "32", this would put more than 50 digits into the - * least significant group if the character set is ASCII. + * For example, if the grouping() returns <code>\003\002</code> + * and is applied to the number 123456789, this corresponds to + * 12,34,56,789. Note that if the string was <code>32</code>, this would + * put more than 50 digits into the least significant group if + * the character set is ASCII. * * The string is returned by calling * moneypunct<char_type>::do_grouping(). @@ -1124,9 +1125,10 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * present. * * For example, for the US locale and pos_format() pattern - * {symbol,sign,value,none}, curr_symbol() == '$' positive_sign() == - * '+', and value 10.01, and options set to force the symbol, the - * corresponding string is "$+10.01". + * {symbol,sign,value,none}, curr_symbol() == '$' + * positive_sign() == '+', and value 10.01, and + * options set to force the symbol, the corresponding string is + * <code>$+10.01</code>. * * @return Pattern for money values. */ @@ -1412,10 +1414,11 @@ _GLIBCXX_BEGIN_LDBL_NAMESPACE /** * @brief Read and parse a monetary value. * - * This function reads characters from @a s, interprets them as a - * monetary value according to moneypunct and ctype facets retrieved - * from io.getloc(), and returns the result in @a digits. For example, - * the string $10.01 in a US locale would store "1001" in @a digits. + * This function reads characters from @a s, interprets them as + * a monetary value according to moneypunct and ctype facets + * retrieved from io.getloc(), and returns the result in @a + * digits. For example, the string $10.01 in a US locale would + * store <code>1001</code> in @a digits. * * Any characters not part of a valid money amount are not consumed. * @@ -1531,7 +1534,7 @@ _GLIBCXX_BEGIN_LDBL_NAMESPACE * This function formats @a units as a monetary value according to * moneypunct and ctype facets retrieved from io.getloc(), and writes * the resulting characters to @a s. For example, the value 1001 in a - * US locale would write "$10.01" to @a s. + * US locale would write <code>$10.01</code> to @a s. * * This function works by returning the result of do_put(). * @@ -1550,10 +1553,11 @@ _GLIBCXX_BEGIN_LDBL_NAMESPACE /** * @brief Format and output a monetary value. * - * This function formats @a digits as a monetary value according to - * moneypunct and ctype facets retrieved from io.getloc(), and writes - * the resulting characters to @a s. For example, the string "1001" in - * a US locale would write "$10.01" to @a s. + * This function formats @a digits as a monetary value + * according to moneypunct and ctype facets retrieved from + * io.getloc(), and writes the resulting characters to @a s. + * For example, the string <code>1001</code> in a US locale + * would write <code>$10.01</code> to @a s. * * This function works by returning the result of do_put(). * @@ -1580,7 +1584,7 @@ _GLIBCXX_BEGIN_LDBL_NAMESPACE * This function formats @a units as a monetary value according to * moneypunct and ctype facets retrieved from io.getloc(), and writes * the resulting characters to @a s. For example, the value 1001 in a - * US locale would write "$10.01" to @a s. + * US locale would write <code>$10.01</code> to @a s. * * This function is a hook for derived classes to change the value * returned. @see put(). @@ -1606,10 +1610,11 @@ _GLIBCXX_BEGIN_LDBL_NAMESPACE /** * @brief Format and output a monetary value. * - * This function formats @a digits as a monetary value according to - * moneypunct and ctype facets retrieved from io.getloc(), and writes - * the resulting characters to @a s. For example, the string "1001" in - * a US locale would write "$10.01" to @a s. + * This function formats @a digits as a monetary value + * according to moneypunct and ctype facets retrieved from + * io.getloc(), and writes the resulting characters to @a s. + * For example, the string <code>1001</code> in a US locale + * would write <code>$10.01</code> to @a s. * * This function is a hook for derived classes to change the value * returned. @see put(). @@ -1709,7 +1714,7 @@ _GLIBCXX_END_LDBL_NAMESPACE * This is a constructor for use by the library itself to set up new * locales. * - * @param cloc The "C" locale. + * @param cloc The C locale. * @param s The name of a locale. * @param refs Refcount to pass to the base class. */ diff --git a/libstdc++-v3/include/bits/random.h b/libstdc++-v3/include/bits/random.h index 528a04a..3a53fe3 100644 --- a/libstdc++-v3/include/bits/random.h +++ b/libstdc++-v3/include/bits/random.h @@ -1340,8 +1340,8 @@ namespace std * The classic Mersenne Twister. * * Reference: - * M. Matsumoto and T. Nishimura, "Mersenne Twister: A 623-Dimensionally - * Equidistributed Uniform Pseudo-Random Number Generator", ACM Transactions + * M. Matsumoto and T. Nishimura, Mersenne Twister: A 623-Dimensionally + * Equidistributed Uniform Pseudo-Random Number Generator, ACM Transactions * on Modeling and Computer Simulation, Vol. 8, No. 1, January 1998, pp 3-30. */ typedef mersenne_twister_engine< diff --git a/libstdc++-v3/include/bits/random.tcc b/libstdc++-v3/include/bits/random.tcc index 4a8c4d8..ee92240 100644 --- a/libstdc++-v3/include/bits/random.tcc +++ b/libstdc++-v3/include/bits/random.tcc @@ -1140,7 +1140,7 @@ namespace std * is defined. * * Reference: - * Devroye, L. "Non-Uniform Random Variates Generation." Springer-Verlag, + * Devroye, L. Non-Uniform Random Variates Generation. Springer-Verlag, * New York, 1986, Ch. X, Sects. 3.3 & 3.4 (+ Errata!). */ template<typename _IntType> @@ -1372,7 +1372,7 @@ namespace std * is defined. * * Reference: - * Devroye, L. "Non-Uniform Random Variates Generation." Springer-Verlag, + * Devroye, L. Non-Uniform Random Variates Generation. Springer-Verlag, * New York, 1986, Ch. X, Sect. 4 (+ Errata!). */ template<typename _IntType> @@ -1589,7 +1589,7 @@ namespace std /** * Polar method due to Marsaglia. * - * Devroye, L. "Non-Uniform Random Variates Generation." Springer-Verlag, + * Devroye, L. Non-Uniform Random Variates Generation. Springer-Verlag, * New York, 1986, Ch. V, Sect. 4.4. */ template<typename _RealType> diff --git a/libstdc++-v3/include/bits/stl_algo.h b/libstdc++-v3/include/bits/stl_algo.h index f6c98f8..ed72656 100644 --- a/libstdc++-v3/include/bits/stl_algo.h +++ b/libstdc++-v3/include/bits/stl_algo.h @@ -1,6 +1,6 @@ // Algorithm implementation -*- C++ -*- -// Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 +// Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 // Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free @@ -2460,8 +2460,8 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * @param first An iterator. * @param last Another iterator. * @param val The search term. - * @return An iterator pointing to the first element "not less - * than" @a val, or end() if every element is less than + * @return An iterator pointing to the first element <em>not less + * than</em> @a val, or end() if every element is less than * @a val. * @ingroup binary_search_algorithms */ @@ -2509,8 +2509,9 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * @param last Another iterator. * @param val The search term. * @param comp A functor to use for comparisons. - * @return An iterator pointing to the first element "not less than" @a val, - * or end() if every element is less than @a val. + * @return An iterator pointing to the first element <em>not less + * than</em> @a val, or end() if every element is less + * than @a val. * @ingroup binary_search_algorithms * * The comparison function should have the same effects on ordering as @@ -3633,13 +3634,13 @@ _GLIBCXX_BEGIN_NAMESPACE(std) // max_element /** - * @brief Permute range into the next "dictionary" ordering. + * @brief Permute range into the next @a dictionary ordering. * @ingroup sorting_algorithms * @param first Start of range. * @param last End of range. * @return False if wrapped to first permutation, true otherwise. * - * Treats all permutations of the range as a set of "dictionary" sorted + * Treats all permutations of the range as a set of @a dictionary sorted * sequences. Permutes the current sequence into the next one of this set. * Returns true if there are more sequences to generate. If the sequence * is the largest of the set, the smallest is generated and false returned. @@ -3687,7 +3688,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) } /** - * @brief Permute range into the next "dictionary" ordering using + * @brief Permute range into the next @a dictionary ordering using * comparison functor. * @ingroup sorting_algorithms * @param first Start of range. @@ -3696,7 +3697,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * @return False if wrapped to first permutation, true otherwise. * * Treats all permutations of the range [first,last) as a set of - * "dictionary" sorted sequences ordered by @a comp. Permutes the current + * @a dictionary sorted sequences ordered by @a comp. Permutes the current * sequence into the next one of this set. Returns true if there are more * sequences to generate. If the sequence is the largest of the set, the * smallest is generated and false returned. @@ -3745,13 +3746,13 @@ _GLIBCXX_BEGIN_NAMESPACE(std) } /** - * @brief Permute range into the previous "dictionary" ordering. + * @brief Permute range into the previous @a dictionary ordering. * @ingroup sorting_algorithms * @param first Start of range. * @param last End of range. * @return False if wrapped to last permutation, true otherwise. * - * Treats all permutations of the range as a set of "dictionary" sorted + * Treats all permutations of the range as a set of @a dictionary sorted * sequences. Permutes the current sequence into the previous one of this * set. Returns true if there are more sequences to generate. If the * sequence is the smallest of the set, the largest is generated and false @@ -3800,7 +3801,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) } /** - * @brief Permute range into the previous "dictionary" ordering using + * @brief Permute range into the previous @a dictionary ordering using * comparison functor. * @ingroup sorting_algorithms * @param first Start of range. @@ -3809,7 +3810,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * @return False if wrapped to last permutation, true otherwise. * * Treats all permutations of the range [first,last) as a set of - * "dictionary" sorted sequences ordered by @a comp. Permutes the current + * @a dictionary sorted sequences ordered by @a comp. Permutes the current * sequence into the previous one of this set. Returns true if there are * more sequences to generate. If the sequence is the smallest of the set, * the largest is generated and false returned. @@ -5347,8 +5348,8 @@ _GLIBCXX_BEGIN_NESTED_NAMESPACE(std, _GLIBCXX_STD_P) * @param last1 Another iterator. * @param last2 Another iterator. * @param result An iterator pointing to the end of the merged range. - * @return An iterator pointing to the first element "not less - * than" @a val. + * @return An iterator pointing to the first element <em>not less + * than</em> @a val. * * Merges the ranges [first1,last1) and [first2,last2) into the sorted range * [result, result + (last1-first1) + (last2-first2)). Both input ranges diff --git a/libstdc++-v3/include/bits/stl_algobase.h b/libstdc++-v3/include/bits/stl_algobase.h index 5f6c648..8e756a4 100644 --- a/libstdc++-v3/include/bits/stl_algobase.h +++ b/libstdc++-v3/include/bits/stl_algobase.h @@ -995,7 +995,7 @@ _GLIBCXX_BEGIN_NESTED_NAMESPACE(std, _GLIBCXX_STD_P) } /** - * @brief Performs 'dictionary' comparison on ranges. + * @brief Performs @b dictionary comparison on ranges. * @ingroup sorting_algorithms * @param first1 An input iterator. * @param last1 An input iterator. @@ -1003,9 +1003,9 @@ _GLIBCXX_BEGIN_NESTED_NAMESPACE(std, _GLIBCXX_STD_P) * @param last2 An input iterator. * @return A boolean true or false. * - * 'Returns true if the sequence of elements defined by the range + * <em>Returns true if the sequence of elements defined by the range * [first1,last1) is lexicographically less than the sequence of elements - * defined by the range [first2,last2). Returns false otherwise.' + * defined by the range [first2,last2). Returns false otherwise.</em> * (Quoted from [25.3.8]/1.) If the iterators are all character pointers, * then this is an inline call to @c memcmp. */ @@ -1032,7 +1032,7 @@ _GLIBCXX_BEGIN_NESTED_NAMESPACE(std, _GLIBCXX_STD_P) } /** - * @brief Performs "dictionary" comparison on ranges. + * @brief Performs @b dictionary comparison on ranges. * @ingroup sorting_algorithms * @param first1 An input iterator. * @param last1 An input iterator. diff --git a/libstdc++-v3/include/bits/stl_deque.h b/libstdc++-v3/include/bits/stl_deque.h index 7e60b65..19022b0 100644 --- a/libstdc++-v3/include/bits/stl_deque.h +++ b/libstdc++-v3/include/bits/stl_deque.h @@ -69,12 +69,13 @@ _GLIBCXX_BEGIN_NESTED_NAMESPACE(std, _GLIBCXX_STD_D) * @param size The size of an element. * @return The number (not byte size) of elements per node. * - * This function started off as a compiler kludge from SGI, but seems to - * be a useful wrapper around a repeated constant expression. The '512' is - * tunable (and no other code needs to change), but no investigation has - * been done since inheriting the SGI code. Touch _GLIBCXX_DEQUE_BUF_SIZE - * only if you know what you are doing, however: changing it breaks the - * binary compatibility!! + * This function started off as a compiler kludge from SGI, but + * seems to be a useful wrapper around a repeated constant + * expression. The @b 512 is tunable (and no other code needs to + * change), but no investigation has been done since inheriting the + * SGI code. Touch _GLIBCXX_DEQUE_BUF_SIZE only if you know what + * you are doing, however: changing it breaks the binary + * compatibility!! */ #ifndef _GLIBCXX_DEQUE_BUF_SIZE @@ -650,14 +651,14 @@ _GLIBCXX_BEGIN_NESTED_NAMESPACE(std, _GLIBCXX_STD_D) * - iterator _M_start, _M_finish * * map_size is at least 8. %map is an array of map_size - * pointers-to-"nodes". (The name %map has nothing to do with the - * std::map class, and "nodes" should not be confused with - * std::list's usage of "node".) + * pointers-to-@anodes. (The name %map has nothing to do with the + * std::map class, and @b nodes should not be confused with + * std::list's usage of @a node.) * - * A "node" has no specific type name as such, but it is referred - * to as "node" in this file. It is a simple array-of-Tp. If Tp + * A @a node has no specific type name as such, but it is referred + * to as @a node in this file. It is a simple array-of-Tp. If Tp * is very large, there will be one Tp element per node (i.e., an - * "array" of one). For non-huge Tp's, node size is inversely + * @a array of one). For non-huge Tp's, node size is inversely * related to Tp size: the larger the Tp, the fewer Tp's will fit * in a node. The goal here is to keep the total size of a node * relatively small and constant over different Tp's, to improve @@ -669,7 +670,7 @@ _GLIBCXX_BEGIN_NESTED_NAMESPACE(std, _GLIBCXX_STD_D) * will be unused. This same situation will arise as the %map * grows: available %map pointers, if any, will be on the ends. As * new nodes are created, only a subset of the %map's pointers need - * to be copied "outward". + * to be copied @a outward. * * Class invariants: * - For any nonsingular iterator i: @@ -699,11 +700,11 @@ _GLIBCXX_BEGIN_NESTED_NAMESPACE(std, _GLIBCXX_STD_D) * node if and only if the pointer is in the range * [start.node, finish.node]. * - * Here's the magic: nothing in deque is "aware" of the discontiguous + * Here's the magic: nothing in deque is @b aware of the discontiguous * storage! * * The memory setup and layout occurs in the parent, _Base, and the iterator - * class is entirely responsible for "leaping" from one node to the next. + * class is entirely responsible for @a leaping from one node to the next. * All the implementation routines for deque itself work only through the * start and finish iterators. This keeps the routines simple and sane, * and we can use other standard algorithms as well. @@ -1392,7 +1393,7 @@ _GLIBCXX_BEGIN_NESTED_NAMESPACE(std, _GLIBCXX_STD_D) * * This function will insert copies of the data in the * initializer_list @a l into the %deque before the location - * specified by @a p. This is known as "list insert." + * specified by @a p. This is known as <em>list insert</em>. */ void insert(iterator __p, initializer_list<value_type> __l) @@ -1420,7 +1421,7 @@ _GLIBCXX_BEGIN_NESTED_NAMESPACE(std, _GLIBCXX_STD_D) * * This function will insert copies of the data in the range * [first,last) into the %deque before the location specified - * by @a pos. This is known as "range insert." + * by @a pos. This is known as <em>range insert</em>. */ template<typename _InputIterator> void diff --git a/libstdc++-v3/include/bits/stl_function.h b/libstdc++-v3/include/bits/stl_function.h index b2569d5..fd9c358 100644 --- a/libstdc++-v3/include/bits/stl_function.h +++ b/libstdc++-v3/include/bits/stl_function.h @@ -1,6 +1,6 @@ // Functor implementations -*- C++ -*- -// Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2009 +// Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2009, 2010 // Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free @@ -68,7 +68,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * templates and used in place of a function pointer. Not only is the * resulting expressiveness of the library increased, but the generated * code can be more efficient than what you might write by hand. When we - * refer to "functors," then, generally we include function pointers in + * refer to @a functors, then, generally we include function pointers in * the description as well. * * Often, functors are only created as temporaries passed to algorithm @@ -333,7 +333,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * std::find_if (v.begin(), v.end(), not1(IntGreaterThanThree())); * \endcode * The call to @c find_if will locate the first index (i) of @c v for which - * "!(v[i] > 3)" is true. + * <code>!(v[i] > 3)</code> is true. * * The not1/unary_negate combination works on predicates taking a single * argument. The not2/binary_negate combination works on predicates which diff --git a/libstdc++-v3/include/bits/stl_iterator.h b/libstdc++-v3/include/bits/stl_iterator.h index d6c4b51..105469a 100644 --- a/libstdc++-v3/include/bits/stl_iterator.h +++ b/libstdc++-v3/include/bits/stl_iterator.h @@ -1,6 +1,6 @@ // Iterators -*- C++ -*- -// Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 +// Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 // Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free @@ -83,9 +83,9 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * &*(reverse_iterator(i)) == &*(i - 1) * @endcode * - * This mapping is dictated by the fact that while there is always a + * <em>This mapping is dictated by the fact that while there is always a * pointer past the end of an array, there might not be a valid pointer - * before the beginning of an array.' [24.4.1]/1,2 + * before the beginning of an array.</em> [24.4.1]/1,2 * * Reverse iterators can be tricky and surprising at first. Their * semantics make sense, however, and the trickiness is a side effect of @@ -411,7 +411,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * reference-to-const T for container<T>. * @return This %iterator, for chained operations. * - * This kind of %iterator doesn't really have a "position" in the + * This kind of %iterator doesn't really have a @a position in the * container (you can think of the position as being permanently at * the end, if you like). Assigning a value to the %iterator will * always append the value to the end of the container. @@ -437,12 +437,12 @@ _GLIBCXX_BEGIN_NAMESPACE(std) operator*() { return *this; } - /// Simply returns *this. (This %iterator does not "move".) + /// Simply returns *this. (This %iterator does not @a move.) back_insert_iterator& operator++() { return *this; } - /// Simply returns *this. (This %iterator does not "move".) + /// Simply returns *this. (This %iterator does not @a move.) back_insert_iterator operator++(int) { return *this; } @@ -494,7 +494,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * reference-to-const T for container<T>. * @return This %iterator, for chained operations. * - * This kind of %iterator doesn't really have a "position" in the + * This kind of %iterator doesn't really have a @a position in the * container (you can think of the position as being permanently at * the front, if you like). Assigning a value to the %iterator will * always prepend the value to the front of the container. @@ -520,12 +520,12 @@ _GLIBCXX_BEGIN_NAMESPACE(std) operator*() { return *this; } - /// Simply returns *this. (This %iterator does not "move".) + /// Simply returns *this. (This %iterator does not @a move.) front_insert_iterator& operator++() { return *this; } - /// Simply returns *this. (This %iterator does not "move".) + /// Simply returns *this. (This %iterator does not @a move.) front_insert_iterator operator++(int) { return *this; } @@ -626,12 +626,12 @@ _GLIBCXX_BEGIN_NAMESPACE(std) operator*() { return *this; } - /// Simply returns *this. (This %iterator does not "move".) + /// Simply returns *this. (This %iterator does not @a move.) insert_iterator& operator++() { return *this; } - /// Simply returns *this. (This %iterator does not "move".) + /// Simply returns *this. (This %iterator does not @a move.) insert_iterator& operator++(int) { return *this; } @@ -662,7 +662,7 @@ _GLIBCXX_END_NAMESPACE _GLIBCXX_BEGIN_NAMESPACE(__gnu_cxx) - // This iterator adapter is 'normal' in the sense that it does not + // This iterator adapter is @a normal in the sense that it does not // change the semantics of any of the operators of its iterator // parameter. Its primary purpose is to convert an iterator that is // not a class, e.g. a pointer, into an iterator that is a class. diff --git a/libstdc++-v3/include/bits/stl_iterator_base_funcs.h b/libstdc++-v3/include/bits/stl_iterator_base_funcs.h index b629ca2..627fbe9 100644 --- a/libstdc++-v3/include/bits/stl_iterator_base_funcs.h +++ b/libstdc++-v3/include/bits/stl_iterator_base_funcs.h @@ -1,6 +1,6 @@ // Functions used by iterators -*- C++ -*- -// Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 +// Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 // Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free @@ -154,7 +154,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) /** * @brief A generalization of pointer arithmetic. * @param i An input iterator. - * @param n The "delta" by which to change @p i. + * @param n The @a delta by which to change @p i. * @return Nothing. * * This increments @p i by @p n. For bidirectional and random access diff --git a/libstdc++-v3/include/bits/stl_iterator_base_types.h b/libstdc++-v3/include/bits/stl_iterator_base_types.h index d2bf647..07687bd 100644 --- a/libstdc++-v3/include/bits/stl_iterator_base_types.h +++ b/libstdc++-v3/include/bits/stl_iterator_base_types.h @@ -1,6 +1,6 @@ // Types used in iterator implementation -*- C++ -*- -// Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 +// Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 // Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free @@ -123,7 +123,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * @brief Traits class for iterators. * * This class does nothing but define nested typedefs. The general - * version simply "forwards" the nested typedefs from the Iterator + * version simply @a forwards the nested typedefs from the Iterator * argument. Specialized versions for pointers and pointers-to-const * provide tighter, more correct semantics. */ diff --git a/libstdc++-v3/include/bits/stl_map.h b/libstdc++-v3/include/bits/stl_map.h index a13eeb5..7f81fab 100644 --- a/libstdc++-v3/include/bits/stl_map.h +++ b/libstdc++-v3/include/bits/stl_map.h @@ -532,7 +532,7 @@ _GLIBCXX_BEGIN_NESTED_NAMESPACE(std, _GLIBCXX_STD_D) * * See * http://gcc.gnu.org/onlinedocs/libstdc++/manual/bk01pt07ch17.html - * for more on "hinting". + * for more on @a hinting. * * Insertion requires logarithmic time (if the hint is not taken). */ diff --git a/libstdc++-v3/include/bits/stl_multimap.h b/libstdc++-v3/include/bits/stl_multimap.h index b582e38..e5575bc 100644 --- a/libstdc++-v3/include/bits/stl_multimap.h +++ b/libstdc++-v3/include/bits/stl_multimap.h @@ -453,7 +453,7 @@ _GLIBCXX_BEGIN_NESTED_NAMESPACE(std, _GLIBCXX_STD_D) * improve the performance of the insertion process. A bad hint would * cause no gains in efficiency. * - * For more on "hinting," see: + * For more on @a hinting, see: * http://gcc.gnu.org/onlinedocs/libstdc++/manual/bk01pt07ch17.html * * Insertion requires logarithmic time (if the hint is not taken). diff --git a/libstdc++-v3/include/bits/stl_multiset.h b/libstdc++-v3/include/bits/stl_multiset.h index dfbef1b..209e58e 100644 --- a/libstdc++-v3/include/bits/stl_multiset.h +++ b/libstdc++-v3/include/bits/stl_multiset.h @@ -412,7 +412,7 @@ _GLIBCXX_BEGIN_NESTED_NAMESPACE(std, _GLIBCXX_STD_D) * cause no gains in efficiency. * * See http://gcc.gnu.org/onlinedocs/libstdc++/manual/bk01pt07ch17.html - * for more on "hinting". + * for more on @a hinting. * * Insertion requires logarithmic time (if the hint is not taken). */ @@ -421,7 +421,7 @@ _GLIBCXX_BEGIN_NESTED_NAMESPACE(std, _GLIBCXX_STD_D) { return _M_t._M_insert_equal_(__position, __x); } /** - * @brief A template function that attempts to insert a range of elements. + * @brief A template function that tries to insert a range of elements. * @param first Iterator pointing to the start of the range to be * inserted. * @param last Iterator pointing to the end of the range. diff --git a/libstdc++-v3/include/bits/stl_queue.h b/libstdc++-v3/include/bits/stl_queue.h index 61149c4..058f1b6 100644 --- a/libstdc++-v3/include/bits/stl_queue.h +++ b/libstdc++-v3/include/bits/stl_queue.h @@ -81,7 +81,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * that supports @c front, @c back, @c push_back, and @c pop_front, * such as std::list or an appropriate user-defined type. * - * Members not found in "normal" containers are @c container_type, + * Members not found in @a normal containers are @c container_type, * which is a typedef for the second Sequence parameter, and @c push and * @c pop, which are standard %queue/FIFO operations. */ @@ -340,7 +340,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * priority comparisons. It defaults to @c less<value_type> but * can be anything defining a strict weak ordering. * - * Members not found in "normal" containers are @c container_type, + * Members not found in @a normal containers are @c container_type, * which is a typedef for the second Sequence parameter, and @c * push, @c pop, and @c top, which are standard %queue operations. * diff --git a/libstdc++-v3/include/bits/stl_set.h b/libstdc++-v3/include/bits/stl_set.h index 3b0d86f..54321e2 100644 --- a/libstdc++-v3/include/bits/stl_set.h +++ b/libstdc++-v3/include/bits/stl_set.h @@ -423,7 +423,7 @@ _GLIBCXX_BEGIN_NESTED_NAMESPACE(std, _GLIBCXX_STD_D) * potentially improve the performance of the insertion process. A bad * hint would cause no gains in efficiency. * - * For more on "hinting", see: + * For more on @a hinting, see: * http://gcc.gnu.org/onlinedocs/libstdc++/manual/bk01pt07ch17.html * * Insertion requires logarithmic time (if the hint is not taken). diff --git a/libstdc++-v3/include/bits/stl_stack.h b/libstdc++-v3/include/bits/stl_stack.h index 4178408..26f50ad 100644 --- a/libstdc++-v3/include/bits/stl_stack.h +++ b/libstdc++-v3/include/bits/stl_stack.h @@ -1,6 +1,6 @@ // Stack implementation -*- C++ -*- -// Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 +// Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 // Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free @@ -83,7 +83,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * such as std::list, std::vector, or an appropriate user-defined * type. * - * Members not found in "normal" containers are @c container_type, + * Members not found in @a normal containers are @c container_type, * which is a typedef for the second Sequence parameter, and @c * push, @c pop, and @c top, which are standard %stack/FILO * operations. diff --git a/libstdc++-v3/include/bits/stl_tempbuf.h b/libstdc++-v3/include/bits/stl_tempbuf.h index 27b58bf..a08b1ee 100644 --- a/libstdc++-v3/include/bits/stl_tempbuf.h +++ b/libstdc++-v3/include/bits/stl_tempbuf.h @@ -1,6 +1,6 @@ // Temporary buffer implementation -*- C++ -*- -// Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 +// Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 // Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free @@ -72,9 +72,9 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * * This function tries to obtain storage for @c len adjacent Tp * objects. The objects themselves are not constructed, of course. - * A pair<> is returned containing 'the buffer s address and + * A pair<> is returned containing <em>the buffer s address and * capacity (in the units of sizeof(Tp)), or a pair of 0 values if - * no storage can be obtained.' Note that the capacity obtained + * no storage can be obtained.</em> Note that the capacity obtained * may be less than that requested if the memory is unavailable; * you should compare len with the .second return value. * diff --git a/libstdc++-v3/include/c_global/cassert b/libstdc++-v3/include/c_global/cassert index 231e419..dc8af68 100644 --- a/libstdc++-v3/include/c_global/cassert +++ b/libstdc++-v3/include/c_global/cassert @@ -1,7 +1,7 @@ // -*- C++ -*- forwarding header. // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, -// 2006, 2007, 2008, 2009 +// 2006, 2007, 2008, 2009, 2010 // Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free @@ -26,7 +26,7 @@ /** @file cassert * This is a Standard C++ Library file. You should @c \#include this file - * in your programs, rather than any of the "*.h" implementation files. + * in your programs, rather than any of the @a *.h implementation files. * * This is the C++ version of the Standard C Library header @c assert.h, * and its contents are (mostly) the same as that header, but are all diff --git a/libstdc++-v3/include/c_global/cctype b/libstdc++-v3/include/c_global/cctype index bfe4592..1dfe172 100644 --- a/libstdc++-v3/include/c_global/cctype +++ b/libstdc++-v3/include/c_global/cctype @@ -1,7 +1,7 @@ // -*- C++ -*- forwarding header. // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, -// 2006, 2007, 2008, 2009 +// 2006, 2007, 2008, 2009, 2010 // Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free @@ -26,7 +26,7 @@ /** @file include/cctype * This is a Standard C++ Library file. You should @c \#include this file - * in your programs, rather than any of the "*.h" implementation files. + * in your programs, rather than any of the @a *.h implementation files. * * This is the C++ version of the Standard C Library header @c ctype.h, * and its contents are (mostly) the same as that header, but are all diff --git a/libstdc++-v3/include/c_global/cerrno b/libstdc++-v3/include/c_global/cerrno index f02d732..0451cd9 100644 --- a/libstdc++-v3/include/c_global/cerrno +++ b/libstdc++-v3/include/c_global/cerrno @@ -1,7 +1,7 @@ // The -*- C++ -*- forwarding header. // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, -// 2006, 2007, 2008, 2009 +// 2006, 2007, 2008, 2009, 2010 // Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free @@ -26,7 +26,7 @@ /** @file cerrno * This is a Standard C++ Library file. You should @c \#include this file - * in your programs, rather than any of the "*.h" implementation files. + * in your programs, rather than any of the @a *.h implementation files. * * This is the C++ version of the Standard C Library header @c errno.h, * and its contents are (mostly) the same as that header, but are all diff --git a/libstdc++-v3/include/c_global/cfloat b/libstdc++-v3/include/c_global/cfloat index 7f55144..1be81d3 100644 --- a/libstdc++-v3/include/c_global/cfloat +++ b/libstdc++-v3/include/c_global/cfloat @@ -1,7 +1,7 @@ // -*- C++ -*- forwarding header. // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, -// 2006, 2007, 2008, 2009 +// 2006, 2007, 2008, 2009, 2010 // Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free @@ -26,7 +26,7 @@ /** @file include/cfloat * This is a Standard C++ Library file. You should @c \#include this file - * in your programs, rather than any of the "*.h" implementation files. + * in your programs, rather than any of the @a *.h implementation files. * * This is the C++ version of the Standard C Library header @c float.h, * and its contents are (mostly) the same as that header, but are all diff --git a/libstdc++-v3/include/c_global/ciso646 b/libstdc++-v3/include/c_global/ciso646 index bb7e629..55594ae 100644 --- a/libstdc++-v3/include/c_global/ciso646 +++ b/libstdc++-v3/include/c_global/ciso646 @@ -1,6 +1,7 @@ // -*- C++ -*- forwarding header. -// Copyright (C) 2001, 2002, 2003, 2004, 2005, 2009 Free Software Foundation, Inc. +// Copyright (C) 2001, 2002, 2003, 2004, 2005, 2009, 2010 +// Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free // software; you can redistribute it and/or modify it under the @@ -24,7 +25,7 @@ /** @file ciso646 * This is a Standard C++ Library file. You should @c \#include this file - * in your programs, rather than any of the "*.h" implementation files. + * in your programs, rather than any of the @a *.h implementation files. * * This is the C++ version of the Standard C Library header @c iso646.h, * and its contents are (mostly) the same as that header, but are all diff --git a/libstdc++-v3/include/c_global/climits b/libstdc++-v3/include/c_global/climits index 1bbe6cf..f080fcb 100644 --- a/libstdc++-v3/include/c_global/climits +++ b/libstdc++-v3/include/c_global/climits @@ -1,7 +1,7 @@ // -*- C++ -*- forwarding header. // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, -// 2006, 2007, 2008, 2009 +// 2006, 2007, 2008, 2009, 2010 // Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free @@ -26,7 +26,7 @@ /** @file include/climits * This is a Standard C++ Library file. You should @c \#include this file - * in your programs, rather than any of the "*.h" implementation files. + * in your programs, rather than any of the @a *.h implementation files. * * This is the C++ version of the Standard C Library header @c limits.h, * and its contents are (mostly) the same as that header, but are all diff --git a/libstdc++-v3/include/c_global/clocale b/libstdc++-v3/include/c_global/clocale index 52d2b9d..7cf42e2 100644 --- a/libstdc++-v3/include/c_global/clocale +++ b/libstdc++-v3/include/c_global/clocale @@ -1,7 +1,7 @@ // -*- C++ -*- forwarding header. // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, -// 2006, 2007, 2008, 2009 +// 2006, 2007, 2008, 2009, 2010 // Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free @@ -26,7 +26,7 @@ /** @file clocale * This is a Standard C++ Library file. You should @c \#include this file - * in your programs, rather than any of the "*.h" implementation files. + * in your programs, rather than any of the @a *.h implementation files. * * This is the C++ version of the Standard C Library header @c locale.h, * and its contents are (mostly) the same as that header, but are all diff --git a/libstdc++-v3/include/c_global/cmath b/libstdc++-v3/include/c_global/cmath index 2568d6b..1267211 100644 --- a/libstdc++-v3/include/c_global/cmath +++ b/libstdc++-v3/include/c_global/cmath @@ -1,7 +1,7 @@ // -*- C++ -*- C forwarding header. // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, -// 2006, 2007, 2008, 2009 +// 2006, 2007, 2008, 2009, 2010 // Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free @@ -26,7 +26,7 @@ /** @file include/cmath * This is a Standard C++ Library file. You should @c \#include this file - * in your programs, rather than any of the "*.h" implementation files. + * in your programs, rather than any of the @a *.h implementation files. * * This is the C++ version of the Standard C Library header @c math.h, * and its contents are (mostly) the same as that header, but are all diff --git a/libstdc++-v3/include/c_global/csetjmp b/libstdc++-v3/include/c_global/csetjmp index c643d1b..16c3de6 100644 --- a/libstdc++-v3/include/c_global/csetjmp +++ b/libstdc++-v3/include/c_global/csetjmp @@ -1,7 +1,7 @@ // -*- C++ -*- forwarding header. // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, -// 2006, 2007, 2008, 2009 +// 2006, 2007, 2008, 2009, 2010 // Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free @@ -26,7 +26,7 @@ /** @file csetjmp * This is a Standard C++ Library file. You should @c \#include this file - * in your programs, rather than any of the "*.h" implementation files. + * in your programs, rather than any of the @a *.h implementation files. * * This is the C++ version of the Standard C Library header @c setjmp.h, * and its contents are (mostly) the same as that header, but are all diff --git a/libstdc++-v3/include/c_global/csignal b/libstdc++-v3/include/c_global/csignal index 147b5b6..bbd58ca 100644 --- a/libstdc++-v3/include/c_global/csignal +++ b/libstdc++-v3/include/c_global/csignal @@ -1,7 +1,7 @@ // -*- C++ -*- forwarding header. // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, -// 2006, 2007, 2008, 2009 +// 2006, 2007, 2008, 2009, 2010 // Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free @@ -26,7 +26,7 @@ /** @file csignal * This is a Standard C++ Library file. You should @c \#include this file - * in your programs, rather than any of the "*.h" implementation files. + * in your programs, rather than any of the @a *.h implementation files. * * This is the C++ version of the Standard C Library header @c signal.h, * and its contents are (mostly) the same as that header, but are all diff --git a/libstdc++-v3/include/c_global/cstdarg b/libstdc++-v3/include/c_global/cstdarg index c61a866..82ca4e8 100644 --- a/libstdc++-v3/include/c_global/cstdarg +++ b/libstdc++-v3/include/c_global/cstdarg @@ -1,7 +1,7 @@ // -*- C++ -*- forwarding header. // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, -// 2006, 2007, 2008, 2009 +// 2006, 2007, 2008, 2009, 2010 // Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free @@ -26,7 +26,7 @@ /** @file include/cstdarg * This is a Standard C++ Library file. You should @c \#include this file - * in your programs, rather than any of the "*.h" implementation files. + * in your programs, rather than any of the @a *.h implementation files. * * This is the C++ version of the Standard C Library header @c stdarg.h, * and its contents are (mostly) the same as that header, but are all diff --git a/libstdc++-v3/include/c_global/cstddef b/libstdc++-v3/include/c_global/cstddef index 6beb525..ce2d310 100644 --- a/libstdc++-v3/include/c_global/cstddef +++ b/libstdc++-v3/include/c_global/cstddef @@ -1,7 +1,7 @@ // -*- C++ -*- forwarding header. // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, -// 2006, 2007, 2008, 2009 +// 2006, 2007, 2008, 2009, 2010 // Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free @@ -26,7 +26,7 @@ /** @file cstddef * This is a Standard C++ Library file. You should @c \#include this file - * in your programs, rather than any of the "*.h" implementation files. + * in your programs, rather than any of the @a *.h implementation files. * * This is the C++ version of the Standard C Library header @c stddef.h, * and its contents are (mostly) the same as that header, but are all diff --git a/libstdc++-v3/include/c_global/cstdio b/libstdc++-v3/include/c_global/cstdio index b17f5cc..f87af19 100644 --- a/libstdc++-v3/include/c_global/cstdio +++ b/libstdc++-v3/include/c_global/cstdio @@ -1,7 +1,7 @@ // -*- C++ -*- forwarding header. // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, -// 2006, 2007, 2008, 2009 +// 2006, 2007, 2008, 2009, 2010 // Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free @@ -26,7 +26,7 @@ /** @file include/cstdio * This is a Standard C++ Library file. You should @c \#include this file - * in your programs, rather than any of the "*.h" implementation files. + * in your programs, rather than any of the @a *.h implementation files. * * This is the C++ version of the Standard C Library header @c stdio.h, * and its contents are (mostly) the same as that header, but are all diff --git a/libstdc++-v3/include/c_global/cstdlib b/libstdc++-v3/include/c_global/cstdlib index 0e0d7d5..dc9b956 100644 --- a/libstdc++-v3/include/c_global/cstdlib +++ b/libstdc++-v3/include/c_global/cstdlib @@ -1,7 +1,7 @@ // -*- C++ -*- forwarding header. // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, -// 2006, 2007, 2008, 2009 +// 2006, 2007, 2008, 2009, 2010 // Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free @@ -26,7 +26,7 @@ /** @file include/cstdlib * This is a Standard C++ Library file. You should @c \#include this file - * in your programs, rather than any of the "*.h" implementation files. + * in your programs, rather than any of the @a *.h implementation files. * * This is the C++ version of the Standard C Library header @c stdlib.h, * and its contents are (mostly) the same as that header, but are all diff --git a/libstdc++-v3/include/c_global/cstring b/libstdc++-v3/include/c_global/cstring index dba96c9..4452020 100644 --- a/libstdc++-v3/include/c_global/cstring +++ b/libstdc++-v3/include/c_global/cstring @@ -26,7 +26,7 @@ /** @file cstring * This is a Standard C++ Library file. You should @c \#include this file - * in your programs, rather than any of the "*.h" implementation files. + * in your programs, rather than any of the @a *.h implementation files. * * This is the C++ version of the Standard C Library header @c string.h, * and its contents are (mostly) the same as that header, but are all diff --git a/libstdc++-v3/include/c_global/ctime b/libstdc++-v3/include/c_global/ctime index 8430dc8..55f1f06 100644 --- a/libstdc++-v3/include/c_global/ctime +++ b/libstdc++-v3/include/c_global/ctime @@ -1,7 +1,7 @@ // -*- C++ -*- forwarding header. // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, -// 2006, 2007, 2008, 2009 +// 2006, 2007, 2008, 2009, 2010 // Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free @@ -26,7 +26,7 @@ /** @file include/ctime * This is a Standard C++ Library file. You should @c \#include this file - * in your programs, rather than any of the "*.h" implementation files. + * in your programs, rather than any of the @a *.h implementation files. * * This is the C++ version of the Standard C Library header @c time.h, * and its contents are (mostly) the same as that header, but are all diff --git a/libstdc++-v3/include/c_global/cwchar b/libstdc++-v3/include/c_global/cwchar index f2f36cf..537f39a 100644 --- a/libstdc++-v3/include/c_global/cwchar +++ b/libstdc++-v3/include/c_global/cwchar @@ -1,7 +1,7 @@ // -*- C++ -*- forwarding header. // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, -// 2006, 2007, 2008, 2009 +// 2006, 2007, 2008, 2009, 2010 // Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free @@ -26,7 +26,7 @@ /** @file include/cwchar * This is a Standard C++ Library file. You should @c \#include this file - * in your programs, rather than any of the "*.h" implementation files. + * in your programs, rather than any of the @a *.h implementation files. * * This is the C++ version of the Standard C Library header @c wchar.h, * and its contents are (mostly) the same as that header, but are all diff --git a/libstdc++-v3/include/c_global/cwctype b/libstdc++-v3/include/c_global/cwctype index ffc75c8..be649a2 100644 --- a/libstdc++-v3/include/c_global/cwctype +++ b/libstdc++-v3/include/c_global/cwctype @@ -1,7 +1,7 @@ // -*- C++ -*- forwarding header. // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, -// 2006, 2007, 2008, 2009 +// 2006, 2007, 2008, 2009, 2010 // Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free @@ -26,7 +26,7 @@ /** @file include/cwctype * This is a Standard C++ Library file. You should @c \#include this file - * in your programs, rather than any of the "*.h" implementation files. + * in your programs, rather than any of the @a *.h implementation files. * * This is the C++ version of the Standard C Library header @c wctype.h, * and its contents are (mostly) the same as that header, but are all diff --git a/libstdc++-v3/include/c_std/cassert b/libstdc++-v3/include/c_std/cassert index 5cb21a6..4ea0adc 100644 --- a/libstdc++-v3/include/c_std/cassert +++ b/libstdc++-v3/include/c_std/cassert @@ -1,7 +1,7 @@ // -*- C++ -*- forwarding header. // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, -// 2009 Free Software Foundation, Inc. +// 2009, 2010 Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free // software; you can redistribute it and/or modify it under the @@ -25,7 +25,7 @@ /** @file cassert * This is a Standard C++ Library file. You should @c #include this file - * in your programs, rather than any of the "*.h" implementation files. + * in your programs, rather than any of the @a *.h implementation files. * * This is the C++ version of the Standard C Library header @c assert.h, * and its contents are (mostly) the same as that header, but are all diff --git a/libstdc++-v3/include/c_std/cctype b/libstdc++-v3/include/c_std/cctype index 5f16bbc..7ba540b 100644 --- a/libstdc++-v3/include/c_std/cctype +++ b/libstdc++-v3/include/c_std/cctype @@ -1,7 +1,7 @@ // -*- C++ -*- forwarding header. // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, -// 2009 Free Software Foundation, Inc. +// 2009, 2010 Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free // software; you can redistribute it and/or modify it under the @@ -25,7 +25,7 @@ /** @file include/cctype * This is a Standard C++ Library file. You should @c #include this file - * in your programs, rather than any of the "*.h" implementation files. + * in your programs, rather than any of the @a *.h implementation files. * * This is the C++ version of the Standard C Library header @c ctype.h, * and its contents are (mostly) the same as that header, but are all diff --git a/libstdc++-v3/include/c_std/cerrno b/libstdc++-v3/include/c_std/cerrno index 49b8b19..d9d832f 100644 --- a/libstdc++-v3/include/c_std/cerrno +++ b/libstdc++-v3/include/c_std/cerrno @@ -1,7 +1,7 @@ // The -*- C++ -*- forwarding header. // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, -// 2009 Free Software Foundation, Inc. +// 2009, 2010 Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free // software; you can redistribute it and/or modify it under the @@ -25,7 +25,7 @@ /** @file cerrno * This is a Standard C++ Library file. You should @c #include this file - * in your programs, rather than any of the "*.h" implementation files. + * in your programs, rather than any of the @a *.h implementation files. * * This is the C++ version of the Standard C Library header @c errno.h, * and its contents are (mostly) the same as that header, but are all diff --git a/libstdc++-v3/include/c_std/cfloat b/libstdc++-v3/include/c_std/cfloat index 4501f05..a9072b7 100644 --- a/libstdc++-v3/include/c_std/cfloat +++ b/libstdc++-v3/include/c_std/cfloat @@ -1,7 +1,7 @@ // -*- C++ -*- forwarding header. // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, -// 2009 Free Software Foundation, Inc. +// 2009, 2010 Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free // software; you can redistribute it and/or modify it under the @@ -25,7 +25,7 @@ /** @file include/cfloat * This is a Standard C++ Library file. You should @c #include this file - * in your programs, rather than any of the "*.h" implementation files. + * in your programs, rather than any of the @a *.h implementation files. * * This is the C++ version of the Standard C Library header @c float.h, * and its contents are (mostly) the same as that header, but are all diff --git a/libstdc++-v3/include/c_std/ciso646 b/libstdc++-v3/include/c_std/ciso646 index a3c3f9b..0eaad86 100644 --- a/libstdc++-v3/include/c_std/ciso646 +++ b/libstdc++-v3/include/c_std/ciso646 @@ -1,6 +1,7 @@ // -*- C++ -*- forwarding header. -// Copyright (C) 2001, 2002, 2003, 2004, 2005, 2009 Free Software Foundation, Inc. +// Copyright (C) 2001, 2002, 2003, 2004, 2005, 2009, 2010 +// Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free // software; you can redistribute it and/or modify it under the @@ -24,7 +25,7 @@ /** @file ciso646 * This is a Standard C++ Library file. You should @c #include this file - * in your programs, rather than any of the "*.h" implementation files. + * in your programs, rather than any of the @a *.h implementation files. * * This is the C++ version of the Standard C Library header @c iso646.h, * and its contents are (mostly) the same as that header, but are all diff --git a/libstdc++-v3/include/c_std/climits b/libstdc++-v3/include/c_std/climits index 6ed4c43..91f52d2 100644 --- a/libstdc++-v3/include/c_std/climits +++ b/libstdc++-v3/include/c_std/climits @@ -1,7 +1,7 @@ // -*- C++ -*- forwarding header. // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, -// 2009 Free Software Foundation, Inc. +// 2009, 2010 Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free // software; you can redistribute it and/or modify it under the @@ -25,7 +25,7 @@ /** @file include/climits * This is a Standard C++ Library file. You should @c #include this file - * in your programs, rather than any of the "*.h" implementation files. + * in your programs, rather than any of the @a *.h implementation files. * * This is the C++ version of the Standard C Library header @c limits.h, * and its contents are (mostly) the same as that header, but are all diff --git a/libstdc++-v3/include/c_std/clocale b/libstdc++-v3/include/c_std/clocale index c18bc5e..36d8bd7 100644 --- a/libstdc++-v3/include/c_std/clocale +++ b/libstdc++-v3/include/c_std/clocale @@ -1,7 +1,7 @@ // -*- C++ -*- forwarding header. // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, -// 2009 Free Software Foundation, Inc. +// 2009, 2010 Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free // software; you can redistribute it and/or modify it under the @@ -25,7 +25,7 @@ /** @file clocale * This is a Standard C++ Library file. You should @c #include this file - * in your programs, rather than any of the "*.h" implementation files. + * in your programs, rather than any of the @a *.h implementation files. * * This is the C++ version of the Standard C Library header @c locale.h, * and its contents are (mostly) the same as that header, but are all diff --git a/libstdc++-v3/include/c_std/cmath b/libstdc++-v3/include/c_std/cmath index 3ee1393..e970896 100644 --- a/libstdc++-v3/include/c_std/cmath +++ b/libstdc++-v3/include/c_std/cmath @@ -1,7 +1,7 @@ // -*- C++ -*- C forwarding header. // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, -// 2006, 2007, 2008, 2009 +// 2006, 2007, 2008, 2009, 2010 // Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free @@ -26,7 +26,7 @@ /** @file include/cmath * This is a Standard C++ Library file. You should @c #include this file - * in your programs, rather than any of the "*.h" implementation files. + * in your programs, rather than any of the @a *.h implementation files. * * This is the C++ version of the Standard C Library header @c math.h, * and its contents are (mostly) the same as that header, but are all diff --git a/libstdc++-v3/include/c_std/csetjmp b/libstdc++-v3/include/c_std/csetjmp index cd3bed2..c5a91bd 100644 --- a/libstdc++-v3/include/c_std/csetjmp +++ b/libstdc++-v3/include/c_std/csetjmp @@ -1,7 +1,7 @@ // -*- C++ -*- forwarding header. // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, -// 2009 Free Software Foundation, Inc. +// 2009, 2010 Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free // software; you can redistribute it and/or modify it under the @@ -25,7 +25,7 @@ /** @file csetjmp * This is a Standard C++ Library file. You should @c #include this file - * in your programs, rather than any of the "*.h" implementation files. + * in your programs, rather than any of the @a *.h implementation files. * * This is the C++ version of the Standard C Library header @c setjmp.h, * and its contents are (mostly) the same as that header, but are all diff --git a/libstdc++-v3/include/c_std/csignal b/libstdc++-v3/include/c_std/csignal index 50a8aec..7cba945 100644 --- a/libstdc++-v3/include/c_std/csignal +++ b/libstdc++-v3/include/c_std/csignal @@ -1,7 +1,7 @@ // -*- C++ -*- forwarding header. // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, -// 2009 Free Software Foundation, Inc. +// 2009, 2010 Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free // software; you can redistribute it and/or modify it under the @@ -25,7 +25,7 @@ /** @file csignal * This is a Standard C++ Library file. You should @c #include this file - * in your programs, rather than any of the "*.h" implementation files. + * in your programs, rather than any of the @a *.h implementation files. * * This is the C++ version of the Standard C Library header @c signal.h, * and its contents are (mostly) the same as that header, but are all diff --git a/libstdc++-v3/include/c_std/cstdarg b/libstdc++-v3/include/c_std/cstdarg index 910fbd3..b033d9e 100644 --- a/libstdc++-v3/include/c_std/cstdarg +++ b/libstdc++-v3/include/c_std/cstdarg @@ -1,7 +1,7 @@ // -*- C++ -*- forwarding header. // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, -// 2009 Free Software Foundation, Inc. +// 2009, 2010 Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free // software; you can redistribute it and/or modify it under the @@ -25,7 +25,7 @@ /** @file include/cstdarg * This is a Standard C++ Library file. You should @c #include this file - * in your programs, rather than any of the "*.h" implementation files. + * in your programs, rather than any of the @a *.h implementation files. * * This is the C++ version of the Standard C Library header @c stdarg.h, * and its contents are (mostly) the same as that header, but are all diff --git a/libstdc++-v3/include/c_std/cstddef b/libstdc++-v3/include/c_std/cstddef index 87d4832..93fed5d 100644 --- a/libstdc++-v3/include/c_std/cstddef +++ b/libstdc++-v3/include/c_std/cstddef @@ -1,7 +1,7 @@ // -*- C++ -*- forwarding header. // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, -// 2009 Free Software Foundation, Inc. +// 2009, 2010 Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free // software; you can redistribute it and/or modify it under the @@ -25,7 +25,7 @@ /** @file cstddef * This is a Standard C++ Library file. You should @c #include this file - * in your programs, rather than any of the "*.h" implementation files. + * in your programs, rather than any of the @a *.h implementation files. * * This is the C++ version of the Standard C Library header @c stddef.h, * and its contents are (mostly) the same as that header, but are all diff --git a/libstdc++-v3/include/c_std/cstdio b/libstdc++-v3/include/c_std/cstdio index c25b1b1..a697437 100644 --- a/libstdc++-v3/include/c_std/cstdio +++ b/libstdc++-v3/include/c_std/cstdio @@ -1,7 +1,7 @@ // -*- C++ -*- forwarding header. // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, -// 2009 Free Software Foundation, Inc. +// 2009, 2010 Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free // software; you can redistribute it and/or modify it under the @@ -25,7 +25,7 @@ /** @file include/cstdio * This is a Standard C++ Library file. You should @c #include this file - * in your programs, rather than any of the "*.h" implementation files. + * in your programs, rather than any of the @a *.h implementation files. * * This is the C++ version of the Standard C Library header @c stdio.h, * and its contents are (mostly) the same as that header, but are all diff --git a/libstdc++-v3/include/c_std/cstdlib b/libstdc++-v3/include/c_std/cstdlib index 516dcab..c1e3379 100644 --- a/libstdc++-v3/include/c_std/cstdlib +++ b/libstdc++-v3/include/c_std/cstdlib @@ -1,7 +1,7 @@ // -*- C++ -*- forwarding header. // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, -// 2009 Free Software Foundation, Inc. +// 2009, 2010 Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free // software; you can redistribute it and/or modify it under the @@ -25,7 +25,7 @@ /** @file include/cstdlib * This is a Standard C++ Library file. You should @c #include this file - * in your programs, rather than any of the "*.h" implementation files. + * in your programs, rather than any of the @a *.h implementation files. * * This is the C++ version of the Standard C Library header @c stdlib.h, * and its contents are (mostly) the same as that header, but are all diff --git a/libstdc++-v3/include/c_std/cstring b/libstdc++-v3/include/c_std/cstring index 3535a24..9143656 100644 --- a/libstdc++-v3/include/c_std/cstring +++ b/libstdc++-v3/include/c_std/cstring @@ -26,7 +26,7 @@ /** @file cstring * This is a Standard C++ Library file. You should @c #include this file - * in your programs, rather than any of the "*.h" implementation files. + * in your programs, rather than any of the @a *.h implementation files. * * This is the C++ version of the Standard C Library header @c string.h, * and its contents are (mostly) the same as that header, but are all diff --git a/libstdc++-v3/include/c_std/ctime b/libstdc++-v3/include/c_std/ctime index 97f904c..dca90eb 100644 --- a/libstdc++-v3/include/c_std/ctime +++ b/libstdc++-v3/include/c_std/ctime @@ -1,7 +1,7 @@ // -*- C++ -*- forwarding header. // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, -// 2009 Free Software Foundation, Inc. +// 2009, 2010 Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free // software; you can redistribute it and/or modify it under the @@ -25,7 +25,7 @@ /** @file include/ctime * This is a Standard C++ Library file. You should @c #include this file - * in your programs, rather than any of the "*.h" implementation files. + * in your programs, rather than any of the @a *.h implementation files. * * This is the C++ version of the Standard C Library header @c time.h, * and its contents are (mostly) the same as that header, but are all diff --git a/libstdc++-v3/include/c_std/cwchar b/libstdc++-v3/include/c_std/cwchar index f3bc2c7..3d50367 100644 --- a/libstdc++-v3/include/c_std/cwchar +++ b/libstdc++-v3/include/c_std/cwchar @@ -1,7 +1,7 @@ // -*- C++ -*- forwarding header. // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, -// 2006, 2007, 2009 +// 2006, 2007, 2009, 2010 // Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free @@ -26,7 +26,7 @@ /** @file include/cwchar * This is a Standard C++ Library file. You should @c #include this file - * in your programs, rather than any of the "*.h" implementation files. + * in your programs, rather than any of the @a *.h implementation files. * * This is the C++ version of the Standard C Library header @c wchar.h, * and its contents are (mostly) the same as that header, but are all diff --git a/libstdc++-v3/include/c_std/cwctype b/libstdc++-v3/include/c_std/cwctype index 54667ec..4af4250 100644 --- a/libstdc++-v3/include/c_std/cwctype +++ b/libstdc++-v3/include/c_std/cwctype @@ -1,7 +1,7 @@ // -*- C++ -*- forwarding header. // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, -// 2009 Free Software Foundation, Inc. +// 2009, 2010 Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free // software; you can redistribute it and/or modify it under the @@ -25,7 +25,7 @@ /** @file include/cwctype * This is a Standard C++ Library file. You should @c #include this file - * in your programs, rather than any of the "*.h" implementation files. + * in your programs, rather than any of the @a *.h implementation files. * * This is the C++ version of the Standard C Library header @c wctype.h, * and its contents are (mostly) the same as that header, but are all diff --git a/libstdc++-v3/include/debug/macros.h b/libstdc++-v3/include/debug/macros.h index 803e7d9..a56001a 100644 --- a/libstdc++-v3/include/debug/macros.h +++ b/libstdc++-v3/include/debug/macros.h @@ -1,6 +1,6 @@ // Debugging support implementation -*- C++ -*- -// Copyright (C) 2003, 2004, 2005, 2006, 2007, 2008, 2009 +// Copyright (C) 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 // Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free @@ -34,7 +34,7 @@ * Macros used by the implementation to verify certain * properties. These macros may only be used directly by the debug * wrappers. Note that these are macros (instead of the more obviously - * "correct" choice of making them functions) because we need line and + * @a correct choice of making them functions) because we need line and * file information at the call site, to minimize the distance between * the user error and where the error is reported. * diff --git a/libstdc++-v3/include/debug/safe_base.h b/libstdc++-v3/include/debug/safe_base.h index 9d44539..3e81f9b 100644 --- a/libstdc++-v3/include/debug/safe_base.h +++ b/libstdc++-v3/include/debug/safe_base.h @@ -1,6 +1,6 @@ // Safe sequence/iterator base implementation -*- C++ -*- -// Copyright (C) 2003, 2004, 2005, 2006, 2009 +// Copyright (C) 2003, 2004, 2005, 2006, 2009, 2010 // Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free @@ -36,7 +36,7 @@ namespace __gnu_debug { class _Safe_sequence_base; - /** \brief Basic functionality for a "safe" iterator. + /** \brief Basic functionality for a @a safe iterator. * * The %_Safe_iterator_base base class implements the functionality * of a safe iterator that is not specific to a particular iterator @@ -153,7 +153,7 @@ namespace __gnu_debug * invalidation of all iterators that reference the container. * * This class must ensure that no operation on it may throw an - * exception, otherwise "safe" sequences may fail to provide the + * exception, otherwise @a safe sequences may fail to provide the * exception-safety guarantees required by the C++ standard. */ class _Safe_sequence_base diff --git a/libstdc++-v3/include/debug/safe_sequence.h b/libstdc++-v3/include/debug/safe_sequence.h index bbeac1d..830372d 100644 --- a/libstdc++-v3/include/debug/safe_sequence.h +++ b/libstdc++-v3/include/debug/safe_sequence.h @@ -1,6 +1,6 @@ // Safe sequence implementation -*- C++ -*- -// Copyright (C) 2003, 2004, 2005, 2006, 2009 +// Copyright (C) 2003, 2004, 2005, 2006, 2009, 2010 // Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free @@ -78,11 +78,11 @@ namespace __gnu_debug }; /** - * @brief Base class for constructing a "safe" sequence type that + * @brief Base class for constructing a @a safe sequence type that * tracks iterators that reference it. * * The class template %_Safe_sequence simplifies the construction of - * "safe" sequences that track the iterators that reference the + * @a safe sequences that track the iterators that reference the * sequence, so that the iterators are notified of changes in the * sequence that may affect their operation, e.g., if the container * invalidates its iterators or is destructed. This class template diff --git a/libstdc++-v3/include/ext/algorithm b/libstdc++-v3/include/ext/algorithm index 3337d6c..9b2108b 100644 --- a/libstdc++-v3/include/ext/algorithm +++ b/libstdc++-v3/include/ext/algorithm @@ -1,6 +1,6 @@ // Algorithm extensions -*- C++ -*- -// Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 +// Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 // Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free @@ -189,8 +189,9 @@ _GLIBCXX_BEGIN_NAMESPACE(__gnu_cxx) * @return An int, as with @c memcmp. * * The return value will be less than zero if the first range is - * "lexigraphically less than" the second, greater than zero if the second - * range is "lexigraphically less than" the first, and zero otherwise. + * <em>lexigraphically less than</em> the second, greater than zero + * if the second range is <em>lexigraphically less than</em> the + * first, and zero otherwise. * This is an SGI extension. * @ingroup SGIextensions */ diff --git a/libstdc++-v3/include/ext/functional b/libstdc++-v3/include/ext/functional index 30afd58..546b9c6 100644 --- a/libstdc++-v3/include/ext/functional +++ b/libstdc++-v3/include/ext/functional @@ -188,7 +188,7 @@ _GLIBCXX_BEGIN_NAMESPACE(__gnu_cxx) * @c operator()s * take a @c std::pair as an argument, and return either the first member * or the second member, respectively. They can be used (especially with - * the composition functors) to "strip" data from a sequence before + * the composition functors) to @a strip data from a sequence before * performing the remainder of an algorithm. * * @addtogroup SGIextensions @@ -288,7 +288,7 @@ _GLIBCXX_BEGIN_NAMESPACE(__gnu_cxx) * - @c constant_binary_fun's @c operator() takes two arguments (ignored) * * The helper creator functions @c constant0, @c constant1, and - * @c constant2 each take a "result" argument and construct variables of + * @c constant2 each take a @a result argument and construct variables of * the appropriate functor type. * * @addtogroup SGIextensions diff --git a/libstdc++-v3/include/ext/mt_allocator.h b/libstdc++-v3/include/ext/mt_allocator.h index e44b98d..0e67513 100644 --- a/libstdc++-v3/include/ext/mt_allocator.h +++ b/libstdc++-v3/include/ext/mt_allocator.h @@ -1,6 +1,6 @@ // MT-optimized allocator -*- C++ -*- -// Copyright (C) 2003, 2004, 2005, 2006, 2007, 2008, 2009 +// Copyright (C) 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 // Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free @@ -612,9 +612,9 @@ _GLIBCXX_BEGIN_NAMESPACE(__gnu_cxx) /** * @brief This is a fixed size (power of 2) allocator which - when * compiled with thread support - will maintain one freelist per - * size per thread plus a "global" one. Steps are taken to limit + * size per thread plus a @a global one. Steps are taken to limit * the per thread freelist sizes (by returning excess back to - * the "global" list). + * the @a global list). * @ingroup allocators * * Further details: diff --git a/libstdc++-v3/include/ext/pb_ds/detail/bin_search_tree_/bin_search_tree_.hpp b/libstdc++-v3/include/ext/pb_ds/detail/bin_search_tree_/bin_search_tree_.hpp index 7315d95..cb3ffe1 100644 --- a/libstdc++-v3/include/ext/pb_ds/detail/bin_search_tree_/bin_search_tree_.hpp +++ b/libstdc++-v3/include/ext/pb_ds/detail/bin_search_tree_/bin_search_tree_.hpp @@ -38,7 +38,7 @@ * Contains an implementation class for bin_search_tree_. */ /* - * This implementation uses an idea from the SGI STL (using a "header" node + * This implementation uses an idea from the SGI STL (using a @a header node * which is needed for efficient iteration). */ diff --git a/libstdc++-v3/include/ext/pb_ds/detail/pat_trie_/pat_trie_.hpp b/libstdc++-v3/include/ext/pb_ds/detail/pat_trie_/pat_trie_.hpp index f6f4209..627f8b1 100644 --- a/libstdc++-v3/include/ext/pb_ds/detail/pat_trie_/pat_trie_.hpp +++ b/libstdc++-v3/include/ext/pb_ds/detail/pat_trie_/pat_trie_.hpp @@ -40,8 +40,8 @@ /** * This implementation loosely borrows ideas from: - * 1) "Fast Mergeable Integer Maps", Okasaki, Gill 1998 - * 2) "Ptset: Sets of integers implemented as Patricia trees", + * 1) Fast Mergeable Integer Maps, Okasaki, Gill 1998 + * 2) Ptset: Sets of integers implemented as Patricia trees, * Jean-Christophe Filliatr, 2000 **/ diff --git a/libstdc++-v3/include/ext/pb_ds/detail/rb_tree_map_/rb_tree_.hpp b/libstdc++-v3/include/ext/pb_ds/detail/rb_tree_map_/rb_tree_.hpp index 9010def..e0f4b4e 100644 --- a/libstdc++-v3/include/ext/pb_ds/detail/rb_tree_map_/rb_tree_.hpp +++ b/libstdc++-v3/include/ext/pb_ds/detail/rb_tree_map_/rb_tree_.hpp @@ -38,7 +38,7 @@ * Contains an implementation for rb_tree_. */ /* - * This implementation uses an idea from the SGI STL (using a "header" node + * This implementation uses an idea from the SGI STL (using a @a header node * which is needed for efficient iteration). */ diff --git a/libstdc++-v3/include/ext/pb_ds/detail/splay_tree_/splay_tree_.hpp b/libstdc++-v3/include/ext/pb_ds/detail/splay_tree_/splay_tree_.hpp index 959893e..674c5c9 100644 --- a/libstdc++-v3/include/ext/pb_ds/detail/splay_tree_/splay_tree_.hpp +++ b/libstdc++-v3/include/ext/pb_ds/detail/splay_tree_/splay_tree_.hpp @@ -38,7 +38,7 @@ * Contains an implementation class for splay_tree_. */ /* - * This implementation uses an idea from the SGI STL (using a "header" node + * This implementation uses an idea from the SGI STL (using a @a header node * which is needed for efficient iteration). Following is the SGI STL * copyright. * diff --git a/libstdc++-v3/include/ext/pb_ds/detail/type_utils.hpp b/libstdc++-v3/include/ext/pb_ds/detail/type_utils.hpp index 55f349a..b82d21b 100644 --- a/libstdc++-v3/include/ext/pb_ds/detail/type_utils.hpp +++ b/libstdc++-v3/include/ext/pb_ds/detail/type_utils.hpp @@ -36,7 +36,7 @@ /** * @file type_utils.hpp * Contains utilities for handnling types. All of these classes are based on - * "Modern C++" by Andrei Alxandrescu. + * Modern C++ by Andrei Alxandrescu. */ #ifndef PB_DS_TYPE_UTILS_HPP diff --git a/libstdc++-v3/include/ext/rc_string_base.h b/libstdc++-v3/include/ext/rc_string_base.h index 52a481d..a18b274 100644 --- a/libstdc++-v3/include/ext/rc_string_base.h +++ b/libstdc++-v3/include/ext/rc_string_base.h @@ -58,7 +58,7 @@ _GLIBCXX_BEGIN_NAMESPACE(__gnu_cxx) * This approach has the enormous advantage that a string object * requires only one allocation. All the ugliness is confined * within a single pair of inline functions, which each compile to - * a single "add" instruction: _Rep::_M_refdata(), and + * a single @a add instruction: _Rep::_M_refdata(), and * __rc_string_base::_M_rep(); and the allocation function which gets a * block of raw bytes and with room enough and constructs a _Rep * object at the front. @@ -70,7 +70,7 @@ _GLIBCXX_BEGIN_NAMESPACE(__gnu_cxx) * string length.) * * Note that the _Rep object is a POD so that you can have a - * static "empty string" _Rep object already "constructed" before + * static <em>empty string</em> _Rep object already @a constructed before * static constructors have run. The reference-count encoding is * chosen so that a 0 indicates one reference, so you never try to * destroy the empty-string _Rep object. diff --git a/libstdc++-v3/include/ext/stdio_sync_filebuf.h b/libstdc++-v3/include/ext/stdio_sync_filebuf.h index 9407e96..de44fdc 100644 --- a/libstdc++-v3/include/ext/stdio_sync_filebuf.h +++ b/libstdc++-v3/include/ext/stdio_sync_filebuf.h @@ -1,6 +1,7 @@ // Iostreams wrapper for stdio FILE* -*- C++ -*- -// Copyright (C) 2003, 2004, 2005, 2006, 2007, 2009 Free Software Foundation, Inc. +// Copyright (C) 2003, 2004, 2005, 2006, 2007, 2009, 2010 +// Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free // software; you can redistribute it and/or modify it under the @@ -71,7 +72,7 @@ _GLIBCXX_BEGIN_NAMESPACE(__gnu_cxx) /** * @return The underlying FILE*. * - * This function can be used to access the underlying "C" file pointer. + * This function can be used to access the underlying C file pointer. * Note that there is no way for the library to track what you do * with the file, so be careful. */ diff --git a/libstdc++-v3/include/ext/vstring.h b/libstdc++-v3/include/ext/vstring.h index 1beecf6..37d36bc 100644 --- a/libstdc++-v3/include/ext/vstring.h +++ b/libstdc++-v3/include/ext/vstring.h @@ -505,7 +505,8 @@ _GLIBCXX_BEGIN_NAMESPACE(__gnu_cxx) { this->_M_clear(); } /** - * Returns true if the %string is empty. Equivalent to *this == "". + * Returns true if the %string is empty. Equivalent to + * <code>*this == ""</code>. */ bool empty() const @@ -2027,7 +2028,7 @@ _GLIBCXX_BEGIN_NAMESPACE(__gnu_cxx) * the comparison is nonzero returns it, otherwise the shorter * one is ordered first. * - * NB: s must have at least n2 characters, '\\0' has no special + * NB: s must have at least n2 characters, <em>\\0</em> has no special * meaning. */ int @@ -2432,12 +2433,12 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * @param __str Buffer to store into. * @return Reference to the input stream. * - * Stores characters from is into @a __str until '\n' is found, the - * end of the stream is encountered, or str.max_size() is reached. - * If is.width() is non-zero, that is the limit on the number of - * characters stored into @a __str. Any previous contents of @a - * __str are erased. If end of line was encountered, it is - * extracted but not stored into @a __str. + * Stores characters from is into @a __str until '\n' is + * found, the end of the stream is encountered, or str.max_size() + * is reached. If is.width() is non-zero, that is the limit on the + * number of characters stored into @a __str. Any previous + * contents of @a __str are erased. If end of line was + * encountered, it is extracted but not stored into @a __str. */ template<typename _CharT, typename _Traits, typename _Alloc, template <typename, typename, typename> class _Base> diff --git a/libstdc++-v3/include/parallel/for_each.h b/libstdc++-v3/include/parallel/for_each.h index e6e573d..0132593 100644 --- a/libstdc++-v3/include/parallel/for_each.h +++ b/libstdc++-v3/include/parallel/for_each.h @@ -1,6 +1,6 @@ // -*- C++ -*- -// Copyright (C) 2007, 2008, 2009 Free Software Foundation, Inc. +// Copyright (C) 2007, 2008, 2009, 2010 Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free // software; you can redistribute it and/or modify it under the terms @@ -47,7 +47,7 @@ namespace __gnu_parallel * @param __end End iterator of input sequence. * @param __user_op A user-specified functor (comparator, predicate, * associative operator,...) - * @param __functionality functor to "process" an element with + * @param __functionality functor to @a process an element with * __user_op (depends on desired functionality, e. g. accumulate, * for_each,... * @param __reduction Reduction functor. diff --git a/libstdc++-v3/include/parallel/multiway_merge.h b/libstdc++-v3/include/parallel/multiway_merge.h index f66a3e9..445184a 100644 --- a/libstdc++-v3/include/parallel/multiway_merge.h +++ b/libstdc++-v3/include/parallel/multiway_merge.h @@ -1,6 +1,6 @@ // -*- C++ -*- -// Copyright (C) 2007, 2008, 2009 Free Software Foundation, Inc. +// Copyright (C) 2007, 2008, 2009, 2010 Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free // software; you can redistribute it and/or modify it under the terms @@ -210,7 +210,7 @@ namespace __gnu_parallel * * This works well for merging up to 4 sequences. * - * Note that making the merging stable does <em>not</em> come at a + * Note that making the merging stable does @a not come at a * performance hit. * * Whether the merging is done guarded or unguarded is selected by the @@ -329,7 +329,7 @@ namespace __gnu_parallel * * This works well for merging up to 4 sequences. * - * Note that making the merging stable does <em>not</em> come at a + * Note that making the merging stable does @a not come at a * performance hit. * * Whether the merging is done guarded or unguarded is selected by the diff --git a/libstdc++-v3/include/parallel/omp_loop.h b/libstdc++-v3/include/parallel/omp_loop.h index d07fd7a..94f9e6b 100644 --- a/libstdc++-v3/include/parallel/omp_loop.h +++ b/libstdc++-v3/include/parallel/omp_loop.h @@ -1,6 +1,6 @@ // -*- C++ -*- -// Copyright (C) 2007, 2008, 2009 Free Software Foundation, Inc. +// Copyright (C) 2007, 2008, 2009, 2010 Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free // software; you can redistribute it and/or modify it under the terms @@ -48,9 +48,9 @@ namespace __gnu_parallel * @param __end End iterator of element sequence. * @param __o User-supplied functor (comparator, predicate, adding * functor, etc.). - * @param __f Functor to "process" an element with __op (depends on + * @param __f Functor to @a process an element with __op (depends on * desired functionality, e. g. for std::for_each(), ...). - * @param __r Functor to "add" a single __result to the already + * @param __r Functor to @a add a single __result to the already * processed elements (depends on functionality). * @param __base Base value for reduction. * @param __output Pointer to position where final result is written to diff --git a/libstdc++-v3/include/parallel/omp_loop_static.h b/libstdc++-v3/include/parallel/omp_loop_static.h index f43726e..ca22d59 100644 --- a/libstdc++-v3/include/parallel/omp_loop_static.h +++ b/libstdc++-v3/include/parallel/omp_loop_static.h @@ -1,6 +1,6 @@ // -*- C++ -*- -// Copyright (C) 2007, 2008, 2009 Free Software Foundation, Inc. +// Copyright (C) 2007, 2008, 2009, 2010 Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free // software; you can redistribute it and/or modify it under the terms @@ -47,9 +47,9 @@ namespace __gnu_parallel * @param __end End iterator of element sequence. * @param __o User-supplied functor (comparator, predicate, adding * functor, ...). - * @param __f Functor to "process" an element with __op (depends on + * @param __f Functor to @a process an element with __op (depends on * desired functionality, e. g. for std::for_each(), ...). - * @param __r Functor to "add" a single __result to the already processed + * @param __r Functor to @a add a single __result to the already processed * __elements (depends on functionality). * @param __base Base value for reduction. * @param __output Pointer to position where final result is written to diff --git a/libstdc++-v3/include/parallel/workstealing.h b/libstdc++-v3/include/parallel/workstealing.h index 9e0db3a..5e90ae9 100644 --- a/libstdc++-v3/include/parallel/workstealing.h +++ b/libstdc++-v3/include/parallel/workstealing.h @@ -1,6 +1,6 @@ // -*- C++ -*- -// Copyright (C) 2007, 2008, 2009 Free Software Foundation, Inc. +// Copyright (C) 2007, 2008, 2009, 2010 Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free // software; you can redistribute it and/or modify it under the terms @@ -80,9 +80,9 @@ namespace __gnu_parallel * @param __end End iterator of element sequence. * @param __op User-supplied functor (comparator, predicate, adding * functor, ...). - * @param __f Functor to "process" an element with __op (depends on + * @param __f Functor to @a process an element with __op (depends on * desired functionality, e. g. for std::for_each(), ...). - * @param __r Functor to "add" a single __result to the already + * @param __r Functor to @a add a single __result to the already * processed elements (depends on functionality). * @param __base Base value for reduction. * @param __output Pointer to position where final result is written to diff --git a/libstdc++-v3/include/profile/impl/profiler_trace.h b/libstdc++-v3/include/profile/impl/profiler_trace.h index 7512677..c6ddfe7 100644 --- a/libstdc++-v3/include/profile/impl/profiler_trace.h +++ b/libstdc++-v3/include/profile/impl/profiler_trace.h @@ -1,6 +1,6 @@ // -*- C++ -*- // -// Copyright (C) 2009 Free Software Foundation, Inc. +// Copyright (C) 2009, 2010 Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free // software; you can redistribute it and/or modify it under the terms @@ -468,7 +468,7 @@ inline FILE* __open_output_file(const char* extension) } } -/** @brief Final report method, registered with "atexit". +/** @brief Final report method, registered with @b atexit. * * This can also be called directly by user code, including signal handlers. * It is protected against deadlocks by the reentrance guard in profiler.h. diff --git a/libstdc++-v3/include/profile/iterator_tracker.h b/libstdc++-v3/include/profile/iterator_tracker.h index 6160d10..0febb9b 100644 --- a/libstdc++-v3/include/profile/iterator_tracker.h +++ b/libstdc++-v3/include/profile/iterator_tracker.h @@ -22,7 +22,7 @@ // see the files COPYING3 and COPYING.RUNTIME respectively. If not, see // <http://www.gnu.org/licenses/>. -/** @file profile/literator_tracker.h +/** @file profile/iterator_tracker.h * This file is a GNU profile extension to the Standard C++ Library. */ diff --git a/libstdc++-v3/include/std/bitset b/libstdc++-v3/include/std/bitset index 06fdd3f..9101e67 100644 --- a/libstdc++-v3/include/std/bitset +++ b/libstdc++-v3/include/std/bitset @@ -1,6 +1,6 @@ // <bitset> -*- C++ -*- -// Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 +// Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 // Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free @@ -646,16 +646,17 @@ _GLIBCXX_BEGIN_NESTED_NAMESPACE(std, _GLIBCXX_STD_D) * the high-order bits in the highest word.) It is a class invariant * that those unused bits are always zero. * - * If you think of %bitset as "a simple array of bits," be aware that - * your mental picture is reversed: a %bitset behaves the same way as - * bits in integers do, with the bit at index 0 in the "least significant - * / right-hand" position, and the bit at index Nb-1 in the "most - * significant / left-hand" position. Thus, unlike other containers, a - * %bitset's index "counts from right to left," to put it very loosely. + * If you think of %bitset as <em>a simple array of bits</em>, be + * aware that your mental picture is reversed: a %bitset behaves + * the same way as bits in integers do, with the bit at index 0 in + * the <em>least significant / right-hand</em> position, and the bit at + * index Nb-1 in the <em>most significant / left-hand</em> position. + * Thus, unlike other containers, a %bitset's index <em>counts from + * right to left</em>, to put it very loosely. * * This behavior is preserved when translating to and from strings. For * example, the first line of the following program probably prints - * "b('a') is 0001100001" on a modern ASCII system. + * <em>b('a') is 0001100001</em> on a modern ASCII system. * * @code * #include <bitset> @@ -717,8 +718,8 @@ _GLIBCXX_BEGIN_NESTED_NAMESPACE(std, _GLIBCXX_STD_D) * to and from bool are automatic and should be transparent. Overloaded * operators help to preserve the illusion. * - * (On a typical system, this "bit %reference" is 64 times the size of - * an actual bit. Ha.) + * (On a typical system, this <em>bit %reference</em> is 64 + * times the size of an actual bit. Ha.) */ class reference { @@ -797,12 +798,12 @@ _GLIBCXX_BEGIN_NESTED_NAMESPACE(std, _GLIBCXX_STD_D) /** * @brief Use a subset of a string. - * @param s A string of '0' and '1' characters. + * @param s A string of @a 0 and @a 1 characters. * @param position Index of the first character in @a s to use; * defaults to zero. * @throw std::out_of_range If @a pos is bigger the size of @a s. * @throw std::invalid_argument If a character appears in the string - * which is neither '0' nor '1'. + * which is neither @a 0 nor @a 1. */ template<class _CharT, class _Traits, class _Alloc> explicit @@ -820,12 +821,12 @@ _GLIBCXX_BEGIN_NESTED_NAMESPACE(std, _GLIBCXX_STD_D) /** * @brief Use a subset of a string. - * @param s A string of '0' and '1' characters. + * @param s A string of @a 0 and @a 1 characters. * @param position Index of the first character in @a s to use. * @param n The number of characters to copy. * @throw std::out_of_range If @a pos is bigger the size of @a s. * @throw std::invalid_argument If a character appears in the string - * which is neither '0' nor '1'. + * which is neither @a 0 nor @a 1. */ template<class _CharT, class _Traits, class _Alloc> bitset(const std::basic_string<_CharT, _Traits, _Alloc>& __s, @@ -855,9 +856,9 @@ _GLIBCXX_BEGIN_NESTED_NAMESPACE(std, _GLIBCXX_STD_D) #ifdef __GXX_EXPERIMENTAL_CXX0X__ /** * @brief Construct from a string. - * @param str A string of '0' and '1' characters. + * @param str A string of @a 0 and @a 1 characters. * @throw std::invalid_argument If a character appears in the string - * which is neither '0' nor '1'. + * which is neither @a 0 nor @a 1. */ explicit bitset(const char* __str) @@ -1063,7 +1064,7 @@ _GLIBCXX_BEGIN_NESTED_NAMESPACE(std, _GLIBCXX_STD_D) /** * @brief Array-indexing support. * @param position Index into the %bitset. - * @return A bool for a 'const %bitset'. For non-const bitsets, an + * @return A bool for a <em>const %bitset</em>. For non-const bitsets, an * instance of the reference proxy class. * @note These operators do no range checking and throw no exceptions, * as required by DR 11 to the standard. @@ -1377,7 +1378,7 @@ _GLIBCXX_BEGIN_NESTED_NAMESPACE(std, _GLIBCXX_STD_D) * @brief Global I/O operators for bitsets. * * Direct I/O between streams and bitsets is supported. Output is - * straightforward. Input will skip whitespace, only accept '0' and '1' + * straightforward. Input will skip whitespace, only accept @a 0 and @a 1 * characters, and will only extract as many digits as the %bitset will * hold. */ diff --git a/libstdc++-v3/include/std/fstream b/libstdc++-v3/include/std/fstream index 88c1d14..9aa4f1a 100644 --- a/libstdc++-v3/include/std/fstream +++ b/libstdc++-v3/include/std/fstream @@ -1,7 +1,7 @@ // File based streams -*- C++ -*- // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, -// 2006, 2007, 2008, 2009 +// 2006, 2007, 2008, 2009, 2010 // Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free @@ -119,9 +119,9 @@ _GLIBCXX_BEGIN_NAMESPACE(std) bool _M_buf_allocated; /** - * _M_reading == false && _M_writing == false for 'uncommitted' mode; - * _M_reading == true for 'read' mode; - * _M_writing == true for 'write' mode; + * _M_reading == false && _M_writing == false for @b uncommitted mode; + * _M_reading == true for @b read mode; + * _M_writing == true for @b write mode; * * NB: _M_reading == true && _M_writing == true is unused. */ @@ -240,25 +240,25 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * | ios_base Flag combination stdio equivalent | * |binary in out trunc app | * +---------------------------------------------------------+ - * | + "w" | - * | + + "a" | - * | + "a" | - * | + + "w" | - * | + "r" | - * | + + "r+" | - * | + + + "w+" | - * | + + + "a+" | - * | + + "a+" | + * | + w | + * | + + a | + * | + a | + * | + + w | + * | + r | + * | + + r+ | + * | + + + w+ | + * | + + + a+ | + * | + + a+ | * +---------------------------------------------------------+ - * | + + "wb" | - * | + + + "ab" | - * | + + "ab" | - * | + + + "wb" | - * | + + "rb" | - * | + + + "r+b" | - * | + + + + "w+b" | - * | + + + + "a+b" | - * | + + + "a+b" | + * | + + wb | + * | + + + ab | + * | + + ab | + * | + + + wb | + * | + + rb | + * | + + + r+b | + * | + + + + w+b | + * | + + + + a+b | + * | + + + a+b | * +---------------------------------------------------------+ */ __filebuf_type* @@ -282,8 +282,9 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * * If no file is currently open, this function immediately fails. * - * If a "put buffer area" exists, @c overflow(eof) is called to flush - * all the characters. The file is then closed. + * If a <em>put buffer area</em> exists, @c overflow(eof) is + * called to flush all the characters. The file is then + * closed. * * If any operations fail, this function also fails. */ @@ -374,9 +375,9 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * This function sets the pointers of the internal buffer, both get * and put areas. Typically: * - * __off == egptr() - eback() upon underflow/uflow ('read' mode); - * __off == 0 upon overflow ('write' mode); - * __off == -1 upon open, setbuf, seekoff/pos ('uncommitted' mode). + * __off == egptr() - eback() upon underflow/uflow (@b read mode); + * __off == 0 upon overflow (@b write mode); + * __off == -1 upon open, setbuf, seekoff/pos (@b uncommitted mode). * * NB: epptr() - pbase() == _M_buf_size - 1, since _M_buf_size * reflects the actual allocated memory and the last cell is reserved diff --git a/libstdc++-v3/include/std/iosfwd b/libstdc++-v3/include/std/iosfwd index b3405d7..9ac72fd 100644 --- a/libstdc++-v3/include/std/iosfwd +++ b/libstdc++-v3/include/std/iosfwd @@ -1,7 +1,7 @@ // Forwarding declarations -*- C++ -*- // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, -// 2006, 2007, 2009 +// 2006, 2007, 2009, 2010 // Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free @@ -64,7 +64,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * should not do it yourself. Instead, include the <iosfwd> * header, which contains only declarations of all the I/O classes as * well as the typedefs. Trying to forward-declare the typedefs - * themselves (e.g., "class ostream;") is not valid ISO C++. + * themselves (e.g., <code>class ostream;</code>) is not valid ISO C++. * * For more specific declarations, see * http://gcc.gnu.org/onlinedocs/libstdc++/manual/bk01pt11ch24.html diff --git a/libstdc++-v3/include/std/iostream b/libstdc++-v3/include/std/iostream index e14c4f3..9212ea8 100644 --- a/libstdc++-v3/include/std/iostream +++ b/libstdc++-v3/include/std/iostream @@ -1,6 +1,6 @@ // Standard iostream objects -*- C++ -*- -// Copyright (C) 1997, 1998, 1999, 2001, 2002, 2005, 2008, 2009 +// Copyright (C) 1997, 1998, 1999, 2001, 2002, 2005, 2008, 2009, 2010 // Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free @@ -50,9 +50,10 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * http://gcc.gnu.org/onlinedocs/libstdc++/manual/bk01pt11ch24.html * and the @link iosfwd I/O forward declarations @endlink * - * They are required by default to cooperate with the global C library's - * @c FILE streams, and to be available during program startup and - * termination. For more information, see the HOWTO linked to above. + * They are required by default to cooperate with the global C + * library's @c FILE streams, and to be available during program + * startup and termination. For more information, see the HOWTO + * linked to above. */ //@{ extern istream cin; ///< Linked to standard input diff --git a/libstdc++-v3/include/std/istream b/libstdc++-v3/include/std/istream index 2d47b0f..f97e1fe 100644 --- a/libstdc++-v3/include/std/istream +++ b/libstdc++-v3/include/std/istream @@ -1,7 +1,7 @@ // Input streams -*- C++ -*- // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, -// 2006, 2007, 2008, 2009 +// 2006, 2007, 2008, 2009, 2010 // Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free @@ -112,8 +112,9 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * @brief Interface for manipulators. * * Manipulators such as @c std::ws and @c std::dec use these - * functions in constructs like "std::cin >> std::ws". For more - * information, see the iomanip header. + * functions in constructs like + * <code>std::cin >> std::ws</code>. + * For more information, see the iomanip header. */ __istream_type& operator>>(__istream_type& (*__pf)(__istream_type&)) @@ -326,7 +327,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * @param n Maximum number of characters to store in @a s. * @return *this * - * Returns @c get(s,n,widen('\n')). + * Returns @c get(s,n,widen('\n')). */ __istream_type& get(char_type* __s, streamsize __n) @@ -359,7 +360,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * @param sb A streambuf in which to store data. * @return *this * - * Returns @c get(sb,widen('\n')). + * Returns @c get(sb,widen('\n')). */ __istream_type& get(__streambuf_type& __sb) @@ -399,7 +400,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * @param n Maximum number of characters to extract. * @return *this * - * Returns @c getline(s,n,widen('\n')). + * Returns @c getline(s,n,widen('\n')). */ __istream_type& getline(char_type* __s, streamsize __n) @@ -624,9 +625,9 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * @brief Performs setup work for input streams. * * Objects of this class are created before all of the standard - * extractors are run. It is responsible for "exception-safe prefix and - * suffix operations," although only prefix actions are currently required - * by the standard. + * extractors are run. It is responsible for <em>exception-safe + * prefix and suffix operations,</em> although only prefix actions + * are currently required by the standard. */ template<typename _CharT, typename _Traits> class basic_istream<_CharT, _Traits>::sentry @@ -648,8 +649,9 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * @param noskipws Whether to consume whitespace or not. * * If the stream state is good (@a is.good() is true), then the - * following actions are performed, otherwise the sentry state is - * false ("not okay") and failbit is set in the stream state. + * following actions are performed, otherwise the sentry state + * is false (<em>not okay</em>) and failbit is set in the + * stream state. * * The sentry's preparatory actions are: * @@ -661,7 +663,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * used to determine whether each character is whitespace. * * If the stream state is still good, then the sentry state becomes - * true ("okay"). + * true (@a okay). */ explicit sentry(basic_istream<_CharT, _Traits>& __is, bool __noskipws = false); @@ -720,9 +722,10 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * status, this function extracts up to @c n characters and stores them * into the array starting at @a s. @c n is defined as: * - * - if @c width() is greater than zero, @c n is width() - * - otherwise @c n is "the number of elements of the largest array of - * @c char_type that can store a terminating @c eos." [27.6.1.2.3]/6 + * - if @c width() is greater than zero, @c n is width() otherwise + * - @c n is <em>the number of elements of the largest array of * + * - @c char_type that can store a terminating @c eos.</em> + * - [27.6.1.2.3]/6 * * Characters are extracted and stored until one of the following happens: * - @c n-1 characters are stored diff --git a/libstdc++-v3/include/std/limits b/libstdc++-v3/include/std/limits index 1f3f078..76a5322 100644 --- a/libstdc++-v3/include/std/limits +++ b/libstdc++-v3/include/std/limits @@ -1,7 +1,7 @@ // The template and inlines for the numeric_limits classes. -*- C++ -*- // Copyright (C) 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, -// 2008, 2009 Free Software Foundation, Inc. +// 2008, 2009, 2010 Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free // software; you can redistribute it and/or modify it under the @@ -200,12 +200,12 @@ _GLIBCXX_BEGIN_NAMESPACE(std) /** True if the type is signed. */ static const bool is_signed = false; /** True if the type is integer. - * Is this supposed to be "if the type is integral"? + * Is this supposed to be <em>if the type is integral?</em> */ static const bool is_integer = false; - /** True if the type uses an exact representation. 'All integer types are + /** True if the type uses an exact representation. <em>All integer types are exact, but not all exact types are integer. For example, rational and - fixed-exponent representations are exact but not integer.' + fixed-exponent representations are exact but not integer.</em> [18.2.1.2]/15 */ static const bool is_exact = false; /** For integer types, specifies the base of the representation. For @@ -229,23 +229,23 @@ _GLIBCXX_BEGIN_NAMESPACE(std) /** True if the type has a representation for positive infinity. */ static const bool has_infinity = false; /** True if the type has a representation for a quiet (non-signaling) - 'Not a Number.' */ + <em>Not a Number</em>. */ static const bool has_quiet_NaN = false; /** True if the type has a representation for a signaling - 'Not a Number.' */ + <em>Not a Number</em>. */ static const bool has_signaling_NaN = false; /** See std::float_denorm_style for more information. */ static const float_denorm_style has_denorm = denorm_absent; - /** 'True if loss of accuracy is detected as a denormalization loss, - rather than as an inexact result.' [18.2.1.2]/42 */ + /** <em>True if loss of accuracy is detected as a denormalization loss, + rather than as an inexact result.</em> [18.2.1.2]/42 */ static const bool has_denorm_loss = false; /** True if-and-only-if the type adheres to the IEC 559 standard, also known as IEEE 754. (Only makes sense for floating point types.) */ static const bool is_iec559 = false; - /** 'True if the set of values representable by the type is finite. All - built-in types are bounded, this member would be false for arbitrary - precision types.' [18.2.1.2]/54 */ + /** <em>True if the set of values representable by the type is + finite. All built-in types are bounded, this member would be + false for arbitrary precision types.</em> [18.2.1.2]/54 */ static const bool is_bounded = false; /** True if the type is @e modulo, that is, if it is possible to add two positive numbers and have a result that wraps around to a third number @@ -289,9 +289,11 @@ _GLIBCXX_BEGIN_NAMESPACE(std) static _Tp round_error() throw() { return static_cast<_Tp>(0); } /** The representation of positive infinity, if @c has_infinity. */ static _Tp infinity() throw() { return static_cast<_Tp>(0); } - /** The representation of a quiet "Not a Number," if @c has_quiet_NaN. */ + + /** The representation of a quiet <em>Not a Number</em>, + if @c has_quiet_NaN. */ static _Tp quiet_NaN() throw() { return static_cast<_Tp>(0); } - /** The representation of a signaling "Not a Number," if + /** The representation of a signaling <em>Not a Number</em>, if @c has_signaling_NaN. */ static _Tp signaling_NaN() throw() { return static_cast<_Tp>(0); } /** The minimum positive denormalized value. For types where diff --git a/libstdc++-v3/include/std/ostream b/libstdc++-v3/include/std/ostream index d6241ba..17426f4 100644 --- a/libstdc++-v3/include/std/ostream +++ b/libstdc++-v3/include/std/ostream @@ -1,7 +1,7 @@ // Output streams -*- C++ -*- // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, -// 2006, 2007, 2008, 2009 +// 2006, 2007, 2008, 2009, 2010 // Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free @@ -370,8 +370,8 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * @brief Performs setup work for output streams. * * Objects of this class are created before all of the standard - * inserters are run. It is responsible for "exception-safe prefix and - * suffix operations." + * inserters are run. It is responsible for <em>exception-safe prefix and + * suffix operations</em>. */ template <typename _CharT, typename _Traits> class basic_ostream<_CharT, _Traits>::sentry @@ -390,7 +390,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * is called to synchronize the output sequences. * * If the stream state is still good, then the sentry state becomes - * true ("okay"). + * true (@a okay). */ explicit sentry(basic_ostream<_CharT, _Traits>& __os); @@ -544,7 +544,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) /** * @brief Write a null character into the output sequence. * - * "Null character" is @c CharT() by definition. For CharT of @c char, + * <em>Null character</em> is @c CharT() by definition. For CharT of @c char, * this correctly writes the ASCII @c NUL character string terminator. */ template<typename _CharT, typename _Traits> diff --git a/libstdc++-v3/include/std/sstream b/libstdc++-v3/include/std/sstream index 0ebf506..f000ac0 100644 --- a/libstdc++-v3/include/std/sstream +++ b/libstdc++-v3/include/std/sstream @@ -1,7 +1,7 @@ // String based streams -*- C++ -*- // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, -// 2006, 2008, 2009 Free Software Foundation, Inc. +// 2006, 2008, 2009, 2010 Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free // software; you can redistribute it and/or modify it under the @@ -112,9 +112,9 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * @brief Copying out the string buffer. * @return A copy of one of the underlying sequences. * - * 'If the buffer is only created in input mode, the underlying + * <em>If the buffer is only created in input mode, the underlying * character sequence is equal to the input sequence; otherwise, it - * is equal to the output sequence.' [27.7.1.2]/1 + * is equal to the output sequence.</em> [27.7.1.2]/1 */ __string_type str() const diff --git a/libstdc++-v3/include/std/streambuf b/libstdc++-v3/include/std/streambuf index 7d6b8c7..ac8767e 100644 --- a/libstdc++-v3/include/std/streambuf +++ b/libstdc++-v3/include/std/streambuf @@ -1,7 +1,7 @@ // Stream buffer classes -*- C++ -*- // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, -// 2006, 2007, 2008, 2009 Free Software Foundation, Inc. +// 2006, 2007, 2008, 2009, 2010 Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free // software; you can redistribute it and/or modify it under the @@ -79,7 +79,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * represents, at any moment, a (sub)sequence of characters from the * sequence. Operations performed on a sequence alter the values * stored in these pointers, perform reads and writes directly to or - * from associated sequences, and alter "the stream position" and + * from associated sequences, and alter <em>the stream position</em> and * conversion state as needed to maintain this subsequence relationship. * The three pointers are: * - the <em>beginning pointer</em>, or lowest element address in the @@ -340,9 +340,10 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * @param c The character to push back. * @return The previous character, if possible. * - * Similar to sungetc(), but @a c is pushed onto the stream instead - * of 'the previous character.' If successful, the next character - * fetched from the input stream will be @a c. + * Similar to sungetc(), but @a c is pushed onto the stream + * instead of <em>the previous character.</em> If successful, + * the next character fetched from the input stream will be @a + * c. */ int_type sputbackc(char_type __c) @@ -364,10 +365,10 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * @brief Moving backwards in the input stream. * @return The previous character, if possible. * - * If a putback position is available, this function decrements the - * input pointer and returns that character. Otherwise, calls and - * returns pbackfail(). The effect is to 'unget' the last character - * 'gotten.' + * If a putback position is available, this function decrements + * the input pointer and returns that character. Otherwise, + * calls and returns pbackfail(). The effect is to @a unget + * the last character @a gotten. */ int_type sungetc() @@ -540,11 +541,11 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * @brief Changes translations. * @param loc A new locale. * - * Translations done during I/O which depend on the current locale - * are changed by this call. The standard adds, 'Between invocations - * of this function a class derived from streambuf can safely cache - * results of calls to locale functions and to members of facets - * so obtained.' + * Translations done during I/O which depend on the current + * locale are changed by this call. The standard adds, + * <em>Between invocations of this function a class derived + * from streambuf can safely cache results of calls to locale + * functions and to members of facets so obtained.</em> * * @note Base class version does nothing. */ @@ -596,7 +597,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * @return -1 on failure. * * Each derived class provides its own appropriate behavior, - * including the definition of "failure". + * including the definition of @a failure. * @note Base class version does nothing, returns zero. */ virtual int @@ -608,18 +609,18 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * @return An estimate of the number of characters available in the * input sequence, or -1. * - * 'If it returns a positive value, then successive calls to - * @c underflow() will not return @c traits::eof() until at least that - * number of characters have been supplied. If @c showmanyc() - * returns -1, then calls to @c underflow() or @c uflow() will fail.' - * [27.5.2.4.3]/1 + * <em>If it returns a positive value, then successive calls to + * @c underflow() will not return @c traits::eof() until at + * least that number of characters have been supplied. If @c + * showmanyc() returns -1, then calls to @c underflow() or @c + * uflow() will fail.</em> [27.5.2.4.3]/1 * * @note Base class version does nothing, returns zero. - * @note The standard adds that 'the intention is not only that the + * @note The standard adds that <em>the intention is not only that the * calls [to underflow or uflow] will not return @c eof() but - * that they will return immediately.' - * @note The standard adds that 'the morphemes of @c showmanyc are - * 'es-how-many-see', not 'show-manic'.' + * that they will return immediately.</em> + * @note The standard adds that <em>the morphemes of @c showmanyc are + * @b es-how-many-see, not @b show-manic.</em> */ virtual streamsize showmanyc() { return 0; } @@ -646,7 +647,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * * Informally, this function is called when the input buffer is * exhausted (or does not exist, as buffering need not actually be - * done). If a buffer exists, it is 'refilled'. In either case, the + * done). If a buffer exists, it is @a refilled. In either case, the * next available character is returned, or @c traits::eof() to * indicate a null pending sequence. * @@ -690,7 +691,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) /** * @brief Tries to back up the input sequence. * @param c The character to be inserted back into the sequence. - * @return eof() on failure, 'some other value' on success + * @return eof() on failure, <em>some other value</em> on success * @post The constraints of @c gptr(), @c eback(), and @c pptr() * are the same as for @c underflow(). * @@ -724,11 +725,12 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * @return eof() to indicate failure, something else (usually * @a c, or not_eof()) * - * Informally, this function is called when the output buffer is full - * (or does not exist, as buffering need not actually be done). If a - * buffer exists, it is 'consumed', with 'some effect' on the - * controlled sequence. (Typically, the buffer is written out to the - * sequence verbatim.) In either case, the character @a c is also + * Informally, this function is called when the output buffer + * is full (or does not exist, as buffering need not actually + * be done). If a buffer exists, it is @a consumed, with + * <em>some effect</em> on the controlled sequence. + * (Typically, the buffer is written out to the sequence + * verbatim.) In either case, the character @a c is also * written out, if @a c is not @c eof(). * * For a formal definition of this function, see a good text diff --git a/libstdc++-v3/include/tr1/functional b/libstdc++-v3/include/tr1/functional index 2052f88..7bc0d5e 100644 --- a/libstdc++-v3/include/tr1/functional +++ b/libstdc++-v3/include/tr1/functional @@ -1,6 +1,7 @@ // TR1 functional header -*- C++ -*- -// Copyright (C) 2004, 2005, 2006, 2007, 2009 Free Software Foundation, Inc. +// Copyright (C) 2004, 2005, 2006, 2007, 2009, 2010 +// Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free // software; you can redistribute it and/or modify it under the @@ -1383,7 +1384,7 @@ namespace tr1 struct _M_clear_type; /** - * Trait identifying "location-invariant" types, meaning that the + * Trait identifying @a location-invariant types, meaning that the * address of the object (or any of its members) will not escape. * Also implies a trivial copy constructor and assignment operator. */ diff --git a/libstdc++-v3/include/tr1/hypergeometric.tcc b/libstdc++-v3/include/tr1/hypergeometric.tcc index c975afa..c53fb8e 100644 --- a/libstdc++-v3/include/tr1/hypergeometric.tcc +++ b/libstdc++-v3/include/tr1/hypergeometric.tcc @@ -1,6 +1,6 @@ // Special functions -*- C++ -*- -// Copyright (C) 2006, 2007, 2008, 2009 +// Copyright (C) 2006, 2007, 2008, 2009, 2010 // Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free @@ -64,9 +64,10 @@ namespace tr1 * \frac{x^n}{n!} * @f] * - * If a and b are integers and a < 0 and either b > 0 or b < a then the - * series is a polynomial with a finite number of terms. If b is an integer - * and b <= 0 the confluent hypergeometric function is undefined. + * If a and b are integers and a < 0 and either b > 0 or b < a + * then the series is a polynomial with a finite number of + * terms. If b is an integer and b <= 0 the confluent + * hypergeometric function is undefined. * * @param __a The "numerator" parameter. * @param __c The "denominator" parameter. @@ -212,8 +213,8 @@ namespace tr1 * * @todo Handle b == nonpositive integer blowup - return NaN. * - * @param __a The "numerator" parameter. - * @param __c The "denominator" parameter. + * @param __a The @a numerator parameter. + * @param __c The @a denominator parameter. * @param __x The argument of the confluent hypergeometric function. * @return The confluent hypergeometric function. */ @@ -255,9 +256,9 @@ namespace tr1 * * This works and it's pretty fast. * - * @param __a The first "numerator" parameter. - * @param __a The second "numerator" parameter. - * @param __c The "denominator" parameter. + * @param __a The first @a numerator parameter. + * @param __a The second @a numerator parameter. + * @param __c The @a denominator parameter. * @param __x The argument of the confluent hypergeometric function. * @return The confluent hypergeometric function. */ @@ -401,10 +402,11 @@ namespace tr1 /** - * @brief Return the hypogeometric function @f$ _2F_1(a,b;c;x) @f$ by the reflection - * formulae in Abramowitz & Stegun formula 15.3.6 for d = c - a - b not integral - * and formula 15.3.11 for d = c - a - b integral. - * This assumes a, b, c != negative integer. + * @brief Return the hypogeometric function @f$ _2F_1(a,b;c;x) @f$ + * by the reflection formulae in Abramowitz & Stegun formula + * 15.3.6 for d = c - a - b not integral and formula 15.3.11 for + * d = c - a - b integral. This assumes a, b, c != negative + * integer. * * The hypogeometric function is defined by * @f[ @@ -504,8 +506,8 @@ namespace tr1 } if (__ln_pre1 > __log_max) - std::__throw_runtime_error(__N("Overflow of gamma functions " - "in __hyperg_luke.")); + std::__throw_runtime_error(__N("Overflow of gamma functions" + " in __hyperg_luke.")); else __F1 = std::exp(__ln_pre1) * __sum1; } @@ -551,7 +553,8 @@ namespace tr1 int __j; for (__j = 1; __j < __maxiter; ++__j) { - // Values for psi functions use recurrence; Abramowitz & Stegun 6.3.5 + // Values for psi functions use recurrence; + // Abramowitz & Stegun 6.3.5 const _Tp __term1 = _Tp(1) / _Tp(__j) + _Tp(1) / (__ad + __j); const _Tp __term2 = _Tp(1) / (__a + __d1 + _Tp(__j - 1)) @@ -713,9 +716,9 @@ namespace tr1 * \frac{x^n}{n!} * @f] * - * @param __a The first "numerator" parameter. - * @param __a The second "numerator" parameter. - * @param __c The "denominator" parameter. + * @param __a The first @a numerator parameter. + * @param __a The second @a numerator parameter. + * @param __c The @a denominator parameter. * @param __x The argument of the confluent hypergeometric function. * @return The confluent hypergeometric function. */ @@ -748,7 +751,8 @@ namespace tr1 return __hyperg_series(__a, __b, __c, __x); else if (std::abs(__a) < _Tp(10) && std::abs(__b) < _Tp(10)) { - // For integer a and b the hypergeometric function is a finite polynomial. + // For integer a and b the hypergeometric function is a + // finite polynomial. if (__a < _Tp(0) && std::abs(__a - __a_nint) < __toler) return __hyperg_series(__a_nint, __b, __c, __x); else if (__b < _Tp(0) && std::abs(__b - __b_nint) < __toler) diff --git a/libstdc++-v3/include/tr1/random.h b/libstdc++-v3/include/tr1/random.h index 8a0ddeb..0d43c85 100644 --- a/libstdc++-v3/include/tr1/random.h +++ b/libstdc++-v3/include/tr1/random.h @@ -1,6 +1,6 @@ // random number generation -*- C++ -*- -// Copyright (C) 2009 Free Software Foundation, Inc. +// Copyright (C) 2009, 2010 Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free // software; you can redistribute it and/or modify it under the @@ -683,8 +683,8 @@ namespace tr1 * The classic Mersenne Twister. * * Reference: - * M. Matsumoto and T. Nishimura, "Mersenne Twister: A 623-Dimensionally - * Equidistributed Uniform Pseudo-Random Number Generator", ACM Transactions + * M. Matsumoto and T. Nishimura, Mersenne Twister: A 623-Dimensionally + * Equidistributed Uniform Pseudo-Random Number Generator, ACM Transactions * on Modeling and Computer Simulation, Vol. 8, No. 1, January 1998, pp 3-30. */ typedef mersenne_twister< @@ -708,8 +708,8 @@ namespace tr1 * The size of the state is @f$ r @f$ * and the maximum period of the generator is @f$ m^r - m^s -1 @f$. * - * N1688[4.13] says "the template parameter _IntType shall denote an integral - * type large enough to store values up to m." + * N1688[4.13] says <em>the template parameter _IntType shall denote + * an integral type large enough to store values up to m</em>. * * @var _M_x The state of the generator. This is a ring buffer. * @var _M_carry The carry. diff --git a/libstdc++-v3/include/tr1/random.tcc b/libstdc++-v3/include/tr1/random.tcc index 818777d..f458cc7 100644 --- a/libstdc++-v3/include/tr1/random.tcc +++ b/libstdc++-v3/include/tr1/random.tcc @@ -1,6 +1,6 @@ // random number generation (out of line) -*- C++ -*- -// Copyright (C) 2009 Free Software Foundation, Inc. +// Copyright (C) 2009, 2010 Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free // software; you can redistribute it and/or modify it under the @@ -1060,7 +1060,7 @@ namespace tr1 * is defined. * * Reference: - * Devroye, L. "Non-Uniform Random Variates Generation." Springer-Verlag, + * Devroye, L. Non-Uniform Random Variates Generation. Springer-Verlag, * New York, 1986, Ch. X, Sects. 3.3 & 3.4 (+ Errata!). */ template<typename _IntType, typename _RealType> @@ -1285,7 +1285,7 @@ namespace tr1 * is defined. * * Reference: - * Devroye, L. "Non-Uniform Random Variates Generation." Springer-Verlag, + * Devroye, L. Non-Uniform Random Variates Generation. Springer-Verlag, * New York, 1986, Ch. X, Sect. 4 (+ Errata!). */ template<typename _IntType, typename _RealType> @@ -1514,7 +1514,7 @@ namespace tr1 /** * Polar method due to Marsaglia. * - * Devroye, L. "Non-Uniform Random Variates Generation." Springer-Verlag, + * Devroye, L. Non-Uniform Random Variates Generation. Springer-Verlag, * New York, 1986, Ch. V, Sect. 4.4. */ template<typename _RealType> @@ -1618,14 +1618,14 @@ namespace tr1 * alpha < 1. * * References: - * Cheng, R. C. "The Generation of Gamma Random Variables with Non-integral - * Shape Parameter." Applied Statistics, 26, 71-75, 1977. + * Cheng, R. C. The Generation of Gamma Random Variables with Non-integral + * Shape Parameter. Applied Statistics, 26, 71-75, 1977. * - * Vaduva, I. "Computer Generation of Gamma Gandom Variables by Rejection - * and Composition Procedures." Math. Operationsforschung and Statistik, + * Vaduva, I. Computer Generation of Gamma Gandom Variables by Rejection + * and Composition Procedures. Math. Operationsforschung and Statistik, * Series in Statistics, 8, 545-576, 1977. * - * Devroye, L. "Non-Uniform Random Variates Generation." Springer-Verlag, + * Devroye, L. Non-Uniform Random Variates Generation. Springer-Verlag, * New York, 1986, Ch. IX, Sect. 3.4 (+ Errata!). */ template<typename _RealType> diff --git a/libstdc++-v3/include/tr1_impl/regex b/libstdc++-v3/include/tr1_impl/regex index 8df62c2..6a4567b 100644 --- a/libstdc++-v3/include/tr1_impl/regex +++ b/libstdc++-v3/include/tr1_impl/regex @@ -1,6 +1,6 @@ // class template regex -*- C++ -*- -// Copyright (C) 2007, 2008, 2009 Free Software Foundation, Inc. +// Copyright (C) 2007, 2008, 2009, 2010 Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free // software; you can redistribute it and/or modify it under the @@ -262,9 +262,9 @@ namespace regex_constants * Format strings (from ECMA-262 [15.5.4.11]): * @li $$ The dollar-sign itself ($) * @li $& The matched substring. - * @li $` The portion of <em>string</em> that precedes the matched substring. + * @li $` The portion of @a string that precedes the matched substring. * This would be match_results::prefix(). - * @li $' The portion of <em>string</em> that follows the matched substring. + * @li $' The portion of @a string that follows the matched substring. * This would be match_results::suffix(). * @li $n The nth capture, where n is in [1,9] and $n is not followed by a * decimal digit. If n <= match_results::size() and the nth capture |