diff options
Diffstat (limited to 'libstdc++-v3/docs/html/configopts.html')
-rw-r--r-- | libstdc++-v3/docs/html/configopts.html | 75 |
1 files changed, 45 insertions, 30 deletions
diff --git a/libstdc++-v3/docs/html/configopts.html b/libstdc++-v3/docs/html/configopts.html index eab9864f330..4ba060363ca 100644 --- a/libstdc++-v3/docs/html/configopts.html +++ b/libstdc++-v3/docs/html/configopts.html @@ -17,13 +17,15 @@ <h1 class="centered"><a name="top">Interesting <code>configure</code> options</a></h1> -<p>The latest version of this document is always available at +<p class="fineprint"><em> + The latest version of this document is always available at <a href="http://gcc.gnu.org/onlinedocs/libstdc++/configopts.html"> http://gcc.gnu.org/onlinedocs/libstdc++/configopts.html</a>. -</p> +</em></p> -<p>To the <a href="http://gcc.gnu.org/libstdc++/">libstdc++-v3 homepage</a>. -</p> +<p><em> + To the <a href="http://gcc.gnu.org/libstdc++/">libstdc++-v3 homepage</a>. +</em></p> <!-- ####################################################### --> <hr /> @@ -76,23 +78,11 @@ options</a></h1> <dd><p>Adds support for named libstdc++ include directory. For instance, the following puts all the libstdc++ headers into a directory called "2.97-20001008" instead of the usual - "g++-v3". + "c++/(version)". </p> <pre> --with-gxx-include-dir=/foo/H-x86-gcc-3-c-gxx-inc/include/2.97-20001008</pre> </dd> - <dt><code>--enable-debug </code></dt> - <dd><p>The configure script will automatically detect the highest - level of optimization that the compiler in use can use. - This --enable flag will disable all optimizations and instruct - the compiler to emit as much extra debugging information as it - can, for use inside GDB. Note this make command, executed in - the build directory, will do much the same thing, without the - configuration difference: - <code>make CXXFLAGS='-g -O0' all</code> - </p> - </dd> - <dt><code>--enable-cstdio </code></dt> <dd><p>This is an abbreviated form of <code>'--enable-cstdio=stdio'</code> (described next). This option can change the library ABI. @@ -100,13 +90,10 @@ options</a></h1> </dd> <dt><code>--enable-cstdio=OPTION </code></dt> - <dd><p>Select a target-specific I/O package. As of libstdc++-v3 - snapshot 3.0.96, the choices are 'libio' to specify the GNU - 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'. A longer explanation - is <a href="explanations.html#cstdio">here</a>. + <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'. A longer explanation is <a + href="explanations.html#cstdio">here</a>. </p> </dd> @@ -157,6 +144,33 @@ options</a></h1> </p> </dd> + <dt><code>--enable-debug </code></dt> + <dd><p>Build separate debug libraries in addition to what is normally built. + By default, the debug libraries are compiled with + <code> CXXFLAGS='-g3 -O0'</code> + , are installed in <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>make CXXFLAGS='-g3 -O0' all</code> + </p> + </dd> + + <dt><code>--enable-debug-flags=FLAGS</code></dt> + + <dd><p>This option is only valid when <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 + </p> + <pre> + --enable-debug-flags='-g3 -O1 -gdwarf-2'</pre> + </dd> + <dt><code>--enable-cxx-flags=FLAGS</code></dt> <dd><p>With this option, you can pass a string of -f (functionality) flags to the compiler to use when building libstdc++. This @@ -238,12 +252,13 @@ options</a></h1> </dd> <dt><code>--enable-symvers[=style] </code></dt> - <dd><p>In 3.1, tries to turn on symbol versioning in the shared library (if a - shared library has been requested). The only 'style' currently - supported is 'gnu' which requires that a recent version of the GNU - linker be in use. With no style given, the configure script will - try to guess if the 'gnu' style can be used, and if so, will turn it - on. Hopefully people will volunteer to do other 'style' options. + <dd><p>In 3.1 and later, tries to turn on symbol versioning in the + shared library (if a shared library has been requested). The + only 'style' currently supported is 'gnu' which requires that + a recent version of the GNU linker be in use. With no style + given, the configure script will try to guess if the 'gnu' + style can be used, and if so, will turn it on. Hopefully + people will volunteer to do other 'style' options. </p> </dd> </dl> |