libstdc++-v3 configure options

From 0505b0467fcabcc8f0cca07596ffd43662b5fbd0 Mon Sep 17 00:00:00 2001 From: Phil Edwards Date: Sun, 21 Jan 2001 09:36:09 +0000 Subject: [PATCH] configopts.html: Update for current status. 2001-01-21 Phil Edwards * docs/html/configopts.html: Update for current status. Fix HTML. * docs/html/install.html: Update for current status. From-SVN: r39166 --- libstdc++-v3/ChangeLog | 5 ++ libstdc++-v3/docs/html/configopts.html | 21 ++--- libstdc++-v3/docs/html/install.html | 102 +++++++++---------------- 3 files changed, 51 insertions(+), 77 deletions(-) diff --git a/libstdc++-v3/ChangeLog b/libstdc++-v3/ChangeLog index ab8ace7c75d..753ef372b31 100644 --- a/libstdc++-v3/ChangeLog +++ b/libstdc++-v3/ChangeLog @@ -1,3 +1,8 @@ +2001-01-21 Phil Edwards + + * docs/html/configopts.html: Update for current status. Fix HTML. + * docs/html/install.html: Update for current status. + 2001-01-20 Gabriel Dos Reis * testsuite/libstdc++.tests/tests.exp: New file. diff --git a/libstdc++-v3/docs/html/configopts.html b/libstdc++-v3/docs/html/configopts.html index 4e97fe91a54..3510ef3813c 100644 --- a/libstdc++-v3/docs/html/configopts.html +++ b/libstdc++-v3/docs/html/configopts.html @@ -7,7 +7,7 @@ libstdc++-v3 configure options - + @@ -55,7 +55,7 @@ options inside GDB.

--enable-cstdio [default] +

--enable-cstdio

This is an abbreviated form of '--enable-cstdio=stdio' (described next).

@@ -65,7 +65,8 @@ options snapshot 2.91, the choices are 'libio' to specify the GNU I/O package (from glibc, the - GNU C library), or 'stdio' to use a generic "C" abstraction. + GNU C library), or 'stdio' to use a generic "C" + abstraction. The default is 'stdio'.

--enable-long-long @@ -73,11 +74,11 @@ options 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) 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). + default: if enabled, users will have to either use the + new-style "C" headers by default (ie 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).

--enable-cheaders=OPTION @@ -106,7 +107,7 @@ options

All of this is currently undergoing a lot of changes. As of 2.91, 'single' and 'posix' are the only implemented - models. Default is off. + models. Default is single.

--enable-version-specific-runtime-libs @@ -177,7 +178,7 @@ options

-$Id: configopts.html,v 1.2 2000/12/21 22:52:51 bkoz Exp $ +$Id: configopts.html,v 1.3 2001/01/03 15:53:27 bkoz Exp $

diff --git a/libstdc++-v3/docs/html/install.html b/libstdc++-v3/docs/html/install.html index 1a6b8114d27..d1a399d5b07 100644 --- a/libstdc++-v3/docs/html/install.html +++ b/libstdc++-v3/docs/html/install.html @@ -7,7 +7,7 @@ libstdc++-v3 Installation Instructions - + @@ -39,7 +39,7 @@

Tools you will need beforehand

You will need a recent version of g++ to compile the snapshot of - libstdc++: gcc-2.95.2 works well, or one of the post-2.95.2 GCC + libstdc++, one of the post-2.95.2 GCC snapshots (insert standard caveat about using snapshots rather than formal releases). You will need the full source distribution to whatever compiler release you are using. The @@ -86,11 +86,6 @@ and above) as earlier versions supposedly had problems creating shared libraries. -

Solaris -

We recommend installing the SUNWxcu4 package from the - Solaris CD before configuring the library. You can check for - this package as a non-privileged user with the command - "pkginfo SUNWxcu4".

@@ -133,7 +128,7 @@ Note:

The .8 snapshot and following are intended to replace the +

The .91 snapshot and following are intended to replace the library that comes with the compiler, so libsrcdir and libbuilddir must be contained under gccsrcdir and gccbuilddir, respectively. @@ -147,21 +142,19 @@

Since the release of libstdc++-2.90.8, configuration patches have gone into CVS gcc that make the management of the various libstdc++ source trees a bit easier. Because of this, both libstdc++-v2 and - libstdc++-v3 and live together more or less in peace, without the need - for soft linking. If a CVS gcc source directory after April 5, 2000 is - being used, then the directions are slightly different: please pick - which of the following two scenarios best represents your particular - situation. + libstdc++-v3 and live together in peace, without the need + for soft linking. The setup instructions are slightly different, + depending on whether you want to use CVS gcc or a snapshot. Please + choose the appropriate scenario:

...with gcc-2.95.2 +

...with a gcc-2.9[67] snapshot

Unpack the gccsrcdir and go into that directory. For - instance, gcc-2.95.2 is a valid gccsrcdir. - Once in gccsrcdir, you'll need to rename the directories - called libstdc++ and libio like so: +X instance, gcc-2.95.2 is a valid gccsrcdir. + Once in gccsrcdir, you'll need to rename the libstdc++-v3 + directory which comes with that snapshot:

-   mv libstdc++ libstdc++-v2
-   mv libio libio-v2

+ mv libstdc++-v3 libstdc++-v3-previous

Next, unpack the libstdc++-v3 library tarball into the gccsrcdir directory; it will create a @@ -170,21 +163,19 @@ gzip -dc libstdc++-version.tar.gz | tar xf -

Finally, make a soft link between libsrcdir and - libstdc++ so that libstdc++-v3 will be the default C++ + libstdc++-v3 so that libstdc++-v3 will be the default C++ library used.

-   ln -s libsrcdir libstdc++

- This complexity of having two completely separate libstdc++ - libraries is necessary so that you can unlink libsrcdir - and update the compiler sources. If you're not this adventurous, or - would not like to switch between different C++ standard libraries, - this extra effort is probably wasted; just remove the v2 sources. + ln -s libsrcdir libstdc++-v3

...with CVS gcc

Check out or download the gcc sources: the resulting source - directory is gccsrcdir. + directory is gccsrcdir. Once in gccsrcdir, + you'll need to rename the libstdc++-v3 directory which comes + with that snapshot: + mv libstdc++-v3 libstdc++-v3-previous

Next, unpack the libstdc++-v3 library tarball into this gccsrcdir directory; it will create a @@ -192,11 +183,6 @@

    gzip -dc libstdc++-version.tar.gz | tar xf -

- -

If CVS libstdc++-v3 is being used instead of a snapshot's tarball, - then move the source directory from the CVS checkout into the - gccsrcdir directory. -

Finally, rename libsrcdir to libstdc++-v3 so that gcc's configure flags will be able to deal with the new library.

@@ -207,6 +193,10 @@
 
 
 Configuring
+   If you have never done this before, you should read the basic
+      GCC Installation
+      Instructions first.
+   
    Due to namespaces, when building libstdc++-v3 you'll have to configure
       the entire gccsrcdir directory.  The full list of libstdc++-v3
       specific configuration options, not dependent on the specific compiler
@@ -216,13 +206,8 @@
       building the C++ language parts.
    
 
-   ...with gcc-2.95.2
-      
-   gccsrcdir/configure --prefix=destdir
-   
-   
-   ...with CVS gcc 
-      
+   
+   cd gccbuilddir
    gccsrcdir/configure --prefix=destdir --enable-libstdcxx-v3
    
    
@@ -242,37 +227,17 @@
       as its default C++ library.  The generated g++ will magically
       use the correct headers, link against the correct library
       binary, and in general using libstdc++-v3 will be a piece of
-      cake.  You're done; run 'make install' (the GCC
-      Installation instructions) to put the new compiler and libraries
+      cake.  You're done; run 'make install' (see the GCC
+      installation instructions) to put the new compiler and libraries
       into place.
    
 
    [re]building only libstdc++
-   Due to differences in the configure process, the resulting Makefiles
-      in thegccbuilddir will have different rules depending on
-      the source base being used.
-   
-
-   ...with gcc-2.95.2
-      

-      libstdc++-rule is libstdc++
-      
-   
-   
-   ...with CVS gcc 
-      

-      libstdc++-rule is libstdc++-v3
-      
-   
-   
    To rebuild just libstdc++, use:
       
-   make all-target-libstdc++-rule
+   make all-target-libstdc++-v3
       This will configure and build the C++ library in the
       gccbuilddir/cpu-vendor-OS/libstdc++ directory.
-      As en example, for CVS gcc this would be
-      make all-target-libstdc++-v3, and for gcc-2.95.2 it would be
-      make all-target-libstdc++
    
    If the build fails with a "warning: can't inline call"
       message when compiling stringMAIN.cc, see the
@@ -305,7 +270,9 @@
    lib/
    include/g++-v3/
       bits/
-      backward/
+      ext/
+   cpu-vendor-OS/include/g++-v3/
+      bits/
       ext/

You can check the status of the build without installing it using @@ -313,7 +280,8 @@ make check or you can check the status of the installed library using

-   make check-target-libstdc++-rule

+ make check-install + in the libbuilddir directory. These commands will create a 'testsuite' directory underneath libbuilddir containing the results of the tests. We are interested in any strange failures of the testsuite; please see @@ -344,8 +312,8 @@ which will in turn pass them on to the linker. The exact format of the options is dependent on which linker you use:

GNU ld (default on Linux): -Wl,--rpath -Wl,destdir/lib -
IRIX ld: -Wl,-rpath -Wl,destdir/lib +
GNU ld (default on Linux): -Wl,--rpath,destdir/lib +
IRIX ld: -Wl,-rpath,destdir/lib
Solaris ld: -Wl,-Rdestdir/lib
More...?

@@ -402,7 +370,7 @@ Comments and suggestions are welcome, and may be sent to Phil Edwards or Gabriel Dos Reis. -
$Id: install.html,v 1.12 2000/12/03 23:47:47 jsm28 Exp $ +
$Id: install.html,v 1.1 2000/12/10 04:03:08 pme Exp $

-- 2.30.2