OSDN Git Service

a3e2ee45ff09d9e915847b2a2623c7df02d461ca
[pf3gnuchains/gcc-fork.git] / libstdc++-v3 / doc / xml / manual / intro.xml
1 <?xml version='1.0'?>
2 <!DOCTYPE part PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" 
3  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" 
4 [ ]>
5
6 <part id="manual.intro" xreflabel="Introduction">
7 <?dbhtml filename="intro.html"?>
8  
9 <partinfo>
10   <keywordset>
11     <keyword>
12       ISO C++
13     </keyword>
14     <keyword>
15       library
16     </keyword>
17   </keywordset>
18 </partinfo>
19
20 <title>Introduction</title>
21
22 <!-- Chapter 01 : Status -->
23 <chapter id="manual.intro.status" xreflabel="Status">
24   <title>Status</title>
25
26
27   <sect1 id="manual.intro.status.standard" xreflabel="Implementation Status">
28     <title>Implementation Status</title>
29
30     <!-- Section 01 : Status C++ 1998 -->
31     <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
32                 parse="xml" href="status_cxx1998.xml">
33     </xi:include>
34
35     <!-- Section 02 : Status C++ TR1 -->
36     <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
37                 parse="xml" href="status_cxxtr1.xml">
38     </xi:include>
39
40     <!-- Section 03 : Status C++ 200x -->
41     <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
42                 parse="xml" href="status_cxx200x.xml">
43     </xi:include>    
44   </sect1>
45
46   <!-- Section 02 : License -->
47   <sect1 id="manual.intro.status.license" xreflabel="License">
48     <title>License</title>
49     <para>
50     There are two licenses affecting GNU libstdc++: one for the code,
51     and one for the documentation.  
52     </para>
53
54     <para>
55       There is a license section in the FAQ regarding common <link
56       linkend="faq.license">questions</link>. If you have more
57       questions, ask the FSF or the <ulink
58       url="http://gcc.gnu.org/lists.html">gcc mailing list</ulink>.
59     </para>
60
61     <sect2 id="manual.intro.status.license.gpl" xreflabel="License GPL">
62     <title>The Code: GPL</title>
63     
64     <para>
65       The source code is distributed under the <link
66       linkend="appendix.gpl-3.0">GNU General Public License version 3</link>,
67       with the addition under section 7 of an exception described in
68       the <quote>GCC Runtime Library Exception, version 3.1</quote>
69       as follows (or see the file COPYING.RUNTIME):
70     </para>
71     
72     <literallayout>
73 GCC RUNTIME LIBRARY EXCEPTION
74
75 Version 3.1, 31 March 2009
76
77 Copyright (C) 2009 Free Software Foundation, Inc. <http://fsf.org/>
78
79 Everyone is permitted to copy and distribute verbatim copies of this
80 license document, but changing it is not allowed.
81
82 This GCC Runtime Library Exception ("Exception") is an additional
83 permission under section 7 of the GNU General Public License, version
84 3 ("GPLv3"). It applies to a given file (the "Runtime Library") that
85 bears a notice placed by the copyright holder of the file stating that
86 the file is governed by GPLv3 along with this Exception.
87
88 When you use GCC to compile a program, GCC may combine portions of
89 certain GCC header files and runtime libraries with the compiled
90 program. The purpose of this Exception is to allow compilation of
91 non-GPL (including proprietary) programs to use, in this way, the
92 header files and runtime libraries covered by this Exception.
93
94 0. Definitions.
95
96 A file is an "Independent Module" if it either requires the Runtime
97 Library for execution after a Compilation Process, or makes use of an
98 interface provided by the Runtime Library, but is not otherwise based
99 on the Runtime Library.
100
101 "GCC" means a version of the GNU Compiler Collection, with or without
102 modifications, governed by version 3 (or a specified later version) of
103 the GNU General Public License (GPL) with the option of using any
104 subsequent versions published by the FSF.
105
106 "GPL-compatible Software" is software whose conditions of propagation,
107 modification and use would permit combination with GCC in accord with
108 the license of GCC.
109
110 "Target Code" refers to output from any compiler for a real or virtual
111 target processor architecture, in executable form or suitable for
112 input to an assembler, loader, linker and/or execution
113 phase. Notwithstanding that, Target Code does not include data in any
114 format that is used as a compiler intermediate representation, or used
115 for producing a compiler intermediate representation.
116
117 The "Compilation Process" transforms code entirely represented in
118 non-intermediate languages designed for human-written code, and/or in
119 Java Virtual Machine byte code, into Target Code. Thus, for example,
120 use of source code generators and preprocessors need not be considered
121 part of the Compilation Process, since the Compilation Process can be
122 understood as starting with the output of the generators or
123 preprocessors.
124
125 A Compilation Process is "Eligible" if it is done using GCC, alone or
126 with other GPL-compatible software, or if it is done without using any
127 work based on GCC. For example, using non-GPL-compatible Software to
128 optimize any GCC intermediate representations would not qualify as an
129 Eligible Compilation Process.
130
131 1. Grant of Additional Permission.
132
133 You have permission to propagate a work of Target Code formed by
134 combining the Runtime Library with Independent Modules, even if such
135 propagation would otherwise violate the terms of GPLv3, provided that
136 all Target Code was generated by Eligible Compilation Processes. You
137 may then convey such a combination under terms of your choice,
138 consistent with the licensing of the Independent Modules.
139
140 2. No Weakening of GCC Copyleft.
141
142 The availability of this Exception does not imply any general
143 presumption that third-party software is unaffected by the copyleft
144 requirements of the license of GCC.
145     </literallayout>
146     
147     <para>
148       Hopefully that text is self-explanatory.  If it isn't, you need to speak
149       to your lawyer, or the Free Software Foundation.
150     </para>
151     </sect2>
152
153     <sect2 id="manual.intro.status.license.fdl" xreflabel="License FDL">
154     <title>The Documentation: GPL, FDL</title>
155     
156     <para>
157       The documentation shipped with the library and made available over
158       the web, excluding the pages generated from source comments, are
159       copyrighted by the Free Software Foundation, and placed under the
160       <link linkend="appendix.gfdl-1.2"> GNU Free Documentation
161       License version 1.2</link>.  There are no Front-Cover Texts, no
162       Back-Cover Texts, and no Invariant Sections.
163     </para>
164     
165     <para> 
166       For documentation generated by doxygen or other automated tools
167       via processing source code comments and markup, the original source
168       code license applies to the generated files. Thus, the doxygen
169       documents are licensed <link linkend="appendix.gpl-2.0">GPL</link>.
170     </para>
171     
172     <para>
173       If you plan on making copies of the documentation, please let us know.
174       We can probably offer suggestions.
175     </para>
176     </sect2>
177
178   </sect1>
179   
180   <!-- Section 03 : Known Bugs -->
181   <sect1 id="manual.intro.status.bugs" xreflabel="Bugs">
182     <title>Bugs</title>
183
184     <sect2 id="manual.intro.status.bugs.impl" xreflabel="Bugs impl">
185       <title>Implementation Bugs</title>
186     <para>
187       Information on known bugs, details on efforts to fix them, and
188       fixed bugs are all available as part of the GCC bug tracking
189       system, <ulink
190       url="http://gcc.gnu.org/bugzilla">bugzilla</ulink>, with the
191       category set to <literal>libstdc++</literal>.
192     </para>
193     </sect2>
194
195     <sect2 id="manual.intro.status.bugs.iso" xreflabel="Bugs iso">
196       <title>Standard Bugs</title>
197       <para>
198         Everybody's got issues.  Even the C++ Standard Library.
199       </para>
200       <para>
201         The Library Working Group, or LWG, is the ISO subcommittee responsible
202         for making changes to the library.  They periodically publish an
203         Issues List containing problems and possible solutions.  As they reach
204         a consensus on proposed solutions, we often incorporate the solution.
205       </para>
206       <para>
207         Here are the issues which have resulted in code changes to the library.
208         The links are to the specific defect reports from a <emphasis>partial
209         copy</emphasis> of the Issues List.  You can read the full version online
210         at the <ulink url="http://www.open-std.org/jtc1/sc22/wg21/">ISO C++
211         Committee homepage</ulink>, linked to on the
212         <ulink url="http://gcc.gnu.org/readings.html">GCC &quot;Readings&quot;
213         page</ulink>.  If
214         you spend a lot of time reading the issues, we recommend downloading
215         the ZIP file and reading them locally.
216       </para>
217       <para>
218         (NB: <emphasis>partial copy</emphasis> means that not all
219         links within the lwg-*.html pages will work.  Specifically,
220         links to defect reports that have not been accorded full DR
221         status will probably break.  Rather than trying to mirror the
222         entire issues list on our overworked web server, we recommend
223         you go to the LWG homepage instead.)
224       </para>
225       <para>
226         If a DR is not listed here, we may simply not have gotten to
227         it yet; feel free to submit a patch.  Search the include/bits
228         and src 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 <ulink url="lwg-active.html#DR">DR</ulink> status.
232       </para>
233
234       <variablelist>
235     <varlistentry><term><ulink url="../ext/lwg-defects.html#5">5</ulink>:
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><term><ulink url="../ext/lwg-defects.html#17">17</ulink>:
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><term><ulink url="../ext/lwg-defects.html#19">19</ulink>:
248         <emphasis>&quot;Noconv&quot; 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><term><ulink url="../ext/lwg-defects.html#22">22</ulink>:
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><term><ulink url="../ext/lwg-active.html#23">23</ulink>:
261         <emphasis>Num_get overflow result</emphasis>
262     </term>
263     <listitem><para>Implement the proposed resolution.
264     </para></listitem></varlistentry>
265
266     <varlistentry><term><ulink url="../ext/lwg-defects.html#25">25</ulink>:
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><term><ulink url="../ext/lwg-defects.html#48">48</ulink>:
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><term><ulink url="../ext/lwg-defects.html#49">49</ulink>:
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><term><ulink url="../ext/lwg-defects.html#50">50</ulink>:
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         &quot;copying stream state&quot; was deemed too complicated.
290     </para></listitem></varlistentry>
291
292     <varlistentry><term><ulink url="../ext/lwg-defects.html#60">60</ulink>:
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><term><ulink url="../ext/lwg-defects.html#63">63</ulink>:
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><term><ulink url="../ext/lwg-defects.html#68">68</ulink>:
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><term><ulink url="../ext/lwg-defects.html#74">74</ulink>:
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><term><ulink url="../ext/lwg-defects.html#75">75</ulink>:
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><term><ulink url="lwg-defects.html#83">83</ulink>:
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><term><ulink url="../ext/lwg-defects.html#90">90</ulink>:
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><term><ulink url="../ext/lwg-defects.html#91">91</ulink>:
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><term><ulink url="../ext/lwg-defects.html#103">103</ulink>:
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><term><ulink url="../ext/lwg-defects.html#109">109</ulink>:
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><term><ulink url="../ext/lwg-defects.html#110">110</ulink>:
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><term><ulink url="../ext/lwg-defects.html#117">117</ulink>:
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><term><ulink url="../ext/lwg-defects.html#118">118</ulink>:
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><term><ulink url="../ext/lwg-defects.html#129">129</ulink>:
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><term><ulink url="../ext/lwg-defects.html#136">136</ulink>:
392         <emphasis>seekp, seekg setting wrong streams?</emphasis>
393     </term>
394     <listitem><para><code>seekp</code> should only set the output stream, and
395         <code>seekg</code> should only set the input stream.
396     </para></listitem></varlistentry>
397
398 <!--<varlistentry><term><ulink url="../ext/lwg-defects.html#159">159</ulink>:
399         <emphasis>Strange use of underflow()</emphasis>
400     </term>
401     <listitem><para>In fstream.tcc, the basic_filebuf&lt;&gt;::showmanyc() function
402         should probably not be calling <code>underflow()</code>.
403     </para></listitem></varlistentry> -->
404
405     <varlistentry><term><ulink url="../ext/lwg-defects.html#167">167</ulink>:
406         <emphasis>Improper use of traits_type::length()</emphasis>
407     </term>
408     <listitem><para><code>op&lt;&lt;</code> with a <code>const char*</code> was
409         calculating an incorrect number of characters to write.
410     </para></listitem></varlistentry>
411
412     <varlistentry><term><ulink url="../ext/lwg-defects.html#169">169</ulink>:
413         <emphasis>Bad efficiency of overflow() mandated</emphasis>
414     </term>
415     <listitem><para>Grow efficiently the internal array object.
416     </para></listitem></varlistentry>
417
418     <varlistentry><term><ulink url="../ext/lwg-defects.html#171">171</ulink>:
419         <emphasis>Strange seekpos() semantics due to joint position</emphasis>
420     </term>
421     <listitem><para>Quite complex to summarize...
422     </para></listitem></varlistentry>
423
424     <varlistentry><term><ulink url="../ext/lwg-defects.html#181">181</ulink>:
425         <emphasis>make_pair() unintended behavior</emphasis>
426     </term>
427     <listitem><para>This function used to take its arguments as reference-to-const, now
428         it copies them (pass by value).
429     </para></listitem></varlistentry>
430
431     <varlistentry><term><ulink url="../ext/lwg-defects.html#195">195</ulink>:
432         <emphasis>Should basic_istream::sentry's constructor ever set eofbit?</emphasis>
433     </term>
434     <listitem><para>Yes, it can, specifically if EOF is reached while skipping whitespace.
435     </para></listitem></varlistentry>
436
437     <varlistentry><term><ulink url="../ext/lwg-defects.html#211">211</ulink>:
438         <emphasis>operator&gt;&gt;(istream&amp;, string&amp;) doesn't set failbit</emphasis>
439     </term>
440     <listitem><para>If nothing is extracted into the string, <code>op&gt;&gt;</code> now
441         sets <code>failbit</code> (which can cause an exception, etc., etc.).
442     </para></listitem></varlistentry>
443
444     <varlistentry><term><ulink url="../ext/lwg-defects.html#214">214</ulink>:
445         <emphasis>set::find() missing const overload</emphasis>
446     </term>
447     <listitem><para>Both <code>set</code> and <code>multiset</code> were missing
448         overloaded find, lower_bound, upper_bound, and equal_range functions
449         for const instances.
450     </para></listitem></varlistentry>
451
452     <varlistentry><term><ulink url="../ext/lwg-defects.html#231">231</ulink>:
453         <emphasis>Precision in iostream?</emphasis>
454     </term>
455     <listitem><para>For conversion from a floating-point type, <code>str.precision()</code>
456         is specified in the conversion specification.
457     </para></listitem></varlistentry>
458
459     <varlistentry><term><ulink url="../ext/lwg-active.html#233">233</ulink>:
460         <emphasis>Insertion hints in associative containers</emphasis>
461     </term>
462     <listitem><para>Implement N1780, first check before then check after, insert as close
463         to hint as possible.
464     </para></listitem></varlistentry>
465
466     <varlistentry><term><ulink url="../ext/lwg-defects.html#235">235</ulink>:
467         <emphasis>No specification of default ctor for reverse_iterator</emphasis>
468     </term>
469     <listitem><para>The declaration of <code>reverse_iterator</code> lists a default constructor.
470         However, no specification is given what this constructor should do.
471     </para></listitem></varlistentry>
472
473     <varlistentry><term><ulink url="../ext/lwg-defects.html#241">241</ulink>:
474         <emphasis>Does unique_copy() require CopyConstructible and Assignable?</emphasis>
475     </term>
476     <listitem><para>Add a helper for forward_iterator/output_iterator, fix the existing
477         one for input_iterator/output_iterator to not rely on Assignability.
478     </para></listitem></varlistentry>
479
480     <varlistentry><term><ulink url="../ext/lwg-defects.html#243">243</ulink>:
481         <emphasis>get and getline when sentry reports failure</emphasis>
482     </term>
483     <listitem><para>Store a null character only if the character array has a non-zero size.
484     </para></listitem></varlistentry>
485
486     <varlistentry><term><ulink url="../ext/lwg-defects.html#251">251</ulink>:
487         <emphasis>basic_stringbuf missing allocator_type</emphasis>
488     </term>
489     <listitem><para>This nested typedef was originally not specified.
490     </para></listitem></varlistentry>
491
492     <varlistentry><term><ulink url="../ext/lwg-defects.html#253">253</ulink>:
493         <emphasis>valarray helper functions are almost entirely useless</emphasis>
494     </term>
495     <listitem><para>Make the copy constructor and copy-assignment operator declarations
496         public in gslice_array, indirect_array, mask_array, slice_array; provide
497         definitions.
498     </para></listitem></varlistentry>
499
500     <varlistentry><term><ulink url="../ext/lwg-defects.html#265">265</ulink>:
501         <emphasis>std::pair::pair() effects overly restrictive</emphasis>
502     </term>
503     <listitem><para>The default ctor would build its members from copies of temporaries;
504         now it simply uses their respective default ctors.
505     </para></listitem></varlistentry>
506
507     <varlistentry><term><ulink url="../ext/lwg-defects.html#266">266</ulink>:
508         <emphasis>bad_exception::~bad_exception() missing Effects clause</emphasis>
509     </term>
510     <listitem><para>The <code>bad_</code>* classes no longer have destructors (they
511         are trivial), since no description of them was ever given.
512     </para></listitem></varlistentry>
513
514     <varlistentry><term><ulink url="../ext/lwg-defects.html#271">271</ulink>:
515         <emphasis>basic_iostream missing typedefs</emphasis>
516     </term>
517     <listitem><para>The typedefs it inherits from its base classes can't be used, since
518         (for example) <code>basic_iostream&lt;T&gt;::traits_type</code> is ambiguous.
519     </para></listitem></varlistentry>
520
521     <varlistentry><term><ulink url="../ext/lwg-defects.html#275">275</ulink>:
522         <emphasis>Wrong type in num_get::get() overloads</emphasis>
523     </term>
524     <listitem><para>Similar to 118.
525     </para></listitem></varlistentry>
526
527     <varlistentry><term><ulink url="../ext/lwg-defects.html#280">280</ulink>:
528         <emphasis>Comparison of reverse_iterator to const reverse_iterator</emphasis>
529     </term>
530     <listitem><para>Add global functions with two template parameters.
531         (NB: not added for now a templated assignment operator) 
532     </para></listitem></varlistentry>
533
534     <varlistentry><term><ulink url="../ext/lwg-defects.html#292">292</ulink>:
535         <emphasis>Effects of a.copyfmt (a)</emphasis>
536     </term>
537     <listitem><para>If <code>(this == &amp;rhs)</code> do nothing.
538     </para></listitem></varlistentry>
539
540     <varlistentry><term><ulink url="../ext/lwg-defects.html#300">300</ulink>:
541         <emphasis>List::merge() specification incomplete</emphasis>
542     </term>
543     <listitem><para>If <code>(this == &amp;x)</code> do nothing.
544     </para></listitem></varlistentry>
545
546     <varlistentry><term><ulink url="../ext/lwg-defects.html#303">303</ulink>:
547         <emphasis>Bitset input operator underspecified</emphasis>
548     </term>
549     <listitem><para>Basically, compare the input character to 
550                     <code>is.widen(0)</code> and <code>is.widen(1)</code>.
551     </para></listitem></varlistentry>
552
553     <varlistentry><term><ulink url="../ext/lwg-defects.html#305">305</ulink>:
554         <emphasis>Default behavior of codecvt&lt;wchar_t, char, 
555                   mbstate_t&gt;::length()</emphasis>
556     </term>
557     <listitem><para>Do not specify what <code>codecvt&lt;wchar_t, char, 
558                     mbstate_t&gt;::do_length</code> must return.
559     </para></listitem></varlistentry>
560
561     <varlistentry><term><ulink url="../ext/lwg-defects.html#328">328</ulink>:
562         <emphasis>Bad sprintf format modifier in 
563                   money_put&lt;&gt;::do_put()</emphasis>
564     </term>
565     <listitem><para>Change the format string to &quot;%.0Lf&quot;.
566     </para></listitem></varlistentry>
567
568     <varlistentry><term><ulink url="../ext/lwg-defects.html#365">365</ulink>:
569         <emphasis>Lack of const-qualification in clause 27</emphasis>
570     </term>
571     <listitem><para>Add const overloads of <code>is_open</code>.
572     </para></listitem></varlistentry>
573
574     <varlistentry><term><ulink url="../ext/lwg-active.html#387">387</ulink>:
575         <emphasis>std::complex over-encapsulated</emphasis>
576     </term>
577     <listitem><para>Add the <code>real(T)</code> and <code>imag(T)</code>
578                     members;  in C++0x mode, also adjust the existing 
579                     <code>real()</code> and <code>imag()</code> members and 
580                     free functions.
581     </para></listitem></varlistentry>
582
583     <varlistentry><term><ulink url="../ext/lwg-defects.html#389">389</ulink>:
584         <emphasis>Const overload of valarray::operator[] returns 
585                   by value</emphasis>
586     </term>
587     <listitem><para>Change it to return a <code>const T&amp;</code>.
588     </para></listitem></varlistentry>
589
590     <varlistentry><term><ulink url="../ext/lwg-active.html#396">396</ulink>:
591         <emphasis>what are characters zero and one</emphasis>
592     </term>
593     <listitem><para>Implement the proposed resolution.
594     </para></listitem></varlistentry>
595
596     <varlistentry><term><ulink url="../ext/lwg-defects.html#402">402</ulink>:
597         <emphasis>Wrong new expression in [some_]allocator::construct</emphasis>
598     </term>
599     <listitem><para>Replace &quot;new&quot; with &quot;::new&quot;.
600     </para></listitem></varlistentry>
601
602     <varlistentry><term><ulink url="../ext/lwg-defects.html#409">409</ulink>:
603         <emphasis>Closing an fstream should clear the error state</emphasis>
604     </term>
605     <listitem><para>Have <code>open</code> clear the error flags.
606     </para></listitem></varlistentry>
607
608     <varlistentry><term><ulink url="../ext/lwg-active.html#431">431</ulink>:
609         <emphasis>Swapping containers with unequal allocators</emphasis>
610     </term>
611     <listitem><para>Implement Option 3, as per N1599.
612     </para></listitem></varlistentry>
613
614     <varlistentry><term><ulink url="../ext/lwg-defects.html#432">432</ulink>:
615         <emphasis>stringbuf::overflow() makes only one write position
616             available</emphasis>
617     </term>
618     <listitem><para>Implement the resolution, beyond DR 169.
619     </para></listitem></varlistentry>
620
621     <varlistentry><term><ulink url="../ext/lwg-defects.html#434">434</ulink>:
622         <emphasis>bitset::to_string() hard to use</emphasis>
623     </term>
624     <listitem><para>Add three overloads, taking fewer template arguments.
625     </para></listitem></varlistentry>
626
627     <varlistentry><term><ulink url="../ext/lwg-defects.html#438">438</ulink>:
628         <emphasis>Ambiguity in the "do the right thing" clause</emphasis>
629     </term>
630     <listitem><para>Implement the resolution, basically cast less.
631     </para></listitem></varlistentry>
632
633     <varlistentry><term><ulink url="../ext/lwg-defects.html#453">453</ulink>:
634         <emphasis>basic_stringbuf::seekoff need not always fail for an empty stream</emphasis>
635     </term>
636     <listitem><para>Don't fail if the next pointer is null and newoff is zero.
637     </para></listitem></varlistentry>
638
639     <varlistentry><term><ulink url="../ext/lwg-defects.html#455">455</ulink>:
640         <emphasis>cerr::tie() and wcerr::tie() are overspecified</emphasis>
641     </term>
642     <listitem><para>Initialize cerr tied to cout and wcerr tied to wcout.
643     </para></listitem></varlistentry>
644
645     <varlistentry><term><ulink url="../ext/lwg-defects.html#464">464</ulink>:
646         <emphasis>Suggestion for new member functions in standard containers</emphasis>
647     </term>
648     <listitem><para>Add <code>data()</code> to <code>std::vector</code> and
649         <code>at(const key_type&amp;)</code> to <code>std::map</code>.
650     </para></listitem></varlistentry>
651
652     <varlistentry><term><ulink url="../ext/lwg-defects.html#508">508</ulink>:
653         <emphasis>Bad parameters for ranlux64_base_01</emphasis>
654     </term>
655     <listitem><para>Fix the parameters.
656     </para></listitem></varlistentry>
657
658     <varlistentry><term><ulink url="../ext/lwg-closed.html#512">512</ulink>:
659         <emphasis>Seeding subtract_with_carry_01 from a single unsigned long</emphasis>
660     </term>
661     <listitem><para>Construct a <code>linear_congruential</code> engine and seed with it.
662     </para></listitem></varlistentry>
663
664     <varlistentry><term><ulink url="../ext/lwg-closed.html#526">526</ulink>:
665         <emphasis>Is it undefined if a function in the standard changes in
666             parameters?</emphasis>
667     </term>
668     <listitem><para>Use &amp;value.
669     </para></listitem></varlistentry>
670
671     <varlistentry><term><ulink url="../ext/lwg-defects.html#538">538</ulink>:
672         <emphasis>241 again: Does unique_copy() require CopyConstructible
673             and Assignable?</emphasis>
674     </term>
675     <listitem><para>In case of input_iterator/output_iterator rely on Assignability of
676         input_iterator' value_type.
677     </para></listitem></varlistentry>
678
679     <varlistentry><term><ulink url="../ext/lwg-defects.html#541">541</ulink>:
680         <emphasis>shared_ptr template assignment and void</emphasis>
681     </term>
682     <listitem><para>Add an auto_ptr&lt;void&gt; specialization.
683     </para></listitem></varlistentry>
684
685     <varlistentry><term><ulink url="../ext/lwg-defects.html#543">543</ulink>:
686         <emphasis>valarray slice default constructor</emphasis>
687     </term>
688     <listitem><para>Follow the straightforward proposed resolution.
689     </para></listitem></varlistentry>
690
691     <varlistentry><term><ulink url="../ext/lwg-defects.html#550">550</ulink>:
692         <emphasis>What should the return type of pow(float,int) be?</emphasis>
693     </term>
694     <listitem><para>In C++0x mode, remove the pow(float,int), etc., signatures.
695     </para></listitem></varlistentry>
696
697     <varlistentry><term><ulink url="../ext/lwg-defects.html#586">586</ulink>:
698         <emphasis>string inserter not a formatted function</emphasis>
699     </term>
700     <listitem><para>Change it to be a formatted output function (i.e. catch exceptions).
701     </para></listitem></varlistentry>
702
703     <varlistentry><term><ulink url="../ext/lwg-defects.html#596">596</ulink>:
704         <emphasis>27.8.1.3 Table 112 omits "a+" and "a+b" modes</emphasis>
705     </term>
706     <listitem><para>Add the missing modes to fopen_mode.
707     </para></listitem></varlistentry>
708
709     <varlistentry><term><ulink url="../ext/lwg-defects.html#660">660</ulink>:
710         <emphasis>Missing bitwise operations</emphasis>
711     </term>
712     <listitem><para>Add the missing operations.
713     </para></listitem></varlistentry>
714
715     <varlistentry><term><ulink url="../ext/lwg-active.html#691">691</ulink>:
716         <emphasis>const_local_iterator cbegin, cend missing from TR1</emphasis>
717     </term>
718     <listitem><para>In C++0x mode add cbegin(size_type) and cend(size_type)
719                     to the unordered containers.
720     </para></listitem></varlistentry>
721
722     <varlistentry><term><ulink url="../ext/lwg-defects.html#693">693</ulink>:
723         <emphasis>std::bitset::all() missing</emphasis>
724     </term>
725     <listitem><para>Add it, consistently with the discussion.
726     </para></listitem></varlistentry>
727
728     <varlistentry><term><ulink url="../ext/lwg-defects.html#695">695</ulink>:
729         <emphasis>ctype&lt;char&gt;::classic_table() not accessible</emphasis>
730     </term>
731     <listitem><para>Make the member functions table and classic_table public.
732     </para></listitem></varlistentry>
733
734     <varlistentry><term><ulink url="../ext/lwg-defects.html#761">761</ulink>:
735         <emphasis>unordered_map needs an at() member function</emphasis>
736     </term>
737     <listitem><para>In C++0x mode, add at() and at() const.
738     </para></listitem></varlistentry>
739
740     <varlistentry><term><ulink url="../ext/lwg-defects.html#775">775</ulink>:
741         <emphasis>Tuple indexing should be unsigned?</emphasis>
742     </term>
743     <listitem><para>Implement the int -> size_t replacements.
744     </para></listitem></varlistentry>
745
746     <varlistentry><term><ulink url="../ext/lwg-active.html#776">776</ulink>:
747         <emphasis>Undescribed assign function of std::array</emphasis>
748     </term>
749     <listitem><para>In C++0x mode, remove assign, add fill.
750     </para></listitem></varlistentry>
751
752     <varlistentry><term><ulink url="../ext/lwg-defects.html#781">781</ulink>:
753         <emphasis>std::complex should add missing C99 functions</emphasis>
754     </term>
755     <listitem><para>In C++0x mode, add std::proj.
756     </para></listitem></varlistentry>
757
758     <varlistentry><term><ulink url="../ext/lwg-active.html#809">809</ulink>:
759         <emphasis>std::swap should be overloaded for array types</emphasis>
760     </term>
761     <listitem><para>Add the overload.
762     </para></listitem></varlistentry>
763
764     <varlistentry><term><ulink url="../ext/lwg-active.html#844">844</ulink>:
765         <emphasis>complex pow return type is ambiguous</emphasis>
766     </term>
767     <listitem><para>In C++0x mode, remove the pow(complex&lt;T&gt;, int) signature.
768     </para></listitem></varlistentry>
769
770     <varlistentry><term><ulink url="../ext/lwg-active.html#853">853</ulink>:
771         <emphasis>to_string needs updating with zero and one</emphasis>
772     </term>
773     <listitem><para>Update / add the signatures.
774     </para></listitem></varlistentry>
775   </variablelist>
776
777  </sect2>
778   </sect1>  
779 </chapter>
780
781
782 <!-- Chapter 02 : Setup -->
783 <chapter id="manual.intro.setup" xreflabel="Setup">
784   <title>Setup</title>
785
786    <para>To transform libstdc++ sources into installed include files
787    and properly built binaries useful for linking to other software is
788    a multi-step process. Steps include getting the sources,
789    configuring and building the sources, testing, and installation.
790    </para>
791
792    <para>The general outline of commands is something like:
793    </para>
794
795    <programlisting>
796    <emphasis>get gcc sources</emphasis>
797    <emphasis>extract into gccsrcdir</emphasis>
798    mkdir <emphasis>gccbuilddir</emphasis>
799    cd <emphasis>gccbuilddir</emphasis>
800    <emphasis>gccsrcdir</emphasis>/configure --prefix=<emphasis>destdir</emphasis> --other-opts...
801    make
802    make check
803    make install
804    </programlisting>
805
806    <para>
807      Each step is described in more detail in the following sections.
808    </para>
809
810   <!-- Section 01 : Prerequisites -->
811   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
812               parse="xml" href="prerequisites.xml">
813   </xi:include>
814
815   <!-- Section 02 : Configure -->
816   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
817               parse="xml" href="configure.xml">
818   </xi:include>
819
820   <!-- Section 03 : Make -->
821 <sect1 id="manual.intro.setup.make" xreflabel="Make">
822 <title>Make</title>
823    <para>If you have never done this before, you should read the basic
824       <ulink url="http://gcc.gnu.org/install/">GCC Installation
825       Instructions</ulink> first.  Read <emphasis>all of them</emphasis>.
826       <emphasis>Twice.</emphasis>
827    </para>
828
829 <para>Then type:<command>make</command>, and congratulations, you're
830 started to build.
831 </para>
832
833 </sect1>
834
835   <!-- Section 04 : Test -->
836   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
837               parse="xml" href="test.xml">
838   </xi:include>
839 </chapter>
840
841
842 <!-- Chapter 03 : Using -->
843 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
844             parse="xml" href="using.xml">
845 </xi:include>
846
847 </part>