diff options
Diffstat (limited to 'libstdc++-v3/doc/xml/manual/intro.xml')
| -rw-r--r-- | libstdc++-v3/doc/xml/manual/intro.xml | 310 |
1 files changed, 147 insertions, 163 deletions
diff --git a/libstdc++-v3/doc/xml/manual/intro.xml b/libstdc++-v3/doc/xml/manual/intro.xml index a6dff4daf15..705119b6d3e 100644 --- a/libstdc++-v3/doc/xml/manual/intro.xml +++ b/libstdc++-v3/doc/xml/manual/intro.xml @@ -1,12 +1,10 @@ -<?xml version='1.0'?> -<!DOCTYPE part PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" - "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" -[ ]> - -<part id="manual.intro" xreflabel="Introduction"> +<part xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="manual.intro" xreflabel="Introduction"> <?dbhtml filename="intro.html"?> -<partinfo> +<info><title> + Introduction + <indexterm><primary>Introduction</primary></indexterm> +</title> <keywordset> <keyword> ISO C++ @@ -15,75 +13,65 @@ library </keyword> </keywordset> -</partinfo> +</info> + -<title> - Introduction - <indexterm><primary>Introduction</primary></indexterm> -</title> <!-- Chapter 01 : Status --> -<chapter id="manual.intro.status" xreflabel="Status"> +<chapter xml:id="manual.intro.status" xreflabel="Status"><info><title>Status</title></info> <?dbhtml filename="status.html"?> - <title>Status</title> + <!-- Section 01 : Implementation Status --> - <sect1 id="manual.intro.status.iso" xreflabel="Status"> - <title>Implementation Status</title> + <section xml:id="manual.intro.status.iso" xreflabel="Status"><info><title>Implementation Status</title></info> + <!-- Section 01.1 : Status C++ 1998 --> - <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" - parse="xml" href="status_cxx1998.xml"> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" parse="xml" href="status_cxx1998.xml"> </xi:include> <!-- Section 01.2 : Status C++ 200x --> - <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" - parse="xml" href="status_cxx200x.xml"> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" parse="xml" href="status_cxx200x.xml"> </xi:include> <!-- Section 01.3 : Status C++ TR1 --> - <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" - parse="xml" href="status_cxxtr1.xml"> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" parse="xml" href="status_cxxtr1.xml"> </xi:include> <!-- Section 01.4 : Status C++ TR24733 --> - <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" - parse="xml" href="status_cxxtr24733.xml"> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" parse="xml" href="status_cxxtr24733.xml"> </xi:include> - </sect1> + </section> <!-- Section 02 : License --> - <sect1 id="manual.intro.status.license" xreflabel="License"> + <section xml:id="manual.intro.status.license" xreflabel="License"><info><title>License</title></info> <?dbhtml filename="license.html"?> - <title>License</title> + <para> There are two licenses affecting GNU libstdc++: one for the code, and one for the documentation. </para> <para> - There is a license section in the FAQ regarding common <link - linkend="faq.license">questions</link>. If you have more - questions, ask the FSF or the <ulink - url="http://gcc.gnu.org/lists.html">gcc mailing list</ulink>. + There is a license section in the FAQ regarding common <link linkend="faq.license">questions</link>. If you have more + questions, ask the FSF or the <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://gcc.gnu.org/lists.html">gcc mailing list</link>. </para> - <sect2 id="manual.intro.status.license.gpl" xreflabel="License GPL"> - <title>The Code: GPL</title> + <section xml:id="manual.intro.status.license.gpl" xreflabel="License GPL"><info><title>The Code: GPL</title></info> + <para> - The source code is distributed under the <link - linkend="appendix.gpl-3.0">GNU General Public License version 3</link>, + The source code is distributed under the <link linkend="appendix.gpl-3.0">GNU General Public License version 3</link>, with the addition under section 7 of an exception described in the <quote>GCC Runtime Library Exception, version 3.1</quote> as follows (or see the file COPYING.RUNTIME): </para> - <literallayout> + <literallayout class="normal"> GCC RUNTIME LIBRARY EXCEPTION Version 3.1, 31 March 2009 -Copyright (C) 2009 <ulink url="http://www.fsf.org">Free Software Foundation, Inc.</ulink> +Copyright (C) 2009 <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.fsf.org">Free Software Foundation, Inc.</link> Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. @@ -157,10 +145,10 @@ requirements of the license of GCC. Hopefully that text is self-explanatory. If it isn't, you need to speak to your lawyer, or the Free Software Foundation. </para> - </sect2> + </section> - <sect2 id="manual.intro.status.license.fdl" xreflabel="License FDL"> - <title>The Documentation: GPL, FDL</title> + <section xml:id="manual.intro.status.license.fdl" xreflabel="License FDL"><info><title>The Documentation: GPL, FDL</title></info> + <para> The documentation shipped with the library and made available over @@ -182,27 +170,26 @@ requirements of the license of GCC. If you plan on making copies of the documentation, please let us know. We can probably offer suggestions. </para> - </sect2> + </section> - </sect1> + </section> <!-- Section 03 : Known Bugs --> - <sect1 id="manual.intro.status.bugs" xreflabel="Bugs"> + <section xml:id="manual.intro.status.bugs" xreflabel="Bugs"><info><title>Bugs</title></info> <?dbhtml filename="bugs.html"?> - <title>Bugs</title> + - <sect2 id="manual.intro.status.bugs.impl" xreflabel="Bugs impl"> - <title>Implementation Bugs</title> + <section xml:id="manual.intro.status.bugs.impl" xreflabel="Bugs impl"><info><title>Implementation Bugs</title></info> + <para> Information on known bugs, details on efforts to fix them, and - fixed bugs are all available as part of the <ulink - url="http://gcc.gnu.org/bugs/">GCC bug tracking system</ulink>, + fixed bugs are all available as part of the <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://gcc.gnu.org/bugs/">GCC bug tracking system</link>, with the category set to <literal>libstdc++</literal>. </para> - </sect2> + </section> - <sect2 id="manual.intro.status.bugs.iso" xreflabel="Bugs iso"> - <title>Standard Bugs</title> + <section xml:id="manual.intro.status.bugs.iso" xreflabel="Bugs iso"><info><title>Standard Bugs</title></info> + <para> Everybody's got issues. Even the C++ Standard Library. </para> @@ -216,10 +203,10 @@ requirements of the license of GCC. Here are the issues which have resulted in code changes to the library. The links are to the specific defect reports from a <emphasis>partial copy</emphasis> of the Issues List. You can read the full version online - at the <ulink url="http://www.open-std.org/jtc1/sc22/wg21/">ISO C++ - Committee homepage</ulink>, linked to on the - <ulink url="http://gcc.gnu.org/readings.html">GCC "Readings" - page</ulink>. If + at the <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.open-std.org/jtc1/sc22/wg21/">ISO C++ + Committee homepage</link>, linked to on the + <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://gcc.gnu.org/readings.html">GCC "Readings" + page</link>. If you spend a lot of time reading the issues, we recommend downloading the ZIP file and reading them locally. </para> @@ -237,116 +224,116 @@ requirements of the license of GCC. and src directories for appearances of <constant>_GLIBCXX_RESOLVE_LIB_DEFECTS</constant> for examples of style. Note that we usually do not make changes to the - code until an issue has reached <ulink url="../ext/lwg-active.html#DR">DR</ulink> status. + code until an issue has reached <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-active.html#DR">DR</link> status. </para> <variablelist> - <varlistentry><term><ulink url="../ext/lwg-defects.html#5">5</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#5">5</link>: <emphasis>string::compare specification questionable</emphasis> </term> <listitem><para>This should be two overloaded functions rather than a single function. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#17">17</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#17">17</link>: <emphasis>Bad bool parsing</emphasis> </term> <listitem><para>Apparently extracting Boolean values was messed up... </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#19">19</ulink>: - <emphasis>"Noconv" definition too vague</emphasis> + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#19">19</link>: + <emphasis>"Noconv" definition too vague</emphasis> </term> <listitem><para>If <code>codecvt::do_in</code> returns <code>noconv</code> there are no changes to the values in <code>[to, to_limit)</code>. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#22">22</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#22">22</link>: <emphasis>Member open vs flags</emphasis> </term> <listitem><para>Re-opening a file stream does <emphasis>not</emphasis> clear the state flags. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#23">23</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#23">23</link>: <emphasis>Num_get overflow result</emphasis> </term> <listitem><para>Implement the proposed resolution. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#25">25</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#25">25</link>: <emphasis>String operator<< uses width() value wrong</emphasis> </term> <listitem><para>Padding issues. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#48">48</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#48">48</link>: <emphasis>Use of non-existent exception constructor</emphasis> </term> <listitem><para>An instance of <code>ios_base::failure</code> is constructed instead. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#49">49</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#49">49</link>: <emphasis>Underspecification of ios_base::sync_with_stdio</emphasis> </term> <listitem><para>The return type is the <emphasis>previous</emphasis> state of synchronization. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#50">50</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#50">50</link>: <emphasis>Copy constructor and assignment operator of ios_base</emphasis> </term> <listitem><para>These members functions are declared <code>private</code> and are thus inaccessible. Specifying the correct semantics of - "copying stream state" was deemed too complicated. + "copying stream state" was deemed too complicated. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#60">60</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#60">60</link>: <emphasis>What is a formatted input function?</emphasis> </term> <listitem><para>This DR made many widespread changes to <code>basic_istream</code> and <code>basic_ostream</code> all of which have been implemented. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#63">63</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#63">63</link>: <emphasis>Exception-handling policy for unformatted output</emphasis> </term> <listitem><para>Make the policy consistent with that of formatted input, unformatted input, and formatted output. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#68">68</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#68">68</link>: <emphasis>Extractors for char* should store null at end</emphasis> </term> <listitem><para>And they do now. An editing glitch in the last item in the list of [27.6.1.2.3]/7. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#74">74</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#74">74</link>: <emphasis>Garbled text for codecvt::do_max_length</emphasis> </term> <listitem><para>The text of the standard was gibberish. Typos gone rampant. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#75">75</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#75">75</link>: <emphasis>Contradiction in codecvt::length's argument types</emphasis> </term> <listitem><para>Change the first parameter to <code>stateT&</code> and implement the new effects paragraph. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#83">83</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#83">83</link>: <emphasis>string::npos vs. string::max_size()</emphasis> </term> <listitem><para>Safety checks on the size of the string should test against <code>max_size()</code> rather than <code>npos</code>. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#90">90</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#90">90</link>: <emphasis>Incorrect description of operator>> for strings</emphasis> </term> <listitem><para>The effect contain <code>isspace(c,getloc())</code> which must be replaced by <code>isspace(c,is.getloc())</code>. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#91">91</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#91">91</link>: <emphasis>Description of operator>> and getline() for string<> might cause endless loop</emphasis> </term> @@ -355,7 +342,7 @@ requirements of the license of GCC. not required to set <code>gcount</code>). </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#103">103</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#103">103</link>: <emphasis>set::iterator is required to be modifiable, but this allows modification of keys.</emphasis> </term> @@ -364,14 +351,14 @@ requirements of the license of GCC. </code> are constant iterators. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#109">109</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#109">109</link>: <emphasis>Missing binders for non-const sequence elements</emphasis> </term> <listitem><para>The <code>binder1st</code> and <code>binder2nd</code> didn't have an <code>operator()</code> taking a non-const parameter. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#110">110</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#110">110</link>: <emphasis>istreambuf_iterator::equal not const</emphasis> </term> <listitem><para>This was not a const member function. Note that the DR says to @@ -379,31 +366,31 @@ requirements of the license of GCC. overloaded version with identical contents. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#117">117</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#117">117</link>: <emphasis>basic_ostream uses nonexistent num_put member functions</emphasis> </term> <listitem><para><code>num_put::put()</code> was overloaded on the wrong types. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#118">118</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#118">118</link>: <emphasis>basic_istream uses nonexistent num_get member functions</emphasis> </term> <listitem><para>Same as 117, but for <code>num_get::get()</code>. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#129">129</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#129">129</link>: <emphasis>Need error indication from seekp() and seekg()</emphasis> </term> <listitem><para>These functions set <code>failbit</code> on error now. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#130">130</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#130">130</link>: <emphasis>Return type of container::erase(iterator) differs for associative containers</emphasis> </term> <listitem><para>Make member <code>erase</code> return iterator for <code>set</code>, <code>multiset</code>, <code>map</code>, <code>multimap</code>. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#136">136</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#136">136</link>: <emphasis>seekp, seekg setting wrong streams?</emphasis> </term> <listitem><para><code>seekp</code> should only set the output stream, and @@ -417,46 +404,46 @@ requirements of the license of GCC. should probably not be calling <code>underflow()</code>. </para></listitem></varlistentry> --> - <varlistentry><term><ulink url="../ext/lwg-defects.html#167">167</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#167">167</link>: <emphasis>Improper use of traits_type::length()</emphasis> </term> <listitem><para><code>op<<</code> with a <code>const char*</code> was calculating an incorrect number of characters to write. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#169">169</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#169">169</link>: <emphasis>Bad efficiency of overflow() mandated</emphasis> </term> <listitem><para>Grow efficiently the internal array object. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#171">171</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#171">171</link>: <emphasis>Strange seekpos() semantics due to joint position</emphasis> </term> <listitem><para>Quite complex to summarize... </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#181">181</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#181">181</link>: <emphasis>make_pair() unintended behavior</emphasis> </term> <listitem><para>This function used to take its arguments as reference-to-const, now it copies them (pass by value). </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#195">195</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#195">195</link>: <emphasis>Should basic_istream::sentry's constructor ever set eofbit?</emphasis> </term> <listitem><para>Yes, it can, specifically if EOF is reached while skipping whitespace. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#211">211</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#211">211</link>: <emphasis>operator>>(istream&, string&) doesn't set failbit</emphasis> </term> <listitem><para>If nothing is extracted into the string, <code>op>></code> now sets <code>failbit</code> (which can cause an exception, etc., etc.). </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#214">214</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#214">214</link>: <emphasis>set::find() missing const overload</emphasis> </term> <listitem><para>Both <code>set</code> and <code>multiset</code> were missing @@ -464,47 +451,47 @@ requirements of the license of GCC. for const instances. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#231">231</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#231">231</link>: <emphasis>Precision in iostream?</emphasis> </term> <listitem><para>For conversion from a floating-point type, <code>str.precision()</code> is specified in the conversion specification. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#233">233</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#233">233</link>: <emphasis>Insertion hints in associative containers</emphasis> </term> <listitem><para>Implement N1780, first check before then check after, insert as close to hint as possible. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#235">235</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#235">235</link>: <emphasis>No specification of default ctor for reverse_iterator</emphasis> </term> <listitem><para>The declaration of <code>reverse_iterator</code> lists a default constructor. However, no specification is given what this constructor should do. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#241">241</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#241">241</link>: <emphasis>Does unique_copy() require CopyConstructible and Assignable?</emphasis> </term> <listitem><para>Add a helper for forward_iterator/output_iterator, fix the existing one for input_iterator/output_iterator to not rely on Assignability. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#243">243</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#243">243</link>: <emphasis>get and getline when sentry reports failure</emphasis> </term> <listitem><para>Store a null character only if the character array has a non-zero size. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#251">251</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#251">251</link>: <emphasis>basic_stringbuf missing allocator_type</emphasis> </term> <listitem><para>This nested typedef was originally not specified. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#253">253</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#253">253</link>: <emphasis>valarray helper functions are almost entirely useless</emphasis> </term> <listitem><para>Make the copy constructor and copy-assignment operator declarations @@ -512,60 +499,60 @@ requirements of the license of GCC. definitions. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#265">265</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#265">265</link>: <emphasis>std::pair::pair() effects overly restrictive</emphasis> </term> <listitem><para>The default ctor would build its members from copies of temporaries; now it simply uses their respective default ctors. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#266">266</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#266">266</link>: <emphasis>bad_exception::~bad_exception() missing Effects clause</emphasis> </term> <listitem><para>The <code>bad_</code>* classes no longer have destructors (they are trivial), since no description of them was ever given. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#271">271</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#271">271</link>: <emphasis>basic_iostream missing typedefs</emphasis> </term> <listitem><para>The typedefs it inherits from its base classes can't be used, since (for example) <code>basic_iostream<T>::traits_type</code> is ambiguous. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#275">275</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#275">275</link>: <emphasis>Wrong type in num_get::get() overloads</emphasis> </term> <listitem><para>Similar to 118. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#280">280</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#280">280</link>: <emphasis>Comparison of reverse_iterator to const reverse_iterator</emphasis> </term> <listitem><para>Add global functions with two template parameters. (NB: not added for now a templated assignment operator) </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#292">292</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#292">292</link>: <emphasis>Effects of a.copyfmt (a)</emphasis> </term> <listitem><para>If <code>(this == &rhs)</code> do nothing. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#300">300</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#300">300</link>: <emphasis>List::merge() specification incomplete</emphasis> </term> <listitem><para>If <code>(this == &x)</code> do nothing. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#303">303</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#303">303</link>: <emphasis>Bitset input operator underspecified</emphasis> </term> <listitem><para>Basically, compare the input character to <code>is.widen(0)</code> and <code>is.widen(1)</code>. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#305">305</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#305">305</link>: <emphasis>Default behavior of codecvt<wchar_t, char, mbstate_t>::length()</emphasis> </term> @@ -573,20 +560,20 @@ requirements of the license of GCC. mbstate_t>::do_length</code> must return. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#328">328</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#328">328</link>: <emphasis>Bad sprintf format modifier in money_put<>::do_put()</emphasis> </term> - <listitem><para>Change the format string to "%.0Lf". + <listitem><para>Change the format string to "%.0Lf". </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#365">365</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#365">365</link>: <emphasis>Lack of const-qualification in clause 27</emphasis> </term> <listitem><para>Add const overloads of <code>is_open</code>. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#387">387</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#387">387</link>: <emphasis>std::complex over-encapsulated</emphasis> </term> <listitem><para>Add the <code>real(T)</code> and <code>imag(T)</code> @@ -595,26 +582,26 @@ requirements of the license of GCC. free functions. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#389">389</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#389">389</link>: <emphasis>Const overload of valarray::operator[] returns by value</emphasis> </term> <listitem><para>Change it to return a <code>const T&</code>. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#396">396</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#396">396</link>: <emphasis>what are characters zero and one</emphasis> </term> <listitem><para>Implement the proposed resolution. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#402">402</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#402">402</link>: <emphasis>Wrong new expression in [some_]allocator::construct</emphasis> </term> - <listitem><para>Replace "new" with "::new". + <listitem><para>Replace "new" with "::new". </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-active.html#408">408</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-active.html#408">408</link>: <emphasis> Is vector<reverse_iterator<char*> > forbidden? </emphasis> @@ -622,76 +609,76 @@ requirements of the license of GCC. <listitem><para>Tweak the debug-mode checks in _Safe_iterator. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#409">409</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#409">409</link>: <emphasis>Closing an fstream should clear the error state</emphasis> </term> <listitem><para>Have <code>open</code> clear the error flags. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-closed.html#431">431</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-closed.html#431">431</link>: <emphasis>Swapping containers with unequal allocators</emphasis> </term> <listitem><para>Implement Option 3, as per N1599. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#432">432</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#432">432</link>: <emphasis>stringbuf::overflow() makes only one write position available</emphasis> </term> <listitem><para>Implement the resolution, beyond DR 169. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#434">434</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#434">434</link>: <emphasis>bitset::to_string() hard to use</emphasis> </term> <listitem><para>Add three overloads, taking fewer template arguments. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#438">438</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#438">438</link>: <emphasis>Ambiguity in the "do the right thing" clause</emphasis> </term> <listitem><para>Implement the resolution, basically cast less. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#453">453</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#453">453</link>: <emphasis>basic_stringbuf::seekoff need not always fail for an empty stream</emphasis> </term> <listitem><para>Don't fail if the next pointer is null and newoff is zero. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#455">455</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#455">455</link>: <emphasis>cerr::tie() and wcerr::tie() are overspecified</emphasis> </term> <listitem><para>Initialize cerr tied to cout and wcerr tied to wcout. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#464">464</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#464">464</link>: <emphasis>Suggestion for new member functions in standard containers</emphasis> </term> <listitem><para>Add <code>data()</code> to <code>std::vector</code> and <code>at(const key_type&)</code> to <code>std::map</code>. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#508">508</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#508">508</link>: <emphasis>Bad parameters for ranlux64_base_01</emphasis> </term> <listitem><para>Fix the parameters. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-closed.html#512">512</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-closed.html#512">512</link>: <emphasis>Seeding subtract_with_carry_01 from a single unsigned long</emphasis> </term> <listitem><para>Construct a <code>linear_congruential</code> engine and seed with it. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-closed.html#526">526</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-closed.html#526">526</link>: <emphasis>Is it undefined if a function in the standard changes in parameters?</emphasis> </term> <listitem><para>Use &value. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#538">538</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#538">538</link>: <emphasis>241 again: Does unique_copy() require CopyConstructible and Assignable?</emphasis> </term> @@ -699,7 +686,7 @@ requirements of the license of GCC. input_iterator' value_type. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-active.html#539">539</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-active.html#539">539</link>: <emphasis>partial_sum and adjacent_difference should mention requirements</emphasis> </term> @@ -707,116 +694,116 @@ requirements of the license of GCC. in adjacent_difference. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#541">541</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#541">541</link>: <emphasis>shared_ptr template assignment and void</emphasis> </term> <listitem><para>Add an auto_ptr<void> specialization. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#543">543</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#543">543</link>: <emphasis>valarray slice default constructor</emphasis> </term> <listitem><para>Follow the straightforward proposed resolution. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#550">550</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#550">550</link>: <emphasis>What should the return type of pow(float,int) be?</emphasis> </term> <listitem><para>In C++0x mode, remove the pow(float,int), etc., signatures. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#586">586</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#586">586</link>: <emphasis>string inserter not a formatted function</emphasis> </term> <listitem><para>Change it to be a formatted output function (i.e. catch exceptions). </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#596">596</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#596">596</link>: <emphasis>27.8.1.3 Table 112 omits "a+" and "a+b" modes</emphasis> </term> <listitem><para>Add the missing modes to fopen_mode. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#630">630</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#630">630</link>: <emphasis>arrays of valarray</emphasis> </term> <listitem><para>Implement the simple resolution. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#660">660</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#660">660</link>: <emphasis>Missing bitwise operations</emphasis> </term> <listitem><para>Add the missing operations. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#691">691</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#691">691</link>: <emphasis>const_local_iterator cbegin, cend missing from TR1</emphasis> </term> <listitem><para>In C++0x mode add cbegin(size_type) and cend(size_type) to the unordered containers. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#693">693</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#693">693</link>: <emphasis>std::bitset::all() missing</emphasis> </term> <listitem><para>Add it, consistently with the discussion. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#695">695</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#695">695</link>: <emphasis>ctype<char>::classic_table() not accessible</emphasis> </term> <listitem><para>Make the member functions table and classic_table public. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#696">696</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#696">696</link>: <emphasis>istream::operator>>(int&) broken</emphasis> </term> <listitem><para>Implement the straightforward resolution. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#761">761</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#761">761</link>: <emphasis>unordered_map needs an at() member function</emphasis> </term> <listitem><para>In C++0x mode, add at() and at() const. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#775">775</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#775">775</link>: <emphasis>Tuple indexing should be unsigned?</emphasis> </term> - <listitem><para>Implement the int -> size_t replacements. + <listitem><para>Implement the int -> size_t replacements. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#776">776</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#776">776</link>: <emphasis>Undescribed assign function of std::array</emphasis> </term> <listitem><para>In C++0x mode, remove assign, add fill. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#781">781</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#781">781</link>: <emphasis>std::complex should add missing C99 functions</emphasis> </term> <listitem><para>In C++0x mode, add std::proj. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#809">809</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#809">809</link>: <emphasis>std::swap should be overloaded for array types</emphasis> </term> <listitem><para>Add the overload. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#844">844</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#844">844</link>: <emphasis>complex pow return type is ambiguous</emphasis> </term> <listitem><para>In C++0x mode, remove the pow(complex<T>, int) signature. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-defects.html#853">853</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-defects.html#853">853</link>: <emphasis>to_string needs updating with zero and one</emphasis> </term> <listitem><para>Update / add the signatures. </para></listitem></varlistentry> - <varlistentry><term><ulink url="../ext/lwg-active.html#865">865</ulink>: + <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-active.html#865">865</link>: <emphasis>More algorithms that throw away information</emphasis> </term> <listitem><para>The traditional HP / SGI return type and value is blessed @@ -824,15 +811,15 @@ requirements of the license of GCC. </para></listitem></varlistentry> </variablelist> - </sect2> - </sect1> + </section> + </section> </chapter> <!-- Chapter 02 : Setup --> -<chapter id="manual.intro.setup" xreflabel="Setup"> +<chapter xml:id="manual.intro.setup" xreflabel="Setup"><info><title>Setup</title></info> <?dbhtml filename="setup.html"?> - <title>Setup</title> + <para>To transform libstdc++ sources into installed include files and properly built binaries useful for linking to other software is @@ -859,22 +846,20 @@ requirements of the license of GCC. </para> <!-- Section 01 : Prerequisites --> - <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" - parse="xml" href="prerequisites.xml"> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" parse="xml" href="prerequisites.xml"> </xi:include> <!-- Section 02 : Configure --> - <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" - parse="xml" href="configure.xml"> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" parse="xml" href="configure.xml"> </xi:include> <!-- Section 03 : Make --> -<sect1 id="manual.intro.setup.make" xreflabel="Make"> +<section xml:id="manual.intro.setup.make" xreflabel="Make"><info><title>Make</title></info> <?dbhtml filename="make.html"?> -<title>Make</title> + <para>If you have never done this before, you should read the basic - <ulink url="http://gcc.gnu.org/install/">GCC Installation - Instructions</ulink> first. Read <emphasis>all of them</emphasis>. + <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://gcc.gnu.org/install/">GCC Installation + Instructions</link> first. Read <emphasis>all of them</emphasis>. <emphasis>Twice.</emphasis> </para> @@ -882,13 +867,12 @@ requirements of the license of GCC. started to build. </para> -</sect1> +</section> </chapter> <!-- Chapter 03 : Using --> -<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" - parse="xml" href="using.xml"> +<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" parse="xml" href="using.xml"> </xi:include> </part> |