aboutsummaryrefslogtreecommitdiffstats
path: root/gcc-4.4.3/libstdc++-v3/doc/xml/manual/intro.xml
blob: dca08c2b9e190eed8ee5bf2e6e6a7c1fc0319279 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
<?xml version='1.0'?>
<!DOCTYPE part PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" 
 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" 
[ ]>

<part id="manual.intro" xreflabel="Introduction">
<?dbhtml filename="intro.html"?>
 
<partinfo>
  <keywordset>
    <keyword>
      ISO C++
    </keyword>
    <keyword>
      library
    </keyword>
  </keywordset>
</partinfo>

<title>
  Introduction
  <indexterm><primary>Introduction</primary></indexterm>
</title>
<!-- Chapter 01 : Status -->
<chapter id="manual.intro.status" xreflabel="Status">
  <?dbhtml filename="status.html"?>
  <title>Status</title>

  <!-- Section 01 : Implementation Status -->
  <sect1 id="manual.intro.status.iso" xreflabel="Status">
    <title>Implementation Status</title>

    <!-- Section 01.1 : Status C++ 1998 -->
    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
		parse="xml" href="status_cxx1998.xml">
    </xi:include>

    <!-- Section 01.2 : Status C++ TR1 -->
    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
		parse="xml" href="status_cxxtr1.xml">
    </xi:include>

    <!-- Section 01.3 : Status C++ 200x -->
    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
		parse="xml" href="status_cxx200x.xml">
    </xi:include>    
  </sect1>

  <!-- Section 02 : License -->
  <sect1 id="manual.intro.status.license" xreflabel="License">
    <?dbhtml filename="license.html"?>
    <title>License</title>
    <para>
    There are two licenses affecting GNU libstdc++: one for the code,
    and one for the documentation.  
    </para>

    <para>
      There is a license section in the FAQ regarding common <link
      linkend="faq.license">questions</link>. If you have more
      questions, ask the FSF or the <ulink
      url="http://gcc.gnu.org/lists.html">gcc mailing list</ulink>.
    </para>

    <sect2 id="manual.intro.status.license.gpl" xreflabel="License GPL">
    <title>The Code: GPL</title>
    
    <para>
      The source code is distributed under the <link
      linkend="appendix.gpl-3.0">GNU General Public License version 3</link>,
      with the addition under section 7 of an exception described in
      the <quote>GCC Runtime Library Exception, version 3.1</quote>
      as follows (or see the file COPYING.RUNTIME):
    </para>
    
    <literallayout>
GCC RUNTIME LIBRARY EXCEPTION

Version 3.1, 31 March 2009

Copyright (C) 2009 <ulink url="http://fsf.org">Free Software Foundation, Inc.</ulink>

Everyone is permitted to copy and distribute verbatim copies of this
license document, but changing it is not allowed.

This GCC Runtime Library Exception ("Exception") is an additional
permission under section 7 of the GNU General Public License, version
3 ("GPLv3"). It applies to a given file (the "Runtime Library") that
bears a notice placed by the copyright holder of the file stating that
the file is governed by GPLv3 along with this Exception.

When you use GCC to compile a program, GCC may combine portions of
certain GCC header files and runtime libraries with the compiled
program. The purpose of this Exception is to allow compilation of
non-GPL (including proprietary) programs to use, in this way, the
header files and runtime libraries covered by this Exception.

0. Definitions.

A file is an "Independent Module" if it either requires the Runtime
Library for execution after a Compilation Process, or makes use of an
interface provided by the Runtime Library, but is not otherwise based
on the Runtime Library.

"GCC" means a version of the GNU Compiler Collection, with or without
modifications, governed by version 3 (or a specified later version) of
the GNU General Public License (GPL) with the option of using any
subsequent versions published by the FSF.

"GPL-compatible Software" is software whose conditions of propagation,
modification and use would permit combination with GCC in accord with
the license of GCC.

"Target Code" refers to output from any compiler for a real or virtual
target processor architecture, in executable form or suitable for
input to an assembler, loader, linker and/or execution
phase. Notwithstanding that, Target Code does not include data in any
format that is used as a compiler intermediate representation, or used
for producing a compiler intermediate representation.

The "Compilation Process" transforms code entirely represented in
non-intermediate languages designed for human-written code, and/or in
Java Virtual Machine byte code, into Target Code. Thus, for example,
use of source code generators and preprocessors need not be considered
part of the Compilation Process, since the Compilation Process can be
understood as starting with the output of the generators or
preprocessors.

A Compilation Process is "Eligible" if it is done using GCC, alone or
with other GPL-compatible software, or if it is done without using any
work based on GCC. For example, using non-GPL-compatible Software to
optimize any GCC intermediate representations would not qualify as an
Eligible Compilation Process.

1. Grant of Additional Permission.

You have permission to propagate a work of Target Code formed by
combining the Runtime Library with Independent Modules, even if such
propagation would otherwise violate the terms of GPLv3, provided that
all Target Code was generated by Eligible Compilation Processes. You
may then convey such a combination under terms of your choice,
consistent with the licensing of the Independent Modules.

2. No Weakening of GCC Copyleft.

The availability of this Exception does not imply any general
presumption that third-party software is unaffected by the copyleft
requirements of the license of GCC.
    </literallayout>
    
    <para>
      Hopefully that text is self-explanatory.  If it isn't, you need to speak
      to your lawyer, or the Free Software Foundation.
    </para>
    </sect2>

    <sect2 id="manual.intro.status.license.fdl" xreflabel="License FDL">
    <title>The Documentation: GPL, FDL</title>
    
    <para>
      The documentation shipped with the library and made available over
      the web, excluding the pages generated from source comments, are
      copyrighted by the Free Software Foundation, and placed under the
      <link linkend="appendix.gfdl-1.2"> GNU Free Documentation
      License version 1.2</link>.  There are no Front-Cover Texts, no
      Back-Cover Texts, and no Invariant Sections.
    </para>
    
    <para> 
      For documentation generated by doxygen or other automated tools
      via processing source code comments and markup, the original source
      code license applies to the generated files. Thus, the doxygen
      documents are licensed <link linkend="appendix.gpl-3.0">GPL</link>.
    </para>
    
    <para>
      If you plan on making copies of the documentation, please let us know.
      We can probably offer suggestions.
    </para>
    </sect2>

  </sect1>
  
  <!-- Section 03 : Known Bugs -->
  <sect1 id="manual.intro.status.bugs" xreflabel="Bugs">
    <?dbhtml filename="bugs.html"?>
    <title>Bugs</title>

    <sect2 id="manual.intro.status.bugs.impl" xreflabel="Bugs impl">
      <title>Implementation Bugs</title>
    <para>
      Information on known bugs, details on efforts to fix them, and
      fixed bugs are all available as part of the GCC bug tracking
      system, <ulink
      url="http://gcc.gnu.org/bugzilla">bugzilla</ulink>, with the
      category set to <literal>libstdc++</literal>.
    </para>
    </sect2>

    <sect2 id="manual.intro.status.bugs.iso" xreflabel="Bugs iso">
      <title>Standard Bugs</title>
      <para>
	Everybody's got issues.  Even the C++ Standard Library.
      </para>
      <para>
	The Library Working Group, or LWG, is the ISO subcommittee responsible
	for making changes to the library.  They periodically publish an
	Issues List containing problems and possible solutions.  As they reach
	a consensus on proposed solutions, we often incorporate the solution.
      </para>
      <para>
	Here are the issues which have resulted in code changes to the library.
	The links are to the specific defect reports from a <emphasis>partial
	copy</emphasis> of the Issues List.  You can read the full version online
	at the <ulink url="http://www.open-std.org/jtc1/sc22/wg21/">ISO C++
	Committee homepage</ulink>, linked to on the
	<ulink url="http://gcc.gnu.org/readings.html">GCC &quot;Readings&quot;
	page</ulink>.  If
	you spend a lot of time reading the issues, we recommend downloading
	the ZIP file and reading them locally.
      </para>
      <para>
	(NB: <emphasis>partial copy</emphasis> means that not all
	links within the lwg-*.html pages will work.  Specifically,
	links to defect reports that have not been accorded full DR
	status will probably break.  Rather than trying to mirror the
	entire issues list on our overworked web server, we recommend
	you go to the LWG homepage instead.)
      </para>
      <para>
	If a DR is not listed here, we may simply not have gotten to
	it yet; feel free to submit a patch.  Search the include/bits
	and src directories for appearances of
	<constant>_GLIBCXX_RESOLVE_LIB_DEFECTS</constant> for examples
	of style.  Note that we usually do not make changes to the
	code until an issue has reached <ulink url="lwg-active.html#DR">DR</ulink> status.
      </para>

      <variablelist>
    <varlistentry><term><ulink url="../ext/lwg-defects.html#5">5</ulink>:
        <emphasis>string::compare specification questionable</emphasis>
    </term>
    <listitem><para>This should be two overloaded functions rather than a single function.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#17">17</ulink>:
        <emphasis>Bad bool parsing</emphasis>
    </term>
    <listitem><para>Apparently extracting Boolean values was messed up...
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#19">19</ulink>:
        <emphasis>&quot;Noconv&quot; definition too vague</emphasis>
    </term>
    <listitem><para>If <code>codecvt::do_in</code> returns <code>noconv</code> there are
        no changes to the values in <code>[to, to_limit)</code>.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#22">22</ulink>:
        <emphasis>Member open vs flags</emphasis>
    </term>
    <listitem><para>Re-opening a file stream does <emphasis>not</emphasis> clear the state flags.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-active.html#23">23</ulink>:
        <emphasis>Num_get overflow result</emphasis>
    </term>
    <listitem><para>Implement the proposed resolution.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#25">25</ulink>:
        <emphasis>String operator&lt;&lt; uses width() value wrong</emphasis>
    </term>
    <listitem><para>Padding issues.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#48">48</ulink>:
        <emphasis>Use of non-existent exception constructor</emphasis>
    </term>
    <listitem><para>An instance of <code>ios_base::failure</code> is constructed instead.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#49">49</ulink>:
        <emphasis>Underspecification of ios_base::sync_with_stdio</emphasis>
    </term>
    <listitem><para>The return type is the <emphasis>previous</emphasis> state of synchronization.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#50">50</ulink>:
        <emphasis>Copy constructor and assignment operator of ios_base</emphasis>
    </term>
    <listitem><para>These members functions are declared <code>private</code> and are
        thus inaccessible.  Specifying the correct semantics of
        &quot;copying stream state&quot; was deemed too complicated.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#60">60</ulink>:
        <emphasis>What is a formatted input function?</emphasis>
    </term>
    <listitem><para>This DR made many widespread changes to <code>basic_istream</code>
        and <code>basic_ostream</code> all of which have been implemented.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#63">63</ulink>:
        <emphasis>Exception-handling policy for unformatted output</emphasis>
    </term>
    <listitem><para>Make the policy consistent with that of formatted input, unformatted
        input, and formatted output.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#68">68</ulink>:
        <emphasis>Extractors for char* should store null at end</emphasis>
    </term>
    <listitem><para>And they do now.  An editing glitch in the last item in the list of
        [27.6.1.2.3]/7.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#74">74</ulink>:
        <emphasis>Garbled text for codecvt::do_max_length</emphasis>
    </term>
    <listitem><para>The text of the standard was gibberish.  Typos gone rampant.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#75">75</ulink>:
        <emphasis>Contradiction in codecvt::length's argument types</emphasis>
    </term>
    <listitem><para>Change the first parameter to <code>stateT&amp;</code> and implement
        the new effects paragraph.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="lwg-defects.html#83">83</ulink>:
        <emphasis>string::npos vs. string::max_size()</emphasis>
    </term>
    <listitem><para>Safety checks on the size of the string should test against
        <code>max_size()</code> rather than <code>npos</code>.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#90">90</ulink>:
        <emphasis>Incorrect description of operator&gt;&gt; for strings</emphasis>
    </term>
    <listitem><para>The effect contain <code>isspace(c,getloc())</code> which must be
        replaced by <code>isspace(c,is.getloc())</code>.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#91">91</ulink>:
        <emphasis>Description of operator&gt;&gt; and getline() for string&lt;&gt;
	    might cause endless loop</emphasis>
    </term>
    <listitem><para>They behave as a formatted input function and as an unformatted
        input function, respectively (except that <code>getline</code> is
	not required to set <code>gcount</code>).
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#103">103</ulink>:
        <emphasis>set::iterator is required to be modifiable, but this allows
	    modification of keys.</emphasis>
    </term>
    <listitem><para>For associative containers where the value type is the same as
        the key type, both <code>iterator</code> and <code>const_iterator
	</code> are constant iterators.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#109">109</ulink>:
        <emphasis>Missing binders for non-const sequence elements</emphasis>
    </term>
    <listitem><para>The <code>binder1st</code> and <code>binder2nd</code> didn't have an
        <code>operator()</code> taking a non-const parameter.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#110">110</ulink>:
        <emphasis>istreambuf_iterator::equal not const</emphasis>
    </term>
    <listitem><para>This was not a const member function.  Note that the DR says to
        replace the function with a const one; we have instead provided an
        overloaded version with identical contents.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#117">117</ulink>:
        <emphasis>basic_ostream uses nonexistent num_put member functions</emphasis>
    </term>
    <listitem><para><code>num_put::put()</code> was overloaded on the wrong types.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#118">118</ulink>:
        <emphasis>basic_istream uses nonexistent num_get member functions</emphasis>
    </term>
    <listitem><para>Same as 117, but for <code>num_get::get()</code>.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#129">129</ulink>:
        <emphasis>Need error indication from seekp() and seekg()</emphasis>
    </term>
    <listitem><para>These functions set <code>failbit</code> on error now.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#136">136</ulink>:
        <emphasis>seekp, seekg setting wrong streams?</emphasis>
    </term>
    <listitem><para><code>seekp</code> should only set the output stream, and
        <code>seekg</code> should only set the input stream.
    </para></listitem></varlistentry>

<!--<varlistentry><term><ulink url="../ext/lwg-defects.html#159">159</ulink>:
        <emphasis>Strange use of underflow()</emphasis>
    </term>
    <listitem><para>In fstream.tcc, the basic_filebuf&lt;&gt;::showmanyc() function
        should probably not be calling <code>underflow()</code>.
    </para></listitem></varlistentry> -->

    <varlistentry><term><ulink url="../ext/lwg-defects.html#167">167</ulink>:
        <emphasis>Improper use of traits_type::length()</emphasis>
    </term>
    <listitem><para><code>op&lt;&lt;</code> with a <code>const char*</code> was
        calculating an incorrect number of characters to write.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#169">169</ulink>:
        <emphasis>Bad efficiency of overflow() mandated</emphasis>
    </term>
    <listitem><para>Grow efficiently the internal array object.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#171">171</ulink>:
        <emphasis>Strange seekpos() semantics due to joint position</emphasis>
    </term>
    <listitem><para>Quite complex to summarize...
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#181">181</ulink>:
        <emphasis>make_pair() unintended behavior</emphasis>
    </term>
    <listitem><para>This function used to take its arguments as reference-to-const, now
        it copies them (pass by value).
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#195">195</ulink>:
        <emphasis>Should basic_istream::sentry's constructor ever set eofbit?</emphasis>
    </term>
    <listitem><para>Yes, it can, specifically if EOF is reached while skipping whitespace.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#211">211</ulink>:
        <emphasis>operator&gt;&gt;(istream&amp;, string&amp;) doesn't set failbit</emphasis>
    </term>
    <listitem><para>If nothing is extracted into the string, <code>op&gt;&gt;</code> now
        sets <code>failbit</code> (which can cause an exception, etc., etc.).
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#214">214</ulink>:
        <emphasis>set::find() missing const overload</emphasis>
    </term>
    <listitem><para>Both <code>set</code> and <code>multiset</code> were missing
        overloaded find, lower_bound, upper_bound, and equal_range functions
        for const instances.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#231">231</ulink>:
        <emphasis>Precision in iostream?</emphasis>
    </term>
    <listitem><para>For conversion from a floating-point type, <code>str.precision()</code>
        is specified in the conversion specification.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-active.html#233">233</ulink>:
        <emphasis>Insertion hints in associative containers</emphasis>
    </term>
    <listitem><para>Implement N1780, first check before then check after, insert as close
        to hint as possible.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#235">235</ulink>:
        <emphasis>No specification of default ctor for reverse_iterator</emphasis>
    </term>
    <listitem><para>The declaration of <code>reverse_iterator</code> lists a default constructor.
        However, no specification is given what this constructor should do.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#241">241</ulink>:
        <emphasis>Does unique_copy() require CopyConstructible and Assignable?</emphasis>
    </term>
    <listitem><para>Add a helper for forward_iterator/output_iterator, fix the existing
        one for input_iterator/output_iterator to not rely on Assignability.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#243">243</ulink>:
        <emphasis>get and getline when sentry reports failure</emphasis>
    </term>
    <listitem><para>Store a null character only if the character array has a non-zero size.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#251">251</ulink>:
        <emphasis>basic_stringbuf missing allocator_type</emphasis>
    </term>
    <listitem><para>This nested typedef was originally not specified.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#253">253</ulink>:
        <emphasis>valarray helper functions are almost entirely useless</emphasis>
    </term>
    <listitem><para>Make the copy constructor and copy-assignment operator declarations
        public in gslice_array, indirect_array, mask_array, slice_array; provide
	definitions.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#265">265</ulink>:
        <emphasis>std::pair::pair() effects overly restrictive</emphasis>
    </term>
    <listitem><para>The default ctor would build its members from copies of temporaries;
        now it simply uses their respective default ctors.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#266">266</ulink>:
        <emphasis>bad_exception::~bad_exception() missing Effects clause</emphasis>
    </term>
    <listitem><para>The <code>bad_</code>* classes no longer have destructors (they
        are trivial), since no description of them was ever given.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#271">271</ulink>:
        <emphasis>basic_iostream missing typedefs</emphasis>
    </term>
    <listitem><para>The typedefs it inherits from its base classes can't be used, since
        (for example) <code>basic_iostream&lt;T&gt;::traits_type</code> is ambiguous.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#275">275</ulink>:
        <emphasis>Wrong type in num_get::get() overloads</emphasis>
    </term>
    <listitem><para>Similar to 118.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#280">280</ulink>:
        <emphasis>Comparison of reverse_iterator to const reverse_iterator</emphasis>
    </term>
    <listitem><para>Add global functions with two template parameters.
        (NB: not added for now a templated assignment operator) 
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#292">292</ulink>:
        <emphasis>Effects of a.copyfmt (a)</emphasis>
    </term>
    <listitem><para>If <code>(this == &amp;rhs)</code> do nothing.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#300">300</ulink>:
        <emphasis>List::merge() specification incomplete</emphasis>
    </term>
    <listitem><para>If <code>(this == &amp;x)</code> do nothing.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#303">303</ulink>:
        <emphasis>Bitset input operator underspecified</emphasis>
    </term>
    <listitem><para>Basically, compare the input character to 
                    <code>is.widen(0)</code> and <code>is.widen(1)</code>.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#305">305</ulink>:
        <emphasis>Default behavior of codecvt&lt;wchar_t, char, 
                  mbstate_t&gt;::length()</emphasis>
    </term>
    <listitem><para>Do not specify what <code>codecvt&lt;wchar_t, char, 
                    mbstate_t&gt;::do_length</code> must return.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#328">328</ulink>:
        <emphasis>Bad sprintf format modifier in 
                  money_put&lt;&gt;::do_put()</emphasis>
    </term>
    <listitem><para>Change the format string to &quot;%.0Lf&quot;.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#365">365</ulink>:
        <emphasis>Lack of const-qualification in clause 27</emphasis>
    </term>
    <listitem><para>Add const overloads of <code>is_open</code>.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-active.html#387">387</ulink>:
        <emphasis>std::complex over-encapsulated</emphasis>
    </term>
    <listitem><para>Add the <code>real(T)</code> and <code>imag(T)</code>
                    members;  in C++0x mode, also adjust the existing 
                    <code>real()</code> and <code>imag()</code> members and 
                    free functions.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#389">389</ulink>:
        <emphasis>Const overload of valarray::operator[] returns 
                  by value</emphasis>
    </term>
    <listitem><para>Change it to return a <code>const T&amp;</code>.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-active.html#396">396</ulink>:
        <emphasis>what are characters zero and one</emphasis>
    </term>
    <listitem><para>Implement the proposed resolution.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#402">402</ulink>:
        <emphasis>Wrong new expression in [some_]allocator::construct</emphasis>
    </term>
    <listitem><para>Replace &quot;new&quot; with &quot;::new&quot;.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#409">409</ulink>:
        <emphasis>Closing an fstream should clear the error state</emphasis>
    </term>
    <listitem><para>Have <code>open</code> clear the error flags.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-active.html#431">431</ulink>:
        <emphasis>Swapping containers with unequal allocators</emphasis>
    </term>
    <listitem><para>Implement Option 3, as per N1599.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#432">432</ulink>:
        <emphasis>stringbuf::overflow() makes only one write position
	    available</emphasis>
    </term>
    <listitem><para>Implement the resolution, beyond DR 169.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#434">434</ulink>:
        <emphasis>bitset::to_string() hard to use</emphasis>
    </term>
    <listitem><para>Add three overloads, taking fewer template arguments.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#438">438</ulink>:
        <emphasis>Ambiguity in the "do the right thing" clause</emphasis>
    </term>
    <listitem><para>Implement the resolution, basically cast less.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#453">453</ulink>:
        <emphasis>basic_stringbuf::seekoff need not always fail for an empty stream</emphasis>
    </term>
    <listitem><para>Don't fail if the next pointer is null and newoff is zero.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#455">455</ulink>:
        <emphasis>cerr::tie() and wcerr::tie() are overspecified</emphasis>
    </term>
    <listitem><para>Initialize cerr tied to cout and wcerr tied to wcout.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#464">464</ulink>:
        <emphasis>Suggestion for new member functions in standard containers</emphasis>
    </term>
    <listitem><para>Add <code>data()</code> to <code>std::vector</code> and
        <code>at(const key_type&amp;)</code> to <code>std::map</code>.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#508">508</ulink>:
        <emphasis>Bad parameters for ranlux64_base_01</emphasis>
    </term>
    <listitem><para>Fix the parameters.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-closed.html#512">512</ulink>:
        <emphasis>Seeding subtract_with_carry_01 from a single unsigned long</emphasis>
    </term>
    <listitem><para>Construct a <code>linear_congruential</code> engine and seed with it.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-closed.html#526">526</ulink>:
        <emphasis>Is it undefined if a function in the standard changes in
	    parameters?</emphasis>
    </term>
    <listitem><para>Use &amp;value.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#538">538</ulink>:
        <emphasis>241 again: Does unique_copy() require CopyConstructible
	    and Assignable?</emphasis>
    </term>
    <listitem><para>In case of input_iterator/output_iterator rely on Assignability of
        input_iterator' value_type.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#541">541</ulink>:
        <emphasis>shared_ptr template assignment and void</emphasis>
    </term>
    <listitem><para>Add an auto_ptr&lt;void&gt; specialization.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#543">543</ulink>:
        <emphasis>valarray slice default constructor</emphasis>
    </term>
    <listitem><para>Follow the straightforward proposed resolution.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#550">550</ulink>:
        <emphasis>What should the return type of pow(float,int) be?</emphasis>
    </term>
    <listitem><para>In C++0x mode, remove the pow(float,int), etc., signatures.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#586">586</ulink>:
        <emphasis>string inserter not a formatted function</emphasis>
    </term>
    <listitem><para>Change it to be a formatted output function (i.e. catch exceptions).
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#596">596</ulink>:
        <emphasis>27.8.1.3 Table 112 omits "a+" and "a+b" modes</emphasis>
    </term>
    <listitem><para>Add the missing modes to fopen_mode.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#660">660</ulink>:
        <emphasis>Missing bitwise operations</emphasis>
    </term>
    <listitem><para>Add the missing operations.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-active.html#691">691</ulink>:
        <emphasis>const_local_iterator cbegin, cend missing from TR1</emphasis>
    </term>
    <listitem><para>In C++0x mode add cbegin(size_type) and cend(size_type)
	            to the unordered containers.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#693">693</ulink>:
        <emphasis>std::bitset::all() missing</emphasis>
    </term>
    <listitem><para>Add it, consistently with the discussion.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#695">695</ulink>:
        <emphasis>ctype&lt;char&gt;::classic_table() not accessible</emphasis>
    </term>
    <listitem><para>Make the member functions table and classic_table public.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#761">761</ulink>:
        <emphasis>unordered_map needs an at() member function</emphasis>
    </term>
    <listitem><para>In C++0x mode, add at() and at() const.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#775">775</ulink>:
        <emphasis>Tuple indexing should be unsigned?</emphasis>
    </term>
    <listitem><para>Implement the int -> size_t replacements.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-active.html#776">776</ulink>:
        <emphasis>Undescribed assign function of std::array</emphasis>
    </term>
    <listitem><para>In C++0x mode, remove assign, add fill.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-defects.html#781">781</ulink>:
        <emphasis>std::complex should add missing C99 functions</emphasis>
    </term>
    <listitem><para>In C++0x mode, add std::proj.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-active.html#809">809</ulink>:
        <emphasis>std::swap should be overloaded for array types</emphasis>
    </term>
    <listitem><para>Add the overload.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-active.html#844">844</ulink>:
        <emphasis>complex pow return type is ambiguous</emphasis>
    </term>
    <listitem><para>In C++0x mode, remove the pow(complex&lt;T&gt;, int) signature.
    </para></listitem></varlistentry>

    <varlistentry><term><ulink url="../ext/lwg-active.html#853">853</ulink>:
        <emphasis>to_string needs updating with zero and one</emphasis>
    </term>
    <listitem><para>Update / add the signatures.
    </para></listitem></varlistentry>
  </variablelist>

 </sect2>
  </sect1>  
</chapter>


<!-- Chapter 02 : Setup -->
<chapter id="manual.intro.setup" xreflabel="Setup">
  <?dbhtml filename="setup.html"?>
  <title>Setup</title>

   <para>To transform libstdc++ sources into installed include files
   and properly built binaries useful for linking to other software is
   a multi-step process. Steps include getting the sources,
   configuring and building the sources, testing, and installation.
   </para>

   <para>The general outline of commands is something like:
   </para>

   <programlisting>
   <emphasis>get gcc sources</emphasis>
   <emphasis>extract into gccsrcdir</emphasis>
   mkdir <emphasis>gccbuilddir</emphasis>
   cd <emphasis>gccbuilddir</emphasis>
   <emphasis>gccsrcdir</emphasis>/configure --prefix=<emphasis>destdir</emphasis> --other-opts...
   make
   make check
   make install
   </programlisting>

   <para>
     Each step is described in more detail in the following sections.
   </para>

  <!-- Section 01 : Prerequisites -->
  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
	      parse="xml" href="prerequisites.xml">
  </xi:include>

  <!-- Section 02 : Configure -->
  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
	      parse="xml" href="configure.xml">
  </xi:include>

  <!-- Section 03 : Make -->
<sect1 id="manual.intro.setup.make" xreflabel="Make">
  <?dbhtml filename="make.html"?>
<title>Make</title>
   <para>If you have never done this before, you should read the basic
      <ulink url="http://gcc.gnu.org/install/">GCC Installation
      Instructions</ulink> first.  Read <emphasis>all of them</emphasis>.
      <emphasis>Twice.</emphasis>
   </para>

<para>Then type:<command>make</command>, and congratulations, you're
started to build.
</para>

</sect1>

  <!-- Section 04 : Test -->
  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
	      parse="xml" href="test.xml">
  </xi:include>
</chapter>


<!-- Chapter 03 : Using -->
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
	    parse="xml" href="using.xml">
</xi:include>

</part>