OSDN Git Service

2010-04-06 Matthias Klose <doko@ubuntu.com>
authordoko <doko@138bc75d-0d04-0410-961f-82ee72b054a4>
Tue, 6 Apr 2010 01:27:44 +0000 (01:27 +0000)
committerMasaki Muranaka <monaka@monami-software.com>
Sun, 23 May 2010 00:44:42 +0000 (09:44 +0900)
        * acinclude.m4 (GLIBCXX_ENABLE_LIBSTDCXX_TIME): Show test result.
        * configure: Regenerate.
        * doc/xml/manual/configure.xml, doc/html/manual/configure.html:
        Document --enable-libstdcxx-time as the short form for
        --enable-libstdcxx-time=yes.

git-svn-id: svn+ssh://gcc.gnu.org/svn/gcc/trunk@157975 138bc75d-0d04-0410-961f-82ee72b054a4

libstdc++-v3/ChangeLog
libstdc++-v3/doc/html/manual/configure.html

index dba4af6..a5f2caf 100644 (file)
@@ -1,3 +1,11 @@
+2010-04-06  Matthias Klose  <doko@ubuntu.com>
+
+       * acinclude.m4 (GLIBCXX_ENABLE_LIBSTDCXX_TIME): Show test result.
+       * configure: Regenerate.
+       * doc/xml/manual/configure.xml, doc/html/manual/configure.html:
+       Document --enable-libstdcxx-time as the short form for
+       --enable-libstdcxx-time=yes.
+
 2010-04-03  Paolo Carlini  <paolo.carlini@oracle.com>
 
        * include/bits/basic_string.h: Fix pasto in comment.
index 47f58f4..c5ee8c3 100644 (file)
    available for a given set of libstdc++ sources is to go to the
    source directory and then type:<span class="command"><strong>./configure --help</strong></span>.
 </p><div class="variablelist"><dl><dt><span class="term"><code class="code">--enable-multilib</code>[default]</span></dt><dd><p>This is part of the generic multilib support for building cross
-       compilers.  As such, targets like "powerpc-elf" will have
-       libstdc++ built many different ways:  "-msoft-float"
-       and not, etc.  A different libstdc++ will be built for each of
-       the different multilib versions.  This option is on by default.
+        compilers.  As such, targets like "powerpc-elf" will have
+        libstdc++ built many different ways:  "-msoft-float"
+        and not, etc.  A different libstdc++ will be built for each of
+        the different multilib versions.  This option is on by default.
      </p></dd><dt><span class="term"><code class="code">--enable-sjlj-exceptions</code></span></dt><dd><p>Forces old, set-jump/long-jump exception handling model.  If
-       at all possible, the new, frame unwinding exception handling routines
-       should be used instead, as they significantly reduce both
-       runtime memory usage and executable size. This option can
-       change the library ABI.
+        at all possible, the new, frame unwinding exception handling routines
+        should be used instead, as they significantly reduce both
+        runtime memory usage and executable size. This option can
+        change the library ABI.
      </p></dd><dt><span class="term"><code class="code">--enable-version-specific-runtime-libs</code></span></dt><dd><p>Specify that run-time libraries should be installed in the
-       compiler-specific subdirectory (i.e.,
-       <code class="code">${libdir}/gcc-lib/${target_alias}/${gcc_version}</code>)
-       instead of <code class="code">${libdir}</code>.  This option is useful if you
-       intend to use several versions of gcc in parallel.  In addition,
-       libstdc++'s include files will be installed in
-       <code class="code">${libdir}/gcc-lib/${target_alias}/${gcc_version}/include/g++</code>,
-       unless you also specify
+        compiler-specific subdirectory (i.e.,
+        <code class="code">${libdir}/gcc-lib/${target_alias}/${gcc_version}</code>)
+        instead of <code class="code">${libdir}</code>.  This option is useful if you
+        intend to use several versions of gcc in parallel.  In addition,
+        libstdc++'s include files will be installed in
+        <code class="code">${libdir}/gcc-lib/${target_alias}/${gcc_version}/include/g++</code>,
+        unless you also specify
        <code class="literal">--with-gxx-include-dir=<code class="filename">dirname</code></code> during configuration.
      </p></dd><dt><span class="term"><code class="code">--with-gxx-include-dir=&lt;include-files dir&gt;</code></span></dt><dd><p>Adds support for named libstdc++ include directory.  For instance,
-       the following puts all the libstdc++ headers into a directory
-       called "4.4-20090404" instead of the usual
-       "c++/(version)".
+        the following puts all the libstdc++ headers into a directory
+        called "4.4-20090404" instead of the usual
+        "c++/(version)".
      </p><pre class="programlisting">
    --with-gxx-include-dir=/foo/H-x86-gcc-3-c-gxx-inc/include/4.4-20090404</pre></dd><dt><span class="term"><code class="code">--enable-cstdio</code></span></dt><dd><p>This is an abbreviated form of <code class="code">'--enable-cstdio=stdio'</code>
-       (described next).
+        (described next). 
      </p></dd><dt><span class="term"><code class="code">--enable-cstdio=OPTION</code></span></dt><dd><p>Select a target-specific I/O package. At the moment, the only
-       choice is to use 'stdio', a generic "C" abstraction.
-       The default is 'stdio'. This option can change the library ABI.
+        choice is to use 'stdio', a generic "C" abstraction.
+        The default is 'stdio'. This option can change the library ABI.
      </p></dd><dt><span class="term"><code class="code">--enable-clocale</code></span></dt><dd><p>This is an abbreviated form of <code class="code">'--enable-clocale=generic'</code>
-       (described next).
+        (described next). 
      </p></dd><dt><span class="term"><code class="code">--enable-clocale=OPTION</code></span></dt><dd><p>Select a target-specific underlying locale package.  The
-       choices are 'ieee_1003.1-2001' to specify an X/Open, Standard Unix
-       (IEEE Std. 1003.1-2001) model based on langinfo/iconv/catgets,
-       'gnu' to specify a model based on functionality from the GNU C
-       library (langinfo/iconv/gettext) (from <a class="ulink" href="http://sources.redhat.com/glibc/" target="_top">glibc</a>, the GNU C
-       library), or 'generic' to use a generic "C"
-       abstraction which consists of "C" locale info.
+        choices are 'ieee_1003.1-2001' to specify an X/Open, Standard Unix
+        (IEEE Std. 1003.1-2001) model based on langinfo/iconv/catgets,
+        'gnu' to specify a model based on functionality from the GNU C
+        library (langinfo/iconv/gettext) (from <a class="ulink" href="http://sources.redhat.com/glibc/" target="_top">glibc</a>, the GNU C
+        library), or 'generic' to use a generic "C"
+        abstraction which consists of "C" locale info.
      </p><p>If not explicitly specified, the configure proccess tries
       to guess the most suitable package from the choices above. The
       default is 'generic'. On glibc-based systems of sufficient
       FR locale data), 'gnu' is automatically selected. This option
       can change the library ABI.
      </p></dd><dt><span class="term"><code class="code">--enable-libstdcxx-allocator</code></span></dt><dd><p>This is an abbreviated form of
-       <code class="code">'--enable-libstdcxx-allocator=auto'</code> (described
-       next).
+        <code class="code">'--enable-libstdcxx-allocator=auto'</code> (described
+        next). 
      </p></dd><dt><span class="term"><code class="code">--enable-libstdcxx-allocator=OPTION  </code></span></dt><dd><p>Select a target-specific underlying std::allocator.  The
-       choices are 'new' to specify a wrapper for new, 'malloc' to
-       specify a wrapper for malloc, 'mt' for a fixed power of two allocator,
+        choices are 'new' to specify a wrapper for new, 'malloc' to
+        specify a wrapper for malloc, 'mt' for a fixed power of two allocator,
        'pool' for the SGI pooled allocator or 'bitmap' for a bitmap allocator.
-       See this page for more information on allocator
-       <a class="link" href="memory.html#allocator.ext" title="Extension Allocators">extensions</a>. This option
-       can change the library ABI.
+       See this page for more information on allocator 
+        <a class="link" href="memory.html#allocator.ext" title="Extension Allocators">extensions</a>. This option
+        can change the library ABI.
      </p></dd><dt><span class="term"><code class="code">--enable-cheaders=OPTION</code></span></dt><dd><p>This allows the user to define the approach taken for C header
-       compatibility with C++. Options are c, c_std, and c_global.
-       These correspond to the source directory's include/c,
-       include/c_std, and include/c_global, and may also include
-       include/c_compatibility.  The default is 'c_global'.
+        compatibility with C++. Options are c, c_std, and c_global.
+        These correspond to the source directory's include/c,
+        include/c_std, and include/c_global, and may also include
+        include/c_compatibility.  The default is 'c_global'.
      </p></dd><dt><span class="term"><code class="code">--enable-threads</code></span></dt><dd><p>This is an abbreviated form of <code class="code">'--enable-threads=yes'</code>
-       (described next).
+        (described next). 
      </p></dd><dt><span class="term"><code class="code">--enable-threads=OPTION</code></span></dt><dd><p>Select a threading library.  A full description is
-       given in the
-       general <a class="ulink" href="http://gcc.gnu.org/install/configure.html" target="_top">compiler
-       configuration instructions</a>. This option can change the
-       library ABI.
+        given in the
+        general <a class="ulink" href="http://gcc.gnu.org/install/configure.html" target="_top">compiler
+        configuration instructions</a>. This option can change the
+        library ABI.
      </p></dd><dt><span class="term"><code class="code">--enable-libstdcxx-debug</code></span></dt><dd><p>Build separate debug libraries in addition to what is normally built.
-       By default, the debug libraries are compiled with
-       <code class="code"> CXXFLAGS='-g3 -O0 -fno-inline'</code>
-       , are installed in <code class="code">${libdir}/debug</code>, and have the
-       same names and versioning information as the non-debug
-       libraries. This option is off by default.
+        By default, the debug libraries are compiled with 
+        <code class="code"> CXXFLAGS='-g3 -O0 -fno-inline'</code>
+        , are installed in <code class="code">${libdir}/debug</code>, and have the
+        same names and versioning information as the non-debug
+        libraries. This option is off by default.
      </p><p>Note this make command, executed in
-       the build directory, will do much the same thing, without the
-       configuration difference and without building everything twice:
-       <code class="code">make CXXFLAGS='-g3 -O0 -fno-inline' all</code>
+        the build directory, will do much the same thing, without the
+        configuration difference and without building everything twice: 
+        <code class="code">make CXXFLAGS='-g3 -O0 -fno-inline' all</code>
      </p></dd><dt><span class="term"><code class="code">--enable-libstdcxx-debug-flags=FLAGS</code></span></dt><dd><p>This option is only valid when <code class="code"> --enable-debug </code>
-       is also specified, and applies to the debug builds only. With
-       this option, you can pass a specific string of flags to the
-       compiler to use when building the debug versions of libstdc++.
-       FLAGS is a quoted string of options, like
+        is also specified, and applies to the debug builds only. With
+        this option, you can pass a specific string of flags to the
+        compiler to use when building the debug versions of libstdc++.
+        FLAGS is a quoted string of options, like
      </p><pre class="programlisting">
   --enable-libstdcxx-debug-flags='-g3 -O1 -fno-inline'</pre></dd><dt><span class="term"><code class="code">--enable-cxx-flags=FLAGS</code></span></dt><dd><p>With this option, you can pass a string of -f (functionality)
-       flags to the compiler to use when building libstdc++. This
-       option can change the library ABI. FLAGS is a quoted string of
-       options, like
+        flags to the compiler to use when building libstdc++. This
+        option can change the library ABI. FLAGS is a quoted string of
+        options, like
      </p><pre class="programlisting">
   --enable-cxx-flags='-fvtable-gc -fomit-frame-pointer -ansi'</pre><p>
-       Note that the flags don't necessarily have to all be -f flags,
-       as shown, but usually those are the ones that will make sense
-       for experimentation and configure-time overriding.
+        Note that the flags don't necessarily have to all be -f flags,
+        as shown, but usually those are the ones that will make sense
+        for experimentation and configure-time overriding.
      </p><p>The advantage of --enable-cxx-flags over setting CXXFLAGS in
-       the 'make' environment is that, if files are automatically
-       rebuilt, the same flags will be used when compiling those files
-       as well, so that everything matches.
+        the 'make' environment is that, if files are automatically
+        rebuilt, the same flags will be used when compiling those files
+        as well, so that everything matches.
      </p><p>Fun flags to try might include combinations of
      </p><pre class="programlisting">
   -fstrict-aliasing
   -fno-exceptions
   -ffunction-sections
   -fvtable-gc</pre><p>and opposite forms (-fno-) of the same.  Tell us (the libstdc++
-       mailing list) if you discover more!
+        mailing list) if you discover more!
      </p></dd><dt><span class="term"><code class="code">--enable-c99</code></span></dt><dd><p>The "long long" type was introduced in C99, along
-       with many other functions for wide characters, and math
-       classification macros, etc.  If enabled, all C99 functions not
-       specified by the C++ standard will be put into <code class="code">namespace
-       __gnu_cxx</code>, and then all these names will
-       be injected into namespace std, so that C99 functions can be
-       used "as if" they were in the C++ standard (as they
-       will eventually be in some future revision of the standard,
-       without a doubt).  By default, C99 support is on, assuming the
-       configure probes find all the necessary functions and bits
-       necessary. This option can change the library ABI.
+        with many other functions for wide characters, and math
+        classification macros, etc.  If enabled, all C99 functions not
+        specified by the C++ standard will be put into <code class="code">namespace
+        __gnu_cxx</code>, and then all these names will
+        be injected into namespace std, so that C99 functions can be
+        used "as if" they were in the C++ standard (as they
+        will eventually be in some future revision of the standard,
+        without a doubt).  By default, C99 support is on, assuming the
+        configure probes find all the necessary functions and bits
+        necessary. This option can change the library ABI.
     </p></dd><dt><span class="term"><code class="code">--enable-wchar_t</code>[default]</span></dt><dd><p>Template specializations for the "wchar_t" type are
-       required for wide character conversion support.  Disabling
-       wide character specializations may be expedient for initial
-       porting efforts, but builds only a subset of what is required by
-       ISO, and is not recommended.  By default, this option is on.
-       This option can change the library ABI.
+        required for wide character conversion support.  Disabling
+        wide character specializations may be expedient for initial
+        porting efforts, but builds only a subset of what is required by
+        ISO, and is not recommended.  By default, this option is on.
+        This option can change the library ABI.
      </p></dd><dt><span class="term"><code class="code">--enable-long-long  </code></span></dt><dd><p>The "long long" type was introduced in C99.  It is
-       provided as a GNU extension to C++98 in g++.  This flag builds
-       support for "long long" into the library (specialized
-       templates and the like for iostreams).  This option is on by default:
-       if enabled, users will have to either use the new-style "C"
-       headers by default (i.e., &lt;cmath&gt; not &lt;math.h&gt;)
-       or add appropriate compile-time flags to all compile lines to
-       allow "C" visibility of this feature (on GNU/Linux,
-       the flag is -D_ISOC99_SOURCE, which is added automatically via
-       CPLUSPLUS_CPP_SPEC's addition of _GNU_SOURCE).
-       This option can change the library ABI.
+        provided as a GNU extension to C++98 in g++.  This flag builds
+        support for "long long" into the library (specialized
+        templates and the like for iostreams).  This option is on by default:
+        if enabled, users will have to either use the new-style "C"
+        headers by default (i.e., &lt;cmath&gt; not &lt;math.h&gt;)
+        or add appropriate compile-time flags to all compile lines to
+        allow "C" visibility of this feature (on GNU/Linux,
+        the flag is -D_ISOC99_SOURCE, which is added automatically via
+        CPLUSPLUS_CPP_SPEC's addition of _GNU_SOURCE).
+        This option can change the library ABI. 
      </p></dd><dt><span class="term"><code class="code">--enable-fully-dynamic-string</code></span></dt><dd><p>This option enables a special version of basic_string avoiding
-       the optimization that allocates empty objects in static memory.
+        the optimization that allocates empty objects in static memory.
        Mostly useful together with shared memory allocators, see PR
        libstdc++/16612 for details.
      </p></dd><dt><span class="term"><code class="code">--enable-concept-checks</code></span></dt><dd><p>This turns on additional compile-time checks for instantiated
-       library templates, in the form of specialized templates,
-       <a class="link" href="bk01pt02ch05s02.html" title="Concept Checking">described here</a>.  They
-       can help users discover when they break the rules of the STL, before
-       their programs run.
+        library templates, in the form of specialized templates,
+        <a class="link" href="bk01pt03ch08.html" title="Chapter 8. Concept Checking">described here</a>.  They
+        can help users discover when they break the rules of the STL, before
+        their programs run.
      </p></dd><dt><span class="term"><code class="code">--enable-symvers[=style]</code></span></dt><dd><p>In 3.1 and later, tries to turn on symbol versioning in the
-       shared library (if a shared library has been
-       requested). Values for 'style' that are currently supported
-       are 'gnu', 'gnu-versioned-namespace', 'darwin', and
-       'darwin-export'. Both gnu- options require that a recent
-       version of the GNU linker be in use. Both darwin options are
-       equivalent. With no style given, the configure script will try
-       to guess correct defaults for the host system, probe to see if
-       additional requirements are necessary and present for
-       activation, and if so, will turn symbol versioning on. This
-       option can change the library ABI.
+        shared library (if a shared library has been
+        requested). Values for 'style' that are currently supported
+        are 'gnu', 'gnu-versioned-namespace', 'darwin', and
+        'darwin-export'. Both gnu- options require that a recent
+        version of the GNU linker be in use. Both darwin options are
+        equivalent. With no style given, the configure script will try
+        to guess correct defaults for the host system, probe to see if
+        additional requirements are necessary and present for
+        activation, and if so, will turn symbol versioning on. This
+        option can change the library ABI.
      </p></dd><dt><span class="term"><code class="code">--enable-visibility</code></span></dt><dd><p> In 4.2 and later, enables or disables visibility attributes.
-       If enabled (as by default), and the compiler seems capable of
-       passing the simple sanity checks thrown at it, adjusts items
-       in namespace std, namespace std::tr1, and namespace __gnu_cxx
-       so that -fvisibility options work.
+        If enabled (as by default), and the compiler seems capable of
+        passing the simple sanity checks thrown at it, adjusts items
+        in namespace std, namespace std::tr1, and namespace __gnu_cxx
+        so that -fvisibility options work.
     </p></dd><dt><span class="term"><code class="code">--enable-libstdcxx-pch</code></span></dt><dd><p>In 3.4 and later, tries to turn on the generation of
-       stdc++.h.gch, a pre-compiled file including all the standard
-       C++ includes. If enabled (as by default), and the compiler
-       seems capable of passing the simple sanity checks thrown at
-       it, try to build stdc++.h.gch as part of the make process.
-       In addition, this generated file is used later on (by appending <code class="code">
-       --include bits/stdc++.h </code> to CXXFLAGS) when running the
-       testsuite.
+        stdc++.h.gch, a pre-compiled file including all the standard
+        C++ includes. If enabled (as by default), and the compiler
+        seems capable of passing the simple sanity checks thrown at
+        it, try to build stdc++.h.gch as part of the make process. 
+        In addition, this generated file is used later on (by appending <code class="code">
+        --include bits/stdc++.h </code> to CXXFLAGS) when running the
+        testsuite.
      </p></dd><dt><span class="term"><code class="code">--disable-hosted-libstdcxx</code></span></dt><dd><p>
      By default, a complete <span class="emphasis"><em>hosted</em></span> C++ library is
      built.  The C++ Standard also describes a
      minimal set of headers are provided.  This option builds such an
      environment.
      </p></dd><dt><span class="term"><code class="code">--enable-libstdcxx-time</code></span></dt><dd><p>This is an abbreviated form of
-       <code class="code">'--enable-libstdcxx-time=yes'</code>(described next).
+        <code class="code">'--enable-libstdcxx-time=yes'</code>(described next).
      </p></dd><dt><span class="term"><code class="code">--enable-libstdcxx-time=OPTION</code></span></dt><dd><p>Enables link-type checks for the availability of the
-       clock_gettime clocks, used in the implementation of [time.clock],
-       and of the nanosleep and sched_yield functions, used in the
-       implementation of [thread.thread.this] of the current C++0x draft.
-       The choice OPTION=yes checks for the availability of the facilities
-       in libc and libposix4.  In case of need the latter is also linked
-       to libstdc++ as part of the build process.  OPTION=rt also searches
-       (and, in case, links) librt.   Note that the latter is not always
-       desirable because, in glibc, for example, in turn it triggers the
-       linking of libpthread too, which activates locking, a large overhead
-       for single-thread programs.  OPTION=no skips the tests completely.
-       The default is OPTION=no.
+        clock_gettime clocks, used in the implementation of [time.clock],
+        and of the nanosleep and sched_yield functions, used in the
+        implementation of [thread.thread.this] of the current C++0x draft.
+        The choice OPTION=yes checks for the availability of the facilities
+        in libc and libposix4.  In case of need the latter is also linked
+        to libstdc++ as part of the build process.  OPTION=rt also searches
+        (and, in case, links) librt.   Note that the latter is not always
+        desirable because, in glibc, for example, in turn it triggers the
+        linking of libpthread too, which activates locking, a large overhead
+        for single-thread programs.  OPTION=no skips the tests completely.
+        The default is OPTION=no.
     </p></dd></dl></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="setup.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="setup.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="make.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 2. Setup </td><td width="20%" align="center"><a accesskey="h" href="../spine.html">Home</a></td><td width="40%" align="right" valign="top"> Make</td></tr></table></div></body></html>