OSDN Git Service

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