libstdc++-v3/doc/xml/manual/intro.xml

   1 <?xml version='1.0'?>
   2 <!DOCTYPE part [
   3   <!ENTITY DR
   4 "http://www.open-std.org/jtc1/sc22/wg21/docs/lwg-defects.html">
   5 ] >
   6
   7 <part xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="manual.intro" xreflabel="Introduction">
   8 <?dbhtml filename="intro.html"?>
   9
  10 <info><title>
  11   Introduction
  12   <indexterm><primary>Introduction</primary></indexterm>
  13 </title>
  14   <keywordset>
  15     <keyword>ISO C++</keyword>
  16     <keyword>library</keyword>
  17   </keywordset>
  18 </info>
  19
  20
  21 <!-- Chapter 01 : Status -->
  22 <chapter xml:id="manual.intro.status" xreflabel="Status"><info><title>Status</title></info>
  23   <?dbhtml filename="status.html"?>
  24
  25
  26   <!-- Section 01 : Implementation Status -->
  27   <section xml:id="manual.intro.status.iso" xreflabel="Status"><info><title>Implementation Status</title></info>
  28
  29
  30     <!-- Section 01.1 : Status C++ 1998 -->
  31     <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" parse="xml" href="status_cxx1998.xml">
  32     </xi:include>
  33
  34     <!-- Section 01.2 : Status C++ 2011 -->
  35     <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" parse="xml" href="status_cxx2011.xml">
  36     </xi:include>
  37
  38     <!-- Section 01.3 : Status C++ 2014 -->
  39     <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" parse="xml" href="status_cxx2014.xml">
  40     </xi:include>
  41
  42     <!-- Section 01.4 : Status C++ 2017 -->
  43     <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" parse="xml" href="status_cxx2017.xml">
  44     </xi:include>
  45
  46     <!-- Section 01.5 : Status C++ TR1 -->
  47     <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" parse="xml" href="status_cxxtr1.xml">
  48     </xi:include>
  49
  50     <!-- Section 01.6 : Status C++ TR24733 -->
  51     <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" parse="xml" href="status_cxxtr24733.xml">
  52     </xi:include>
  53
  54     <!-- Section 01.7 : Status C++ IS 24733 -->
  55     <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" parse="xml" href="status_cxxis29124.xml">
  56     </xi:include>
  57   </section>
  58
  59   <!-- Section 02 : License -->
  60   <section xml:id="manual.intro.status.license" xreflabel="License"><info><title>License</title></info>
  61     <?dbhtml filename="license.html"?>
  62
  63     <para>
  64     There are two licenses affecting GNU libstdc++: one for the code,
  65     and one for the documentation.
  66     </para>
  67
  68     <para>
  69       There is a license section in the FAQ regarding common <link linkend="faq.license">questions</link>. If you have more
  70       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>.
  71     </para>
  72
  73     <section xml:id="manual.intro.status.license.gpl" xreflabel="License GPL"><info><title>The Code: GPL</title></info>
  74
  75
  76     <para>
  77       The source code is distributed under the <link linkend="appendix.gpl-3.0">GNU General Public License version 3</link>,
  78       with the addition under section 7 of an exception described in
  79       the <quote>GCC Runtime Library Exception, version 3.1</quote>
  80       as follows (or see the file COPYING.RUNTIME):
  81     </para>
  82
  83     <literallayout class="normal">
  84 GCC RUNTIME LIBRARY EXCEPTION
  85
  86 Version 3.1, 31 March 2009
  87
  88 Copyright (C) 2009 <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.fsf.org">Free Software Foundation, Inc.</link>
  89
  90 Everyone is permitted to copy and distribute verbatim copies of this
  91 license document, but changing it is not allowed.
  92
  93 This GCC Runtime Library Exception ("Exception") is an additional
  94 permission under section 7 of the GNU General Public License, version
  95 3 ("GPLv3"). It applies to a given file (the "Runtime Library") that
  96 bears a notice placed by the copyright holder of the file stating that
  97 the file is governed by GPLv3 along with this Exception.
  98
  99 When you use GCC to compile a program, GCC may combine portions of
 100 certain GCC header files and runtime libraries with the compiled
 101 program. The purpose of this Exception is to allow compilation of
 102 non-GPL (including proprietary) programs to use, in this way, the
 103 header files and runtime libraries covered by this Exception.
 104
 105 0. Definitions.
 106
 107 A file is an "Independent Module" if it either requires the Runtime
 108 Library for execution after a Compilation Process, or makes use of an
 109 interface provided by the Runtime Library, but is not otherwise based
 110 on the Runtime Library.
 111
 112 "GCC" means a version of the GNU Compiler Collection, with or without
 113 modifications, governed by version 3 (or a specified later version) of
 114 the GNU General Public License (GPL) with the option of using any
 115 subsequent versions published by the FSF.
 116
 117 "GPL-compatible Software" is software whose conditions of propagation,
 118 modification and use would permit combination with GCC in accord with
 119 the license of GCC.
 120
 121 "Target Code" refers to output from any compiler for a real or virtual
 122 target processor architecture, in executable form or suitable for
 123 input to an assembler, loader, linker and/or execution
 124 phase. Notwithstanding that, Target Code does not include data in any
 125 format that is used as a compiler intermediate representation, or used
 126 for producing a compiler intermediate representation.
 127
 128 The "Compilation Process" transforms code entirely represented in
 129 non-intermediate languages designed for human-written code, and/or in
 130 Java Virtual Machine byte code, into Target Code. Thus, for example,
 131 use of source code generators and preprocessors need not be considered
 132 part of the Compilation Process, since the Compilation Process can be
 133 understood as starting with the output of the generators or
 134 preprocessors.
 135
 136 A Compilation Process is "Eligible" if it is done using GCC, alone or
 137 with other GPL-compatible software, or if it is done without using any
 138 work based on GCC. For example, using non-GPL-compatible Software to
 139 optimize any GCC intermediate representations would not qualify as an
 140 Eligible Compilation Process.
 141
 142 1. Grant of Additional Permission.
 143
 144 You have permission to propagate a work of Target Code formed by
 145 combining the Runtime Library with Independent Modules, even if such
 146 propagation would otherwise violate the terms of GPLv3, provided that
 147 all Target Code was generated by Eligible Compilation Processes. You
 148 may then convey such a combination under terms of your choice,
 149 consistent with the licensing of the Independent Modules.
 150
 151 2. No Weakening of GCC Copyleft.
 152
 153 The availability of this Exception does not imply any general
 154 presumption that third-party software is unaffected by the copyleft
 155 requirements of the license of GCC.
 156     </literallayout>
 157
 158     <para>
 159       Hopefully that text is self-explanatory.  If it isn't, you need to speak
 160       to your lawyer, or the Free Software Foundation.
 161     </para>
 162     </section>
 163
 164     <section xml:id="manual.intro.status.license.fdl" xreflabel="License FDL"><info><title>The Documentation: GPL, FDL</title></info>
 165
 166
 167     <para>
 168       The documentation shipped with the library and made available over
 169       the web, excluding the pages generated from source comments, are
 170       copyrighted by the Free Software Foundation, and placed under the
 171       <link linkend="appendix.gfdl-1.3"> GNU Free Documentation
 172       License version 1.3</link>.  There are no Front-Cover Texts, no
 173       Back-Cover Texts, and no Invariant Sections.
 174     </para>
 175
 176     <para>
 177       For documentation generated by doxygen or other automated tools
 178       via processing source code comments and markup, the original source
 179       code license applies to the generated files. Thus, the doxygen
 180       documents are licensed <link linkend="appendix.gpl-3.0">GPL</link>.
 181     </para>
 182
 183     <para>
 184       If you plan on making copies of the documentation, please let us know.
 185       We can probably offer suggestions.
 186     </para>
 187     </section>
 188
 189   </section>
 190
 191   <!-- Section 03 : Known Bugs -->
 192   <section xml:id="manual.intro.status.bugs" xreflabel="Bugs"><info><title>Bugs</title></info>
 193     <?dbhtml filename="bugs.html"?>
 194
 195
 196     <section xml:id="manual.intro.status.bugs.impl" xreflabel="Bugs impl"><info><title>Implementation Bugs</title></info>
 197
 198     <para>
 199       Information on known bugs, details on efforts to fix them, and
 200       fixed bugs are all available as part of the <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://gcc.gnu.org/bugs/">GCC bug tracking system</link>,
 201       under the component <quote>libstdc++</quote>.
 202     </para>
 203     </section>
 204
 205     <section xml:id="manual.intro.status.bugs.iso" xreflabel="Bugs iso"><info><title>Standard Bugs</title></info>
 206
 207       <para>
 208         Everybody's got issues.  Even the C++ Standard Library.
 209       </para>
 210       <para>
 211         The Library Working Group, or LWG, is the ISO subcommittee responsible
 212         for making changes to the library.  They periodically publish an
 213         Issues List containing problems and possible solutions.  As they reach
 214         a consensus on proposed solutions, we often incorporate the solution.
 215       </para>
 216       <para>
 217         Here are the issues which have resulted in code changes to the library.
 218         The links are to the full version of the Issues List.
 219         You can read the full version online
 220         at the <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.open-std.org/jtc1/sc22/wg21/">ISO C++
 221         Committee homepage</link>.
 222       </para>
 223       <para>
 224         If a DR is not listed here, we may simply not have gotten to
 225         it yet; feel free to submit a patch.  Search the
 226         <filename class="directory">include</filename> and
 227         <filename class="directory">src</filename>
 228         directories for appearances of
 229         <constant>_GLIBCXX_RESOLVE_LIB_DEFECTS</constant> for examples
 230         of style.  Note that we usually do not make changes to the
 231         code until an issue has reached <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.open-std.org/jtc1/sc22/wg21/docs/lwg-active.html#DR">DR</link> status.
 232       </para>
 233
 234       <variablelist>
 235     <varlistentry xml:id="manual.bugs.dr5"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#5">5</link>:
 236         <emphasis>string::compare specification questionable</emphasis>
 237     </term>
 238     <listitem><para>This should be two overloaded functions rather than a single function.
 239     </para></listitem></varlistentry>
 240
 241     <varlistentry xml:id="manual.bugs.dr17"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#17">17</link>:
 242         <emphasis>Bad bool parsing</emphasis>
 243     </term>
 244     <listitem><para>Apparently extracting Boolean values was messed up...
 245     </para></listitem></varlistentry>
 246
 247     <varlistentry xml:id="manual.bugs.dr19"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#19">19</link>:
 248         <emphasis>"Noconv" definition too vague</emphasis>
 249     </term>
 250     <listitem><para>If <code>codecvt::do_in</code> returns <code>noconv</code> there are
 251         no changes to the values in <code>[to, to_limit)</code>.
 252     </para></listitem></varlistentry>
 253
 254     <varlistentry xml:id="manual.bugs.dr22"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#22">22</link>:
 255         <emphasis>Member open vs flags</emphasis>
 256     </term>
 257     <listitem><para>Re-opening a file stream does <emphasis>not</emphasis> clear the state flags.
 258     </para></listitem></varlistentry>
 259
 260     <varlistentry xml:id="manual.bugs.dr23"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#23">23</link>:
 261         <emphasis>Num_get overflow result</emphasis>
 262     </term>
 263     <listitem><para>Implement the proposed resolution.
 264     </para></listitem></varlistentry>
 265
 266     <varlistentry xml:id="manual.bugs.dr25"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#25">25</link>:
 267         <emphasis>String operator&lt;&lt; uses width() value wrong</emphasis>
 268     </term>
 269     <listitem><para>Padding issues.
 270     </para></listitem></varlistentry>
 271
 272     <varlistentry xml:id="manual.bugs.dr48"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#48">48</link>:
 273         <emphasis>Use of non-existent exception constructor</emphasis>
 274     </term>
 275     <listitem><para>An instance of <code>ios_base::failure</code> is constructed instead.
 276     </para></listitem></varlistentry>
 277
 278     <varlistentry xml:id="manual.bugs.dr49"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#49">49</link>:
 279         <emphasis>Underspecification of ios_base::sync_with_stdio</emphasis>
 280     </term>
 281     <listitem><para>The return type is the <emphasis>previous</emphasis> state of synchronization.
 282     </para></listitem></varlistentry>
 283
 284     <varlistentry xml:id="manual.bugs.dr50"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#50">50</link>:
 285         <emphasis>Copy constructor and assignment operator of ios_base</emphasis>
 286     </term>
 287     <listitem><para>These members functions are declared <code>private</code> and are
 288         thus inaccessible.  Specifying the correct semantics of
 289         "copying stream state" was deemed too complicated.
 290     </para></listitem></varlistentry>
 291
 292     <varlistentry xml:id="manual.bugs.dr60"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#60">60</link>:
 293         <emphasis>What is a formatted input function?</emphasis>
 294     </term>
 295     <listitem><para>This DR made many widespread changes to <code>basic_istream</code>
 296         and <code>basic_ostream</code> all of which have been implemented.
 297     </para></listitem></varlistentry>
 298
 299     <varlistentry xml:id="manual.bugs.dr63"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#63">63</link>:
 300         <emphasis>Exception-handling policy for unformatted output</emphasis>
 301     </term>
 302     <listitem><para>Make the policy consistent with that of formatted input, unformatted
 303         input, and formatted output.
 304     </para></listitem></varlistentry>
 305
 306     <varlistentry xml:id="manual.bugs.dr68"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#68">68</link>:
 307         <emphasis>Extractors for char* should store null at end</emphasis>
 308     </term>
 309     <listitem><para>And they do now.  An editing glitch in the last item in the list of
 310         [27.6.1.2.3]/7.
 311     </para></listitem></varlistentry>
 312
 313     <varlistentry xml:id="manual.bugs.dr74"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#74">74</link>:
 314         <emphasis>Garbled text for codecvt::do_max_length</emphasis>
 315     </term>
 316     <listitem><para>The text of the standard was gibberish.  Typos gone rampant.
 317     </para></listitem></varlistentry>
 318
 319     <varlistentry xml:id="manual.bugs.dr75"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#75">75</link>:
 320         <emphasis>Contradiction in codecvt::length's argument types</emphasis>
 321     </term>
 322     <listitem><para>Change the first parameter to <code>stateT&amp;</code> and implement
 323         the new effects paragraph.
 324     </para></listitem></varlistentry>
 325
 326     <varlistentry xml:id="manual.bugs.dr83"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#83">83</link>:
 327         <emphasis>string::npos vs. string::max_size()</emphasis>
 328     </term>
 329     <listitem><para>Safety checks on the size of the string should test against
 330         <code>max_size()</code> rather than <code>npos</code>.
 331     </para></listitem></varlistentry>
 332
 333     <varlistentry xml:id="manual.bugs.dr90"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#90">90</link>:
 334         <emphasis>Incorrect description of operator&gt;&gt; for strings</emphasis>
 335     </term>
 336     <listitem><para>The effect contain <code>isspace(c,getloc())</code> which must be
 337         replaced by <code>isspace(c,is.getloc())</code>.
 338     </para></listitem></varlistentry>
 339
 340     <varlistentry xml:id="manual.bugs.dr91"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#91">91</link>:
 341         <emphasis>Description of operator&gt;&gt; and getline() for string&lt;&gt;
 342             might cause endless loop</emphasis>
 343     </term>
 344     <listitem><para>They behave as a formatted input function and as an unformatted
 345         input function, respectively (except that <code>getline</code> is
 346         not required to set <code>gcount</code>).
 347     </para></listitem></varlistentry>
 348
 349     <varlistentry xml:id="manual.bugs.dr103"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#103">103</link>:
 350         <emphasis>set::iterator is required to be modifiable, but this allows
 351             modification of keys.</emphasis>
 352     </term>
 353     <listitem><para>For associative containers where the value type is the same as
 354         the key type, both <code>iterator</code> and <code>const_iterator
 355         </code> are constant iterators.
 356     </para></listitem></varlistentry>
 357
 358     <varlistentry xml:id="manual.bugs.dr109"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#109">109</link>:
 359         <emphasis>Missing binders for non-const sequence elements</emphasis>
 360     </term>
 361     <listitem><para>The <code>binder1st</code> and <code>binder2nd</code> didn't have an
 362         <code>operator()</code> taking a non-const parameter.
 363     </para></listitem></varlistentry>
 364
 365     <varlistentry xml:id="manual.bugs.dr110"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#110">110</link>:
 366         <emphasis>istreambuf_iterator::equal not const</emphasis>
 367     </term>
 368     <listitem><para>This was not a const member function.  Note that the DR says to
 369         replace the function with a const one; we have instead provided an
 370         overloaded version with identical contents.
 371     </para></listitem></varlistentry>
 372
 373     <varlistentry xml:id="manual.bugs.dr117"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#117">117</link>:
 374         <emphasis>basic_ostream uses nonexistent num_put member functions</emphasis>
 375     </term>
 376     <listitem><para><code>num_put::put()</code> was overloaded on the wrong types.
 377     </para></listitem></varlistentry>
 378
 379     <varlistentry xml:id="manual.bugs.dr118"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#118">118</link>:
 380         <emphasis>basic_istream uses nonexistent num_get member functions</emphasis>
 381     </term>
 382     <listitem><para>Same as 117, but for <code>num_get::get()</code>.
 383     </para></listitem></varlistentry>
 384
 385     <varlistentry xml:id="manual.bugs.dr129"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#129">129</link>:
 386         <emphasis>Need error indication from seekp() and seekg()</emphasis>
 387     </term>
 388     <listitem><para>These functions set <code>failbit</code> on error now.
 389     </para></listitem></varlistentry>
 390
 391     <varlistentry xml:id="manual.bugs.dr130"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#130">130</link>:
 392         <emphasis>Return type of container::erase(iterator) differs for associative containers</emphasis>
 393     </term>
 394     <listitem><para>Make member <code>erase</code> return iterator for <code>set</code>, <code>multiset</code>, <code>map</code>, <code>multimap</code>.
 395     </para></listitem></varlistentry>
 396
 397     <varlistentry xml:id="manual.bugs.dr136"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#136">136</link>:
 398         <emphasis>seekp, seekg setting wrong streams?</emphasis>
 399     </term>
 400     <listitem><para><code>seekp</code> should only set the output stream, and
 401         <code>seekg</code> should only set the input stream.
 402     </para></listitem></varlistentry>
 403
 404 <!--<varlistentry><term><ulink url="&DR;#159">159</ulink>:
 405         <emphasis>Strange use of underflow()</emphasis>
 406     </term>
 407     <listitem><para>In fstream.tcc, the basic_filebuf&lt;&gt;::showmanyc() function
 408         should probably not be calling <code>underflow()</code>.
 409     </para></listitem></varlistentry> -->
 410
 411     <varlistentry xml:id="manual.bugs.dr167"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#167">167</link>:
 412         <emphasis>Improper use of traits_type::length()</emphasis>
 413     </term>
 414     <listitem><para><code>op&lt;&lt;</code> with a <code>const char*</code> was
 415         calculating an incorrect number of characters to write.
 416     </para></listitem></varlistentry>
 417
 418     <varlistentry xml:id="manual.bugs.dr169"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#169">169</link>:
 419         <emphasis>Bad efficiency of overflow() mandated</emphasis>
 420     </term>
 421     <listitem><para>Grow efficiently the internal array object.
 422     </para></listitem></varlistentry>
 423
 424     <varlistentry xml:id="manual.bugs.dr171"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#171">171</link>:
 425         <emphasis>Strange seekpos() semantics due to joint position</emphasis>
 426     </term>
 427     <listitem><para>Quite complex to summarize...
 428     </para></listitem></varlistentry>
 429
 430     <varlistentry xml:id="manual.bugs.dr181"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#181">181</link>:
 431         <emphasis>make_pair() unintended behavior</emphasis>
 432     </term>
 433     <listitem><para>This function used to take its arguments as reference-to-const, now
 434         it copies them (pass by value).
 435     </para></listitem></varlistentry>
 436
 437     <varlistentry xml:id="manual.bugs.dr195"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#195">195</link>:
 438         <emphasis>Should basic_istream::sentry's constructor ever set eofbit?</emphasis>
 439     </term>
 440     <listitem><para>Yes, it can, specifically if EOF is reached while skipping whitespace.
 441     </para></listitem></varlistentry>
 442
 443     <varlistentry xml:id="manual.bugs.dr211"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#211">211</link>:
 444         <emphasis>operator&gt;&gt;(istream&amp;, string&amp;) doesn't set failbit</emphasis>
 445     </term>
 446     <listitem><para>If nothing is extracted into the string, <code>op&gt;&gt;</code> now
 447         sets <code>failbit</code> (which can cause an exception, etc., etc.).
 448     </para></listitem></varlistentry>
 449
 450     <varlistentry xml:id="manual.bugs.dr214"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#214">214</link>:
 451         <emphasis>set::find() missing const overload</emphasis>
 452     </term>
 453     <listitem><para>Both <code>set</code> and <code>multiset</code> were missing
 454         overloaded find, lower_bound, upper_bound, and equal_range functions
 455         for const instances.
 456     </para></listitem></varlistentry>
 457
 458     <varlistentry xml:id="manual.bugs.dr231"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#231">231</link>:
 459         <emphasis>Precision in iostream?</emphasis>
 460     </term>
 461     <listitem><para>For conversion from a floating-point type, <code>str.precision()</code>
 462         is specified in the conversion specification.
 463     </para></listitem></varlistentry>
 464
 465     <varlistentry xml:id="manual.bugs.dr233"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#233">233</link>:
 466         <emphasis>Insertion hints in associative containers</emphasis>
 467     </term>
 468     <listitem><para>Implement N1780, first check before then check after, insert as close
 469         to hint as possible.
 470     </para></listitem></varlistentry>
 471
 472     <varlistentry xml:id="manual.bugs.dr235"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#235">235</link>:
 473         <emphasis>No specification of default ctor for reverse_iterator</emphasis>
 474     </term>
 475     <listitem><para>The declaration of <code>reverse_iterator</code> lists a default constructor.
 476         However, no specification is given what this constructor should do.
 477     </para></listitem></varlistentry>
 478
 479     <varlistentry xml:id="manual.bugs.dr241"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#241">241</link>:
 480         <emphasis>Does unique_copy() require CopyConstructible and Assignable?</emphasis>
 481     </term>
 482     <listitem><para>Add a helper for forward_iterator/output_iterator, fix the existing
 483         one for input_iterator/output_iterator to not rely on Assignability.
 484     </para></listitem></varlistentry>
 485
 486     <varlistentry xml:id="manual.bugs.dr243"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#243">243</link>:
 487         <emphasis>get and getline when sentry reports failure</emphasis>
 488     </term>
 489     <listitem><para>Store a null character only if the character array has a non-zero size.
 490     </para></listitem></varlistentry>
 491
 492     <varlistentry xml:id="manual.bugs.dr251"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#251">251</link>:
 493         <emphasis>basic_stringbuf missing allocator_type</emphasis>
 494     </term>
 495     <listitem><para>This nested typedef was originally not specified.
 496     </para></listitem></varlistentry>
 497
 498     <varlistentry xml:id="manual.bugs.dr253"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#253">253</link>:
 499         <emphasis>valarray helper functions are almost entirely useless</emphasis>
 500     </term>
 501     <listitem><para>Make the copy constructor and copy-assignment operator declarations
 502         public in gslice_array, indirect_array, mask_array, slice_array; provide
 503         definitions.
 504     </para></listitem></varlistentry>
 505
 506     <varlistentry xml:id="manual.bugs.dr265"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#265">265</link>:
 507         <emphasis>std::pair::pair() effects overly restrictive</emphasis>
 508     </term>
 509     <listitem><para>The default ctor would build its members from copies of temporaries;
 510         now it simply uses their respective default ctors.
 511     </para></listitem></varlistentry>
 512
 513     <varlistentry xml:id="manual.bugs.dr266"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#266">266</link>:
 514         <emphasis>bad_exception::~bad_exception() missing Effects clause</emphasis>
 515     </term>
 516     <listitem><para>The <code>bad_</code>* classes no longer have destructors (they
 517         are trivial), since no description of them was ever given.
 518     </para></listitem></varlistentry>
 519
 520     <varlistentry xml:id="manual.bugs.dr271"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#271">271</link>:
 521         <emphasis>basic_iostream missing typedefs</emphasis>
 522     </term>
 523     <listitem><para>The typedefs it inherits from its base classes can't be used, since
 524         (for example) <code>basic_iostream&lt;T&gt;::traits_type</code> is ambiguous.
 525     </para></listitem></varlistentry>
 526
 527     <varlistentry xml:id="manual.bugs.dr275"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#275">275</link>:
 528         <emphasis>Wrong type in num_get::get() overloads</emphasis>
 529     </term>
 530     <listitem><para>Similar to 118.
 531     </para></listitem></varlistentry>
 532
 533     <varlistentry xml:id="manual.bugs.dr280"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#280">280</link>:
 534         <emphasis>Comparison of reverse_iterator to const reverse_iterator</emphasis>
 535     </term>
 536     <listitem><para>Add global functions with two template parameters.
 537         (NB: not added for now a templated assignment operator)
 538     </para></listitem></varlistentry>
 539
 540     <varlistentry xml:id="manual.bugs.dr292"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#292">292</link>:
 541         <emphasis>Effects of a.copyfmt (a)</emphasis>
 542     </term>
 543     <listitem><para>If <code>(this == &amp;rhs)</code> do nothing.
 544     </para></listitem></varlistentry>
 545
 546     <varlistentry xml:id="manual.bugs.dr300"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#300">300</link>:
 547         <emphasis>List::merge() specification incomplete</emphasis>
 548     </term>
 549     <listitem><para>If <code>(this == &amp;x)</code> do nothing.
 550     </para></listitem></varlistentry>
 551
 552     <varlistentry xml:id="manual.bugs.dr303"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#303">303</link>:
 553         <emphasis>Bitset input operator underspecified</emphasis>
 554     </term>
 555     <listitem><para>Basically, compare the input character to
 556                     <code>is.widen(0)</code> and <code>is.widen(1)</code>.
 557     </para></listitem></varlistentry>
 558
 559     <varlistentry xml:id="manual.bugs.dr305"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#305">305</link>:
 560         <emphasis>Default behavior of codecvt&lt;wchar_t, char,
 561                   mbstate_t&gt;::length()</emphasis>
 562     </term>
 563     <listitem><para>Do not specify what <code>codecvt&lt;wchar_t, char,
 564                     mbstate_t&gt;::do_length</code> must return.
 565     </para></listitem></varlistentry>
 566
 567     <varlistentry xml:id="manual.bugs.dr328"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#328">328</link>:
 568         <emphasis>Bad sprintf format modifier in
 569                   money_put&lt;&gt;::do_put()</emphasis>
 570     </term>
 571     <listitem><para>Change the format string to "%.0Lf".
 572     </para></listitem></varlistentry>
 573
 574     <varlistentry xml:id="manual.bugs.dr365"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#365">365</link>:
 575         <emphasis>Lack of const-qualification in clause 27</emphasis>
 576     </term>
 577     <listitem><para>Add const overloads of <code>is_open</code>.
 578     </para></listitem></varlistentry>
 579
 580     <varlistentry xml:id="manual.bugs.dr387"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#387">387</link>:
 581         <emphasis>std::complex over-encapsulated</emphasis>
 582     </term>
 583     <listitem><para>Add the <code>real(T)</code> and <code>imag(T)</code>
 584                     members;  in C++11 mode, also adjust the existing
 585                     <code>real()</code> and <code>imag()</code> members and
 586                     free functions.
 587     </para></listitem></varlistentry>
 588
 589     <varlistentry xml:id="manual.bugs.dr389"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#389">389</link>:
 590         <emphasis>Const overload of valarray::operator[] returns
 591                   by value</emphasis>
 592     </term>
 593     <listitem><para>Change it to return a <code>const T&amp;</code>.
 594     </para></listitem></varlistentry>
 595
 596     <varlistentry xml:id="manual.bugs.dr396"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#396">396</link>:
 597         <emphasis>what are characters zero and one</emphasis>
 598     </term>
 599     <listitem><para>Implement the proposed resolution.
 600     </para></listitem></varlistentry>
 601
 602     <varlistentry xml:id="manual.bugs.dr402"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#402">402</link>:
 603         <emphasis>Wrong new expression in [some_]allocator::construct</emphasis>
 604     </term>
 605     <listitem><para>Replace "new" with "::new".
 606     </para></listitem></varlistentry>
 607
 608     <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-closed.html#408">408</link>:
 609         <emphasis>
 610         Is vector&lt;reverse_iterator&lt;char*&gt; &gt; forbidden?
 611         </emphasis>
 612     </term>
 613     <listitem><para>Tweak the debug-mode checks in _Safe_iterator.
 614     </para></listitem></varlistentry>
 615
 616     <varlistentry xml:id="manual.bugs.dr409"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#409">409</link>:
 617         <emphasis>Closing an fstream should clear the error state</emphasis>
 618     </term>
 619     <listitem><para>Have <code>open</code> clear the error flags.
 620     </para></listitem></varlistentry>
 621
 622     <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-closed.html#431">431</link>:
 623         <emphasis>Swapping containers with unequal allocators</emphasis>
 624     </term>
 625     <listitem><para>Implement Option 3, as per N1599.
 626     </para></listitem></varlistentry>
 627
 628     <varlistentry xml:id="manual.bugs.dr432"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#432">432</link>:
 629         <emphasis>stringbuf::overflow() makes only one write position
 630             available</emphasis>
 631     </term>
 632     <listitem><para>Implement the resolution, beyond DR 169.
 633     </para></listitem></varlistentry>
 634
 635     <varlistentry xml:id="manual.bugs.dr434"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#434">434</link>:
 636         <emphasis>bitset::to_string() hard to use</emphasis>
 637     </term>
 638     <listitem><para>Add three overloads, taking fewer template arguments.
 639     </para></listitem></varlistentry>
 640
 641     <varlistentry xml:id="manual.bugs.dr438"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#438">438</link>:
 642         <emphasis>Ambiguity in the "do the right thing" clause</emphasis>
 643     </term>
 644     <listitem><para>Implement the resolution, basically cast less.
 645     </para></listitem></varlistentry>
 646
 647     <varlistentry xml:id="manual.bugs.dr445"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#445">445</link>:
 648         <emphasis>iterator_traits::reference unspecified for some iterator categories</emphasis>
 649     </term>
 650     <listitem><para>Change <code>istreambuf_iterator::reference</code> in C++11 mode.
 651     </para></listitem></varlistentry>
 652
 653     <varlistentry xml:id="manual.bugs.dr453"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#453">453</link>:
 654         <emphasis>basic_stringbuf::seekoff need not always fail for an empty stream</emphasis>
 655     </term>
 656     <listitem><para>Don't fail if the next pointer is null and newoff is zero.
 657     </para></listitem></varlistentry>
 658
 659     <varlistentry xml:id="manual.bugs.dr455"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#455">455</link>:
 660         <emphasis>cerr::tie() and wcerr::tie() are overspecified</emphasis>
 661     </term>
 662     <listitem><para>Initialize cerr tied to cout and wcerr tied to wcout.
 663     </para></listitem></varlistentry>
 664
 665     <varlistentry xml:id="manual.bugs.dr464"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#464">464</link>:
 666         <emphasis>Suggestion for new member functions in standard containers</emphasis>
 667     </term>
 668     <listitem><para>Add <code>data()</code> to <code>std::vector</code> and
 669         <code>at(const key_type&amp;)</code> to <code>std::map</code>.
 670     </para></listitem></varlistentry>
 671
 672     <varlistentry xml:id="manual.bugs.dr467"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#467">467</link>:
 673         <emphasis>char_traits::lt(), compare(), and memcmp()</emphasis>
 674     </term>
 675     <listitem><para>Change <code>lt</code>.
 676     </para></listitem></varlistentry>
 677
 678     <varlistentry xml:id="manual.bugs.dr508"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#508">508</link>:
 679         <emphasis>Bad parameters for ranlux64_base_01</emphasis>
 680     </term>
 681     <listitem><para>Fix the parameters.
 682     </para></listitem></varlistentry>
 683
 684     <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-closed.html#512">512</link>:
 685         <emphasis>Seeding subtract_with_carry_01 from a single unsigned long</emphasis>
 686     </term>
 687     <listitem><para>Construct a <code>linear_congruential</code> engine and seed with it.
 688     </para></listitem></varlistentry>
 689
 690     <varlistentry><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../ext/lwg-closed.html#526">526</link>:
 691         <emphasis>Is it undefined if a function in the standard changes in
 692             parameters?</emphasis>
 693     </term>
 694     <listitem><para>Use &amp;value.
 695     </para></listitem></varlistentry>
 696
 697     <varlistentry xml:id="manual.bugs.dr538"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#538">538</link>:
 698         <emphasis>241 again: Does unique_copy() require CopyConstructible
 699             and Assignable?</emphasis>
 700     </term>
 701     <listitem><para>In case of input_iterator/output_iterator rely on Assignability of
 702         input_iterator' value_type.
 703     </para></listitem></varlistentry>
 704
 705     <varlistentry xml:id="manual.bugs.dr539"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#539">539</link>:
 706         <emphasis>partial_sum and adjacent_difference should mention
 707             requirements</emphasis>
 708     </term>
 709     <listitem><para>We were almost doing the right thing, just use std::move
 710         in adjacent_difference.
 711     </para></listitem></varlistentry>
 712
 713     <varlistentry xml:id="manual.bugs.dr541"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#541">541</link>:
 714         <emphasis>shared_ptr template assignment and void</emphasis>
 715     </term>
 716     <listitem><para>Add an auto_ptr&lt;void&gt; specialization.
 717     </para></listitem></varlistentry>
 718
 719     <varlistentry xml:id="manual.bugs.dr543"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#543">543</link>:
 720         <emphasis>valarray slice default constructor</emphasis>
 721     </term>
 722     <listitem><para>Follow the straightforward proposed resolution.
 723     </para></listitem></varlistentry>
 724
 725     <varlistentry xml:id="manual.bugs.dr550"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#550">550</link>:
 726         <emphasis>What should the return type of pow(float,int) be?</emphasis>
 727     </term>
 728     <listitem><para>In C++11 mode, remove the pow(float,int), etc., signatures.
 729     </para></listitem></varlistentry>
 730
 731     <varlistentry xml:id="manual.bugs.dr586"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#586">586</link>:
 732         <emphasis>string inserter not a formatted function</emphasis>
 733     </term>
 734     <listitem><para>Change it to be a formatted output function (i.e. catch exceptions).
 735     </para></listitem></varlistentry>
 736
 737     <varlistentry xml:id="manual.bugs.dr596"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#596">596</link>:
 738         <emphasis>27.8.1.3 Table 112 omits "a+" and "a+b" modes</emphasis>
 739     </term>
 740     <listitem><para>Add the missing modes to fopen_mode.
 741     </para></listitem></varlistentry>
 742
 743     <varlistentry xml:id="manual.bugs.dr630"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#630">630</link>:
 744         <emphasis>arrays of valarray</emphasis>
 745     </term>
 746     <listitem><para>Implement the simple resolution.
 747     </para></listitem></varlistentry>
 748
 749     <varlistentry xml:id="manual.bugs.dr660"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#660">660</link>:
 750         <emphasis>Missing bitwise operations</emphasis>
 751     </term>
 752     <listitem><para>Add the missing operations.
 753     </para></listitem></varlistentry>
 754
 755     <varlistentry xml:id="manual.bugs.dr691"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#691">691</link>:
 756         <emphasis>const_local_iterator cbegin, cend missing from TR1</emphasis>
 757     </term>
 758     <listitem><para>In C++11 mode add cbegin(size_type) and cend(size_type)
 759                     to the unordered containers.
 760     </para></listitem></varlistentry>
 761
 762     <varlistentry xml:id="manual.bugs.dr693"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#693">693</link>:
 763         <emphasis>std::bitset::all() missing</emphasis>
 764     </term>
 765     <listitem><para>Add it, consistently with the discussion.
 766     </para></listitem></varlistentry>
 767
 768     <varlistentry xml:id="manual.bugs.dr695"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#695">695</link>:
 769         <emphasis>ctype&lt;char&gt;::classic_table() not accessible</emphasis>
 770     </term>
 771     <listitem><para>Make the member functions table and classic_table public.
 772     </para></listitem></varlistentry>
 773
 774     <varlistentry xml:id="manual.bugs.dr696"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#696">696</link>:
 775         <emphasis>istream::operator&gt;&gt;(int&amp;) broken</emphasis>
 776     </term>
 777     <listitem><para>Implement the straightforward resolution.
 778     </para></listitem></varlistentry>
 779
 780     <varlistentry xml:id="manual.bugs.dr761"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#761">761</link>:
 781         <emphasis>unordered_map needs an at() member function</emphasis>
 782     </term>
 783     <listitem><para>In C++11 mode, add at() and at() const.
 784     </para></listitem></varlistentry>
 785
 786     <varlistentry xml:id="manual.bugs.dr775"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#775">775</link>:
 787         <emphasis>Tuple indexing should be unsigned?</emphasis>
 788     </term>
 789     <listitem><para>Implement the int -&gt; size_t replacements.
 790     </para></listitem></varlistentry>
 791
 792     <varlistentry xml:id="manual.bugs.dr776"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#776">776</link>:
 793         <emphasis>Undescribed assign function of std::array</emphasis>
 794     </term>
 795     <listitem><para>In C++11 mode, remove assign, add fill.
 796     </para></listitem></varlistentry>
 797
 798     <varlistentry xml:id="manual.bugs.dr781"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#781">781</link>:
 799         <emphasis>std::complex should add missing C99 functions</emphasis>
 800     </term>
 801     <listitem><para>In C++11 mode, add std::proj.
 802     </para></listitem></varlistentry>
 803
 804     <varlistentry xml:id="manual.bugs.dr809"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#809">809</link>:
 805         <emphasis>std::swap should be overloaded for array types</emphasis>
 806     </term>
 807     <listitem><para>Add the overload.
 808     </para></listitem></varlistentry>
 809
 810     <varlistentry xml:id="manual.bugs.dr853"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#853">853</link>:
 811         <emphasis>to_string needs updating with zero and one</emphasis>
 812     </term>
 813     <listitem><para>Update / add the signatures.
 814     </para></listitem></varlistentry>
 815
 816     <varlistentry xml:id="manual.bugs.dr865"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#865">865</link>:
 817         <emphasis>More algorithms that throw away information</emphasis>
 818     </term>
 819     <listitem><para>The traditional HP / SGI return type and value is blessed
 820                     by the resolution of the DR.
 821     </para></listitem></varlistentry>
 822
 823     <varlistentry xml:id="manual.bugs.dr1339"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#1339">1339</link>:
 824        <emphasis>uninitialized_fill_n should return the end of its range</emphasis>
 825     </term>
 826     <listitem><para>Return the end of the filled range.
 827     </para></listitem></varlistentry>
 828
 829     <varlistentry xml:id="manual.bugs.dr2021"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2021">2021</link>:
 830        <emphasis>Further incorrect uses of <code>result_of</code></emphasis>
 831     </term>
 832     <listitem><para>Correctly decay types in signature of <code>std::async</code>.
 833     </para></listitem></varlistentry>
 834
 835     <varlistentry xml:id="manual.bugs.dr2049"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2049">2049</link>:
 836         <emphasis><code>is_destructible</code> underspecified</emphasis>
 837     </term>
 838     <listitem><para>Handle non-object types.
 839     </para></listitem></varlistentry>
 840
 841     <varlistentry xml:id="manual.bugs.dr2056"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2056">2056</link>:
 842         <emphasis>future_errc enums start with value 0 (invalid value for broken_promise)</emphasis>
 843     </term>
 844     <listitem><para>Reorder enumerators.
 845     </para></listitem></varlistentry>
 846
 847     <varlistentry xml:id="manual.bugs.dr2059"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2059">2059</link>:
 848         <emphasis>C++0x ambiguity problem with map::erase</emphasis>
 849     </term>
 850     <listitem><para>Add additional overloads.
 851     </para></listitem></varlistentry>
 852
 853     <varlistentry xml:id="manual.bugs.dr2062"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2062">2062</link>:
 854         <emphasis>2062. Effect contradictions w/o no-throw guarantee of <code>std::function</code> swaps</emphasis>
 855     </term>
 856     <listitem><para>Add <code>noexcept</code> to swap functions.
 857     </para></listitem></varlistentry>
 858
 859     <varlistentry xml:id="manual.bugs.dr2063"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2063">2063</link>:
 860         <emphasis>Contradictory requirements for string move assignment</emphasis>
 861     </term>
 862     <listitem><para>Respect propagation trait for move assignment.
 863     </para></listitem></varlistentry>
 864
 865     <varlistentry xml:id="manual.bugs.dr2064"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2064">2064</link>:
 866         <emphasis>More noexcept issues in basic_string</emphasis>
 867     </term>
 868     <listitem><para>Add noexcept to the comparison operators.
 869     </para></listitem></varlistentry>
 870
 871     <varlistentry xml:id="manual.bugs.dr2067"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2067">2067</link>:
 872         <emphasis>packaged_task should have deleted copy c'tor with const parameter</emphasis>
 873     </term>
 874     <listitem><para>Fix signatures.
 875     </para></listitem></varlistentry>
 876
 877     <varlistentry xml:id="manual.bugs.dr2101"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2101">2101</link>:
 878         <emphasis>Some transformation types can produce impossible types</emphasis>
 879     </term>
 880     <listitem><para>Use the referenceable type concept.
 881     </para></listitem></varlistentry>
 882
 883     <varlistentry xml:id="manual.bugs.dr2106"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2106">2106</link>:
 884         <emphasis>move_iterator wrapping iterators returning prvalues</emphasis>
 885     </term>
 886     <listitem><para>Change the <code>reference</code> type.
 887     </para></listitem></varlistentry>
 888
 889     <varlistentry xml:id="manual.bugs.dr2108"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2108">2108</link>:
 890         <emphasis>No way to identify allocator types that always compare equal</emphasis>
 891     </term>
 892     <listitem><para>Define and use <code>is_always_equal</code> even for C++11.
 893     </para></listitem></varlistentry>
 894
 895     <varlistentry xml:id="manual.bugs.dr2118"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2118">2118</link>:
 896         <emphasis><code>unique_ptr</code> for array does not support cv qualification conversion of actual argument</emphasis>
 897     </term>
 898     <listitem><para>Adjust constraints to allow safe conversions.
 899     </para></listitem></varlistentry>
 900
 901     <varlistentry xml:id="manual.bugs.dr2127"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2127">2127</link>:
 902         <emphasis>Move-construction with <code>raw_storage_iterator</code></emphasis>
 903     </term>
 904     <listitem><para>Add assignment operator taking an rvalue.
 905     </para></listitem></varlistentry>
 906
 907     <varlistentry xml:id="manual.bugs.dr2132"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2132">2132</link>:
 908         <emphasis><code>std::function</code> ambiguity</emphasis>
 909     </term>
 910     <listitem><para>Constrain the constructor to only accept callable types.
 911     </para></listitem></varlistentry>
 912
 913     <varlistentry xml:id="manual.bugs.dr2141"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2141">2141</link>:
 914         <emphasis><code>common_type</code> trait produces reference types</emphasis>
 915     </term>
 916     <listitem><para>Use <code>decay</code> for the result type.
 917     </para></listitem></varlistentry>
 918
 919     <varlistentry xml:id="manual.bugs.dr2144"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2144">2144</link>:
 920         <emphasis>Missing <code>noexcept</code> specification in <code>type_index</code></emphasis>
 921     </term>
 922     <listitem><para>Add <code>noexcept</code>
 923     </para></listitem></varlistentry>
 924
 925     <varlistentry xml:id="manual.bugs.dr2145"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2145">2145</link>:
 926         <emphasis><code>error_category</code> default constructor</emphasis>
 927     </term>
 928     <listitem><para>Declare a public constexpr constructor.
 929     </para></listitem></varlistentry>
 930
 931     <varlistentry xml:id="manual.bugs.dr2162"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2162">2162</link>:
 932         <emphasis><code>allocator_traits::max_size</code> missing <code>noexcept</code></emphasis>
 933     </term>
 934     <listitem><para>Add <code>noexcept</code>.
 935     </para></listitem></varlistentry>
 936
 937     <varlistentry xml:id="manual.bugs.dr2187"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2187">2187</link>:
 938         <emphasis><code>vector&lt;bool&gt;</code> is missing <code>emplace</code> and <code>emplace_back</code> member functions</emphasis>
 939     </term>
 940     <listitem><para>Add <code>emplace</code> and <code>emplace_back</code> member functions.
 941     </para></listitem></varlistentry>
 942
 943     <varlistentry xml:id="manual.bugs.dr2192"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2192">2192</link>:
 944         <emphasis>Validity and return type of <code>std::abs(0u)</code> is unclear</emphasis>
 945     </term>
 946     <listitem><para>Move all declarations to a common header and remove the
 947     generic <code>abs</code> which accepted unsigned arguments.
 948     </para></listitem></varlistentry>
 949
 950     <varlistentry xml:id="manual.bugs.dr2196"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2196">2196</link>:
 951         <emphasis>Specification of <code>is_*[copy/move]_[constructible/assignable]</code> unclear for non-referencable types</emphasis>
 952     </term>
 953     <listitem><para>Use the referenceable type concept.
 954     </para></listitem></varlistentry>
 955
 956     <varlistentry xml:id="manual.bugs.dr2212"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2212">2212</link>:
 957         <emphasis><code>tuple_size</code> for <code>const pair</code> request <code>&lt;tuple&gt;</code> header</emphasis>
 958     </term>
 959     <listitem><para>The <code>tuple_size</code> and <code>tuple_element</code>
 960     partial specializations are defined in <code>&lt;utility&gt;</code> which
 961     is included by <code>&lt;array&gt;</code>.
 962     </para></listitem></varlistentry>
 963
 964     <varlistentry xml:id="manual.bugs.dr2296"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2296">2296</link>:
 965         <emphasis><code>std::addressof</code> should be constexpr</emphasis>
 966     </term>
 967     <listitem><para>Use <code>__builtin_addressof</code> and add
 968     <code>constexpr</code> to <code>addressof</code> for C++17 and later.
 969     </para></listitem></varlistentry>
 970
 971     <varlistentry xml:id="manual.bugs.dr2313"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2313">2313</link>:
 972         <emphasis><code>tuple_size</code> should always derive from <code>integral_constant&lt;size_t, N&gt;</code></emphasis>
 973     </term>
 974     <listitem><para>Update definitions of the partial specializations for const and volatile types.
 975     </para></listitem></varlistentry>
 976
 977     <varlistentry xml:id="manual.bugs.dr2328"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2328">2328</link>:
 978        <emphasis>Rvalue stream extraction should use perfect forwarding</emphasis>
 979     </term>
 980     <listitem><para>Use perfect forwarding for right operand.
 981     </para></listitem></varlistentry>
 982
 983     <varlistentry xml:id="manual.bugs.dr2329"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2329">2329</link>:
 984        <emphasis><code>regex_match()/regex_search()</code> with <code>match_results</code> should forbid temporary strings</emphasis>
 985     </term>
 986     <listitem><para>Add deleted overloads for rvalue strings.
 987     </para></listitem></varlistentry>
 988
 989     <varlistentry xml:id="manual.bugs.dr2332"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2332">2332</link>:
 990        <emphasis><code>regex_iterator/regex_token_iterator</code> should forbid temporary regexes</emphasis>
 991     </term>
 992     <listitem><para>Add deleted constructors.
 993     </para></listitem></varlistentry>
 994
 995     <varlistentry xml:id="manual.bugs.dr2354"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2354">2332</link>:
 996        <emphasis>Unnecessary copying when inserting into maps with braced-init syntax</emphasis>
 997     </term>
 998     <listitem><para>Add overloads of <code>insert</code> taking <code>value_type&amp;&amp;</code> rvalues.
 999     </para></listitem></varlistentry>
1000
1001     <varlistentry xml:id="manual.bugs.dr2399"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2399">2399</link>:
1002         <emphasis><code>shared_ptr</code>'s constructor from <code>unique_ptr</code> should be constrained</emphasis>
1003     </term>
1004     <listitem><para>Constrain the constructor to require convertibility.
1005     </para></listitem></varlistentry>
1006
1007     <varlistentry xml:id="manual.bugs.dr2400"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2400">2400</link>:
1008         <emphasis><code>shared_ptr</code>'s <code>get_deleter()</code> should use <code>addressof()</code></emphasis>
1009     </term>
1010     <listitem><para>Use <code>addressof</code>.
1011     </para></listitem></varlistentry>
1012
1013     <varlistentry xml:id="manual.bugs.dr2401"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2401">2401</link>:
1014         <emphasis><code>std::function</code> needs more <code>noexcept</code></emphasis>
1015     </term>
1016     <listitem><para>Add <code>noexcept</code> to the assignment and comparisons.
1017     </para></listitem></varlistentry>
1018
1019     <varlistentry xml:id="manual.bugs.dr2407"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2407">2407</link>:
1020        <emphasis><code>packaged_task(allocator_arg_t, const Allocator&amp;, F&amp;&amp;)</code>
1021                  should neither be constrained nor <code>explicit</code>
1022        </emphasis>
1023     </term>
1024     <listitem><para>Remove <code>explicit</code> from the constructor.
1025     </para></listitem></varlistentry>
1026
1027     <varlistentry xml:id="manual.bugs.dr2415"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2415">2415</link>:
1028        <emphasis>Inconsistency between <code>unique_ptr</code> and <code>shared_ptr</code></emphasis>
1029     </term>
1030     <listitem><para>Create empty an <code>shared_ptr</code> from an empty
1031                     <code>unique_ptr</code>.
1032     </para></listitem></varlistentry>
1033
1034     <varlistentry xml:id="manual.bugs.dr2418"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2418">2418</link>:
1035        <emphasis><code>apply</code> does not work with member pointers</emphasis>
1036     </term>
1037     <listitem><para>Use <code>mem_fn</code> for member pointers.
1038     </para></listitem></varlistentry>
1039
1040     <varlistentry xml:id="manual.bugs.dr2440"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2440">2440</link>:
1041        <emphasis><code>seed_seq::size()</code> should be <code>noexcept</code></emphasis>
1042     </term>
1043     <listitem><para>Add <code>noexcept</code>.
1044     </para></listitem></varlistentry>
1045
1046     <varlistentry xml:id="manual.bugs.dr2441"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2441">2441</link>:
1047        <emphasis>Exact-width atomic typedefs should be provided</emphasis>
1048     </term>
1049     <listitem><para>Define the typedefs.
1050     </para></listitem></varlistentry>
1051
1052     <varlistentry xml:id="manual.bugs.dr2442"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2442">2442</link>:
1053        <emphasis><code>call_once()</code> shouldn't <code>DECAY_COPY()</code></emphasis>
1054     </term>
1055     <listitem><para>Remove indirection through call wrapper that made copies
1056     of arguments and forward arguments straight to <code>std::invoke</code>.
1057     </para></listitem></varlistentry>
1058
1059     <varlistentry xml:id="manual.bugs.dr2454"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2454">2454</link>:
1060        <emphasis>Add <code>raw_storage_iterator::base()</code> member
1061        </emphasis>
1062     </term>
1063     <listitem><para>Add the <code>base()</code> member function.
1064     </para></listitem></varlistentry>
1065
1066     <varlistentry xml:id="manual.bugs.dr2455"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2455">2455</link>:
1067        <emphasis>Allocator default construction should be allowed to throw
1068        </emphasis>
1069     </term>
1070     <listitem><para>Make <code>noexcept</code> specifications conditional.
1071     </para></listitem></varlistentry>
1072
1073     <varlistentry xml:id="manual.bugs.dr2458"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2458">2458</link>:
1074        <emphasis>N3778 and new library deallocation signatures
1075        </emphasis>
1076     </term>
1077     <listitem><para>Remove unused overloads.
1078     </para></listitem></varlistentry>
1079
1080     <varlistentry xml:id="manual.bugs.dr2459"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2459">2459</link>:
1081        <emphasis><code>std::polar</code> should require a non-negative rho
1082        </emphasis>
1083     </term>
1084     <listitem><para>Add debug mode assertion.
1085     </para></listitem></varlistentry>
1086
1087     <varlistentry xml:id="manual.bugs.dr2466"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2466">2466</link>:
1088        <emphasis><code>allocator_traits::max_size()</code> default behavior is incorrect
1089        </emphasis>
1090     </term>
1091     <listitem><para>Divide by the object type.
1092     </para></listitem></varlistentry>
1093
1094     <varlistentry xml:id="manual.bugs.dr2484"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2484">2484</link>:
1095        <emphasis><code>rethrow_if_nested()</code>  is doubly unimplementable
1096        </emphasis>
1097     </term>
1098     <listitem><para>Avoid using <code>dynamic_cast</code> when it would be
1099     ill-formed.
1100     </para></listitem></varlistentry>
1101
1102     <varlistentry xml:id="manual.bugs.dr2583"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2583">2583</link>:
1103        <emphasis>There is no way to supply an allocator for <code>basic_string(str, pos)</code>
1104        </emphasis>
1105     </term>
1106     <listitem><para>Add new constructor
1107     </para></listitem></varlistentry>
1108
1109     <varlistentry xml:id="manual.bugs.dr2684"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2684">2684</link>:
1110        <emphasis><code>priority_queue</code> lacking comparator typedef
1111        </emphasis>
1112     </term>
1113     <listitem><para>Define the <code>value_compare</code> typedef.
1114     </para></listitem></varlistentry>
1115
1116     <varlistentry xml:id="manual.bugs.dr2770"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2770">2770</link>:
1117        <emphasis><code>tuple_size&lt;const T&gt;</code> specialization is not
1118          SFINAE compatible and breaks decomposition declarations
1119        </emphasis>
1120     </term>
1121     <listitem><para>Safely detect <code>tuple_size&lt;T&gt;::value</code> and
1122       only use it if valid.
1123     </para></listitem></varlistentry>
1124
1125     <varlistentry xml:id="manual.bugs.dr2781"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2781">2781</link>:
1126        <emphasis>Contradictory requirements for <code>std::function</code>
1127          and <code>std::reference_wrapper</code>
1128        </emphasis>
1129     </term>
1130     <listitem><para>Remove special handling for <code>reference_wrapper</code>
1131       arguments and store them directly as the target object.
1132     </para></listitem></varlistentry>
1133
1134     <varlistentry xml:id="manual.bugs.dr2802"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2802">2802</link>:
1135        <emphasis>Add noexcept to several <code>shared_ptr</code> related
1136          functions
1137        </emphasis>
1138     </term>
1139     <listitem><para>Add noexcept.
1140     </para></listitem></varlistentry>
1141
1142     <varlistentry xml:id="manual.bugs.dr2873"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2873">2873</link>:
1143        <emphasis><code>shared_ptr</code> constructor requirements for a deleter
1144        </emphasis>
1145     </term>
1146     <listitem><para>Use rvalues for deleters.
1147     </para></listitem></varlistentry>
1148
1149     <varlistentry xml:id="manual.bugs.dr2942"><term><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&DR;#2942">2942</link>:
1150        <emphasis>LWG 2873's resolution missed
1151          <code>weak_ptr::owner_before</code>
1152        </emphasis>
1153     </term>
1154     <listitem><para>Add noexcept.
1155     </para></listitem></varlistentry>
1156
1157   </variablelist>
1158
1159  </section>
1160   </section>
1161 </chapter>
1162
1163
1164 <!-- Chapter 02 : Setup -->
1165 <chapter xml:id="manual.intro.setup" xreflabel="Setup"><info><title>Setup</title></info>
1166   <?dbhtml filename="setup.html"?>
1167
1168
1169    <para>To transform libstdc++ sources into installed include files
1170    and properly built binaries useful for linking to other software is
1171    a multi-step process. Steps include getting the sources,
1172    configuring and building the sources, testing, and installation.
1173    </para>
1174
1175    <para>The general outline of commands is something like:
1176    </para>
1177
1178    <programlisting>
1179    <replaceable>get gcc sources</replaceable>
1180    <replaceable>extract into gccsrcdir</replaceable>
1181    mkdir <replaceable>gccbuilddir</replaceable>
1182    cd <replaceable>gccbuilddir</replaceable>
1183    <replaceable>gccsrcdir</replaceable>/configure --prefix=<replaceable>destdir</replaceable> --other-opts...
1184    make
1185    make check
1186    make install
1187    </programlisting>
1188
1189    <para>
1190      Each step is described in more detail in the following sections.
1191    </para>
1192
1193   <!-- Section 01 : Prerequisites -->
1194   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" parse="xml" href="prerequisites.xml">
1195   </xi:include>
1196
1197   <!-- Section 02 : Configure -->
1198   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" parse="xml" href="configure.xml">
1199   </xi:include>
1200
1201   <!-- Section 03 : Make -->
1202 <section xml:id="manual.intro.setup.make" xreflabel="Make"><info><title>Make</title></info>
1203   <?dbhtml filename="make.html"?>
1204
1205    <para>If you have never done this before, you should read the basic
1206       <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://gcc.gnu.org/install/">GCC Installation
1207       Instructions</link> first.  Read <emphasis>all of them</emphasis>.
1208       <emphasis>Twice.</emphasis>
1209    </para>
1210
1211 <para>Then type: <command>make</command>, and congratulations, you've
1212 started to build.
1213 </para>
1214
1215 </section>
1216
1217 </chapter>
1218
1219 <!-- Chapter 03 : Using -->
1220 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" parse="xml" href="using.xml">
1221 </xi:include>
1222
1223 </part>