OSDN Git Service

2009-09-26 Paolo Carlini <paolo.carlini@oracle.com>
[pf3gnuchains/gcc-fork.git] / libstdc++-v3 / doc / xml / manual / intro.xml
index a3e2ee4..2fcdeb1 100644 (file)
   </keywordset>
 </partinfo>
 
-<title>Introduction</title>
-
+<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>
 
-
-  <sect1 id="manual.intro.status.standard" xreflabel="Implementation Status">
+  <!-- Section 01 : Implementation Status -->
+  <sect1 id="manual.intro.status.iso" xreflabel="Status">
     <title>Implementation Status</title>
 
-    <!-- Section 01 : Status C++ 1998 -->
+    <!-- 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 02 : Status C++ TR1 -->
+    <!-- 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 03 : Status C++ 200x -->
+    <!-- Section 01.3 : Status C++ 200x -->
     <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
                parse="xml" href="status_cxx200x.xml">
     </xi:include>    
@@ -45,6 +48,7 @@
 
   <!-- 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,
@@ -74,7 +78,7 @@ GCC RUNTIME LIBRARY EXCEPTION
 
 Version 3.1, 31 March 2009
 
-Copyright (C) 2009 Free Software Foundation, Inc. <http://fsf.org/>
+Copyright (C) 2009 <ulink url="http://www.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.
@@ -166,7 +170,7 @@ requirements of the license of GCC.
       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-2.0">GPL</link>.
+      documents are licensed <link linkend="appendix.gpl-3.0">GPL</link>.
     </para>
     
     <para>
@@ -179,6 +183,7 @@ requirements of the license of GCC.
   
   <!-- 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">
@@ -228,7 +233,7 @@ requirements of the license of GCC.
        and src directories for appearances of
        <constant>_GLIBCXX_RESOLVE_LIB_DEFECTS</constant> for examples
        of style.  Note that we usually do not make changes to the
-       code until an issue has reached <ulink url="lwg-active.html#DR">DR</ulink> status.
+       code until an issue has reached <ulink url="../ext/lwg-active.html#DR">DR</ulink> status.
       </para>
 
       <variablelist>
@@ -257,7 +262,7 @@ requirements of the license of GCC.
     <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>:
+    <varlistentry><term><ulink url="../ext/lwg-defects.html#23">23</ulink>:
         <emphasis>Num_get overflow result</emphasis>
     </term>
     <listitem><para>Implement the proposed resolution.
@@ -323,7 +328,7 @@ requirements of the license of GCC.
         the new effects paragraph.
     </para></listitem></varlistentry>
 
-    <varlistentry><term><ulink url="lwg-defects.html#83">83</ulink>:
+    <varlistentry><term><ulink url="../ext/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
@@ -388,6 +393,12 @@ requirements of the license of GCC.
     <listitem><para>These functions set <code>failbit</code> on error now.
     </para></listitem></varlistentry>
 
+    <varlistentry><term><ulink url="../ext/lwg-defects.html#130">130</ulink>:
+        <emphasis>Return type of container::erase(iterator) differs for associative containers</emphasis>
+    </term>
+    <listitem><para>Make member <code>erase</code> return iterator for <code>set</code>, <code>multiset</code>, <code>map</code>, <code>multimap</code>. 
+    </para></listitem></varlistentry>
+
     <varlistentry><term><ulink url="../ext/lwg-defects.html#136">136</ulink>:
         <emphasis>seekp, seekg setting wrong streams?</emphasis>
     </term>
@@ -456,7 +467,7 @@ requirements of the license of GCC.
         is specified in the conversion specification.
     </para></listitem></varlistentry>
 
-    <varlistentry><term><ulink url="../ext/lwg-active.html#233">233</ulink>:
+    <varlistentry><term><ulink url="../ext/lwg-defects.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
@@ -571,7 +582,7 @@ requirements of the license of GCC.
     <listitem><para>Add const overloads of <code>is_open</code>.
     </para></listitem></varlistentry>
 
-    <varlistentry><term><ulink url="../ext/lwg-active.html#387">387</ulink>:
+    <varlistentry><term><ulink url="../ext/lwg-defects.html#387">387</ulink>:
         <emphasis>std::complex over-encapsulated</emphasis>
     </term>
     <listitem><para>Add the <code>real(T)</code> and <code>imag(T)</code>
@@ -587,7 +598,7 @@ requirements of the license of GCC.
     <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>:
+    <varlistentry><term><ulink url="../ext/lwg-defects.html#396">396</ulink>:
         <emphasis>what are characters zero and one</emphasis>
     </term>
     <listitem><para>Implement the proposed resolution.
@@ -599,6 +610,14 @@ requirements of the license of GCC.
     <listitem><para>Replace &quot;new&quot; with &quot;::new&quot;.
     </para></listitem></varlistentry>
 
+    <varlistentry><term><ulink url="../ext/lwg-active.html#408">408</ulink>:
+        <emphasis>
+        Is vector&lt;reverse_iterator&lt;char*&gt; &gt; forbidden?
+        </emphasis>
+    </term>
+    <listitem><para>Tweak the debug-mode checks in _Safe_iterator.
+    </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>
@@ -706,13 +725,19 @@ requirements of the license of GCC.
     <listitem><para>Add the missing modes to fopen_mode.
     </para></listitem></varlistentry>
 
+    <varlistentry><term><ulink url="../ext/lwg-active.html#630">630</ulink>:
+        <emphasis>arrays of valarray</emphasis>
+    </term>
+    <listitem><para>Implement the simple resolution.
+    </para></listitem></varlistentry>
+
     <varlistentry><term><ulink url="../ext/lwg-defects.html#660">660</ulink>:
         <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>:
+    <varlistentry><term><ulink url="../ext/lwg-defects.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)
@@ -731,6 +756,12 @@ requirements of the license of GCC.
     <listitem><para>Make the member functions table and classic_table public.
     </para></listitem></varlistentry>
 
+    <varlistentry><term><ulink url="../ext/lwg-active.html#696">696</ulink>:
+        <emphasis>istream::operator&gt;&gt;(int&amp;) broken</emphasis>
+    </term>
+    <listitem><para>Implement the straightforward resolution.
+    </para></listitem></varlistentry>
+
     <varlistentry><term><ulink url="../ext/lwg-defects.html#761">761</ulink>:
         <emphasis>unordered_map needs an at() member function</emphasis>
     </term>
@@ -743,7 +774,7 @@ requirements of the license of GCC.
     <listitem><para>Implement the int -> size_t replacements.
     </para></listitem></varlistentry>
 
-    <varlistentry><term><ulink url="../ext/lwg-active.html#776">776</ulink>:
+    <varlistentry><term><ulink url="../ext/lwg-defects.html#776">776</ulink>:
         <emphasis>Undescribed assign function of std::array</emphasis>
     </term>
     <listitem><para>In C++0x mode, remove assign, add fill.
@@ -755,19 +786,19 @@ requirements of the license of GCC.
     <listitem><para>In C++0x mode, add std::proj.
     </para></listitem></varlistentry>
 
-    <varlistentry><term><ulink url="../ext/lwg-active.html#809">809</ulink>:
+    <varlistentry><term><ulink url="../ext/lwg-defects.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>:
+    <varlistentry><term><ulink url="../ext/lwg-defects.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>:
+    <varlistentry><term><ulink url="../ext/lwg-defects.html#853">853</ulink>:
         <emphasis>to_string needs updating with zero and one</emphasis>
     </term>
     <listitem><para>Update / add the signatures.
@@ -781,6 +812,7 @@ requirements of the license of GCC.
 
 <!-- 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
@@ -819,6 +851,7 @@ requirements of the license of GCC.
 
   <!-- 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