diff options
Diffstat (limited to 'libstdc++-v3/docs/html/configopts.html')
-rw-r--r-- | libstdc++-v3/docs/html/configopts.html | 89 |
1 files changed, 54 insertions, 35 deletions
diff --git a/libstdc++-v3/docs/html/configopts.html b/libstdc++-v3/docs/html/configopts.html index 78572aa902e..8be2b14e704 100644 --- a/libstdc++-v3/docs/html/configopts.html +++ b/libstdc++-v3/docs/html/configopts.html @@ -7,7 +7,7 @@ <META NAME="GENERATOR" CONTENT="vi and eight fingers"> <TITLE>libstdc++-v3 configure options</TITLE> <LINK REL=StyleSheet HREF="lib3styles.css"> -<!-- $Id: configopts.html,v 1.5 2001/01/30 09:18:50 bkoz Exp $ --> +<!-- $Id: configopts.html,v 1.6.2.4 2001/07/09 19:38:58 pme Exp $ --> </HEAD> <BODY> @@ -66,7 +66,15 @@ options</A></H1> I/O package (from <A HREF="http://sources.redhat.com/glibc/">glibc</A>, the GNU C library), or 'stdio' to use a generic "C" - abstraction. The default is 'stdio'. + abstraction. The default is 'stdio'. A longer explanation + is <A HREF="explanations.html#cstdio">here</A>. + </P> + + <DT><TT>--enable-sjlj-exceptions </TT> + <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. </P> <DT><TT>--enable-clocale </TT> @@ -75,33 +83,45 @@ options</A></H1> </P> <DT><TT>--enable-clocale=MODEL </TT> - <DD><P>Select a target-specific underlying locale package. The - choices are 'gnu' to specify an X/Open (IEEE Std. 1003.1-200x) - model based on langinfo/iconv (from <A - HREF="http://sources.redhat.com/glibc/">glibc</A>, the GNU C - library), or 'generic' to use a generic "C" - abstraction which consists of "C" locale info. - The default is 'generic'. - </P> + <DD><P>Select a target-specific underlying locale package. The choices + are 'gnu' to specify an X/Open (IEEE Std. 1003.1-200x) model based + on langinfo/iconv (from + <A HREF="http://sources.redhat.com/glibc/">glibc</A>, the GNU C + library), or 'generic' to use a generic "C" abstraction + which consists of "C" locale info. The default is 'generic'. + </P> + + <DT><TT>--enable-c99 </TT> + <DD><P>The "long long" type was introduced in C99, along + with bunches of 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 <TT>namespace + c99</TT>, and then all names in the c99 namespace 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. + </P> <DT><TT>--enable-long-long </TT> <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). This option is off by - default: if enabled, users will have to either use the - new-style "C" headers by default (ie cmath not math.h) + 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., <cmath> not <math.h>) 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). + the flag is -D_ISOC99_SOURCE, which is added automatically via + CPLUSPLUS_CPP_SPEC's addition of _GNU_SOURCE). </P> <DT><TT>--enable-cheaders=OPTION </TT> <DD><P>This allows the user to define what kind of C headers are - used. Options are: c, c_std, and c_shadow. These correspond - to the source directory's include/c, include/c_std, and - include/c_shadow directories. - The default is c_std. + used. Options are: c, c_std, and c_shadow. These correspond + to the source directory's include/c, include/c_std, and + include/c_shadow directories. The default is c_std. </P> <DT><TT>--enable-threads </TT> @@ -127,14 +147,14 @@ options</A></H1> <DT><TT>--enable-version-specific-runtime-libs </TT> <DD><P>Specify that run-time libraries should be installed in the - compiler-specific subdirectory (i.e., - <TT>$(libdir)/gcc-lib/$(target_alias)/$(gcc_version)</TT>) - instead of <TT>$(libdir)</TT>. 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 - <TT>$(libdir)/gcc-lib/$(target_alias)/$(gcc_version)/include/g++</TT>, - unless you also specify - <TT>--with-gxx-include-dir=_dirname_</TT> during configuration. + compiler-specific subdirectory (i.e., + <TT>${libdir}/gcc-lib/${target_alias}/${gcc_version}</TT>) + instead of <TT>${libdir}</TT>. 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 + <TT>${libdir}/gcc-lib/${target_alias}/${gcc_version}/include/g++</TT>, + unless you also specify + <TT>--with-gxx-include-dir=<EM>dirname</EM></TT> during configuration. </P> <DT><TT>--with-gxx-include-dir=<include-files dir></TT> @@ -151,25 +171,24 @@ options</A></H1> flags to the compiler to use when building libstdc++. FLAGS is a quoted string of options, like <PRE> - --enable-cxx-flags='-fsquangle -fvtable-gc -ansi'</PRE> + --enable-cxx-flags='-fvtable-gc -fomit-frame-pointer -ansi'</PRE> 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 libgcc is automatically + 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 <PRE> -fstrict-aliasing - -fnew-abi - -fnew-exceptions + -fno-exceptions -ffunction-sections -fvtable-gc</PRE> - and -fno- forms of the same. Tell us (the mailing list) if - you discover more! + and opposite forms (-fno-) of the same. Tell us (the mailing + list) if you discover more! </P> <DT><TT>--enable-c-mbchar </TT>[default] @@ -178,7 +197,7 @@ options</A></H1> changing rapidly, and can cause problems on new platforms. Disabling wide character specializations is useful for initial porting steps, but builds only a subset of what is required by - ISO. Default is on, but the <TT>--enable-c_stdio=stdio </TT> + ISO. Default is on, but the <TT>--enable-cstdio=stdio </TT> option currently turns it off. </P> </DL> @@ -192,7 +211,7 @@ options</A></H1> <HR> <P CLASS="fineprint"><EM> -$Id: configopts.html,v 1.5 2001/01/30 09:18:50 bkoz Exp $ +$Id: configopts.html,v 1.6.2.4 2001/07/09 19:38:58 pme Exp $ </EM></P> |