diff options
author | Yufeng Zhang <yufeng.zhang@arm.com> | 2012-10-21 23:42:17 +0000 |
---|---|---|
committer | Jonathan Wakely <redi@gcc.gnu.org> | 2012-10-22 00:42:17 +0100 |
commit | e3b0260052f9f768e63e4a7107c5aea4df06ea19 (patch) | |
tree | 94cbbf38b4b23dfe5d0ea163752193d95ae88671 /libstdc++-v3 | |
parent | cab54dfa3ad330dd2ccb876e85112cc4363786d5 (diff) | |
download | gcc-e3b0260052f9f768e63e4a7107c5aea4df06ea19.zip gcc-e3b0260052f9f768e63e4a7107c5aea4df06ea19.tar.gz gcc-e3b0260052f9f768e63e4a7107c5aea4df06ea19.tar.bz2 |
configure.xml (--enable-clocale): Document the 'newlib' and 'darwin' options.
2012-10-22 Yufeng Zhang <yufeng.zhang@arm.com>
Jonathan Wakely <jwakely.gcc@gmail.com>
* doc/xml/manual/configure.xml (--enable-clocale): Document the
'newlib' and 'darwin' options. Minor stylistic improvements.
Co-Authored-By: Jonathan Wakely <jwakely.gcc@gmail.com>
From-SVN: r192661
Diffstat (limited to 'libstdc++-v3')
-rw-r--r-- | libstdc++-v3/ChangeLog | 6 | ||||
-rw-r--r-- | libstdc++-v3/doc/xml/manual/configure.xml | 29 |
2 files changed, 23 insertions, 12 deletions
diff --git a/libstdc++-v3/ChangeLog b/libstdc++-v3/ChangeLog index 2267a26..0e31df9 100644 --- a/libstdc++-v3/ChangeLog +++ b/libstdc++-v3/ChangeLog @@ -1,3 +1,9 @@ +2012-10-22 Yufeng Zhang <yufeng.zhang@arm.com> + Jonathan Wakely <jwakely.gcc@gmail.com> + + * doc/xml/manual/configure.xml (--enable-clocale): Document the + 'newlib' and 'darwin' options. Minor stylistic improvements. + 2012-10-21 François Dumont <fdumont@gcc.gnu.org> * include/profile/map.h (map::emplace_hint): Remove invalid diff --git a/libstdc++-v3/doc/xml/manual/configure.xml b/libstdc++-v3/doc/xml/manual/configure.xml index bc98d7a..827b232 100644 --- a/libstdc++-v3/doc/xml/manual/configure.xml +++ b/libstdc++-v3/doc/xml/manual/configure.xml @@ -38,7 +38,7 @@ </para> <para>The canonical way to find out the configure options that are available for a given set of libstdc++ sources is to go to the - source directory and then type:<command>./configure --help</command>. + source directory and then type: <command>./configure --help</command>. </para> <variablelist> @@ -107,15 +107,20 @@ (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 <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://sources.redhat.com/glibc/">glibc</link>, the GNU C - library), or 'generic' to use a generic "C" - abstraction which consists of "C" locale info. + library), 'generic' to use a generic "C" abstraction which consists + of "C" locale info, 'newlib' to specify the Newlib C library model + which only differs from the 'generic' model in the handling of + ctype, or 'darwin' which omits the <type>wchar_t</type> specializations + needed by the 'generic' model. </para> - <para>If not explicitly specified, the configure proccess tries + <para>If not explicitly specified, the configure process tries to guess the most suitable package from the choices above. The default is 'generic'. On glibc-based systems of sufficient - vintage (2.3 and newer), 'gnu' is automatically selected. This option - can change the library ABI. + vintage (2.3 and newer), 'gnu' is automatically selected. On newlib-based + systems (<code>'--with_newlib=yes'</code>) and OpenBSD, 'newlib' is + automatically selected. On Mac OS X 'darwin' is automatically selected. + This option can change the library ABI. </para> </listitem></varlistentry> @@ -181,9 +186,9 @@ and of the nanosleep and sched_yield functions, used in the implementation of [thread.thread.this] of the 2011 ISO C++ standard. The choice OPTION=yes checks for the availability of the facilities - in libc and libposix4. In case of need the latter is also linked + in libc and libposix4. In case it's needed 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 + (and, if needed, 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. @@ -249,7 +254,7 @@ </listitem></varlistentry> <varlistentry><term><code>--enable-c99</code></term> - <listitem><para>The "long long" type was introduced in C99, along + <listitem><para>The <type>long long</type> 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>namespace @@ -264,7 +269,7 @@ </listitem></varlistentry> <varlistentry><term><code>--enable-wchar_t</code>[default]</term> - <listitem><para>Template specializations for the "wchar_t" type are + <listitem><para>Template specializations for the <type>wchar_t</type> 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 @@ -274,7 +279,7 @@ </listitem></varlistentry> <varlistentry><term><code>--enable-long-long </code></term> - <listitem><para>The "long long" type was introduced in C99. It is + <listitem><para>The <type>long long</type> 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: @@ -351,7 +356,7 @@ <listitem><para>Use extern template to pre-instantiate all required specializations for certain types defined in the standard libraries. These types include <classname>string</classname> and dependents like - <classname>char_traits</classname>, the templateized io classes, + <classname>char_traits</classname>, the templatized IO classes, <classname>allocator</classname>, and others. Disabling means that implicit template generation will be used when compiling these types. By |