From: Yufeng Zhang Date: Sun, 21 Oct 2012 23:42:17 +0000 (+0000) Subject: configure.xml (--enable-clocale): Document the 'newlib' and 'darwin' options. X-Git-Tag: misc/gccgo-go1_1_2~60 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=e3b0260052f9f768e63e4a7107c5aea4df06ea19;p=thirdparty%2Fgcc.git configure.xml (--enable-clocale): Document the 'newlib' and 'darwin' options. 2012-10-22 Yufeng Zhang Jonathan Wakely * doc/xml/manual/configure.xml (--enable-clocale): Document the 'newlib' and 'darwin' options. Minor stylistic improvements. Co-Authored-By: Jonathan Wakely From-SVN: r192661 --- diff --git a/libstdc++-v3/ChangeLog b/libstdc++-v3/ChangeLog index 2267a26aed82..0e31df93635d 100644 --- a/libstdc++-v3/ChangeLog +++ b/libstdc++-v3/ChangeLog @@ -1,3 +1,9 @@ +2012-10-22 Yufeng Zhang + Jonathan Wakely + + * doc/xml/manual/configure.xml (--enable-clocale): Document the + 'newlib' and 'darwin' options. Minor stylistic improvements. + 2012-10-21 François Dumont * 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 bc98d7a16e95..827b2322f486 100644 --- a/libstdc++-v3/doc/xml/manual/configure.xml +++ b/libstdc++-v3/doc/xml/manual/configure.xml @@ -38,7 +38,7 @@ 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:./configure --help. + source directory and then type: ./configure --help. @@ -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 glibc, 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 wchar_t specializations + needed by the 'generic' model. - If not explicitly specified, the configure proccess tries + 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 ('--with_newlib=yes') and OpenBSD, 'newlib' is + automatically selected. On Mac OS X 'darwin' is automatically selected. + This option can change the library ABI. @@ -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 @@ --enable-c99 - The "long long" type was introduced in C99, along + 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 namespace @@ -264,7 +269,7 @@ --enable-wchar_t[default] - Template specializations for the "wchar_t" type are + 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 @@ -274,7 +279,7 @@ --enable-long-long - The "long long" type was introduced in C99. It is + 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: @@ -351,7 +356,7 @@ Use extern template to pre-instantiate all required specializations for certain types defined in the standard libraries. These types include string and dependents like - char_traits, the templateized io classes, + char_traits, the templatized IO classes, allocator, and others. Disabling means that implicit template generation will be used when compiling these types. By