aboutsummaryrefslogtreecommitdiff
path: root/libstdc++-v3/docs/html/install.html
diff options
context:
space:
mode:
authorPhil Edwards <pme@gcc.gnu.org>2001-02-07 00:03:21 +0000
committerPhil Edwards <pme@gcc.gnu.org>2001-02-07 00:03:21 +0000
commit222bb619fbdc3775767cde2d500c92d58ce1d499 (patch)
tree0400ed0be7df372052c26bba69ebb9f937c93155 /libstdc++-v3/docs/html/install.html
parentca21b4a51c8e1c6f6f36188dd82be0596ba1722f (diff)
downloadgcc-222bb619fbdc3775767cde2d500c92d58ce1d499.zip
gcc-222bb619fbdc3775767cde2d500c92d58ce1d499.tar.gz
gcc-222bb619fbdc3775767cde2d500c92d58ce1d499.tar.bz2
configopts.html: Fix HTML markup.
2001-02-06 Phil Edwards <pme@sources.redhat.com> * docs/html/configopts.html: Fix HTML markup. * docs/html/install.html: Bring up to date. * docs/html/17_intro/C++STYLE: Add global variable conventions. * docs/html/21_strings/howto.html: More notes. * docs/html/22_locale/howto.html: Fix HTML markup. * docs/html/27_io/howto.html: More notes. * docs/html/27_io/binary_iostreams_kanze.txt: New file. * docs/html/27_io/binary_iostreams_kuehl.txt: New file. From-SVN: r39503
Diffstat (limited to 'libstdc++-v3/docs/html/install.html')
-rw-r--r--libstdc++-v3/docs/html/install.html67
1 files changed, 16 insertions, 51 deletions
diff --git a/libstdc++-v3/docs/html/install.html b/libstdc++-v3/docs/html/install.html
index be50063..fcc0c0d 100644
--- a/libstdc++-v3/docs/html/install.html
+++ b/libstdc++-v3/docs/html/install.html
@@ -7,7 +7,7 @@
<META NAME="GENERATOR" CONTENT="vi and eight fingers">
<TITLE>libstdc++-v3 Installation Instructions</TITLE>
<LINK REL=StyleSheet HREF="lib3styles.css">
-<!-- $Id: install.html,v 1.2 2001/01/21 09:36:09 pme Exp $ -->
+<!-- $Id: install.html,v 1.3 2001/01/23 17:02:26 pme Exp $ -->
</HEAD>
<BODY>
@@ -58,7 +58,8 @@
<P>If you don't have bash, and want to run <TT>'make check'</TT> to
test your build, you'll need to get bash 2.x. Also recommended
is GNU Make, since it is the only 'make' that will parse these
- makefiles correctly.
+ makefiles correctly. We are moving to DejaGNU, so you'll
+ probably want to get that.
</P>
<P>As of June 19, 2000, libstdc++ attempts to use tricky and
@@ -151,10 +152,11 @@
<P><B>...with a gcc-2.9[67] snapshot</B>
<P>Unpack the <EM>gccsrcdir</EM> and go into that directory. For
instance, <TT>gcc-2.95.2</TT> is a valid <EM>gccsrcdir</EM>.
- Once in <EM>gccsrcdir</EM>, you'll need to rename the libstdc++-v3
- directory which comes with that snapshot:
+ Once in <EM>gccsrcdir</EM>, you'll need to rename or delete
+ the libstdc++-v3 directory which comes with that snapshot:
<PRE>
- mv libstdc++-v3 libstdc++-v3-previous</PRE>
+ mv libstdc++-v3 libstdc++-v3-previous <STRONG>[OR]</STRONG>
+ rm -r libstdc++-v3</PRE>
</P>
<P>Next, unpack the libstdc++-v3 library tarball into the
<EM>gccsrcdir</EM> directory; it will create a
@@ -173,9 +175,11 @@
<P><B>...with CVS gcc</B>
<P>Check out or download the gcc sources: the resulting source
directory is <EM>gccsrcdir</EM>. Once in <EM>gccsrcdir</EM>,
- you'll need to rename the libstdc++-v3 directory which comes
- with that snapshot:
- mv libstdc++-v3 libstdc++-v3-previous</PRE>
+ you'll need to rename or delete the libstdc++-v3 directory
+ which comes with that snapshot:
+ <PRE>
+ mv libstdc++-v3 libstdc++-v3-previous <STRONG>[OR]</STRONG>
+ rm -r libstdc++-v3</PRE>
</P>
<P>Next, unpack the libstdc++-v3 library tarball into this
<EM>gccsrcdir</EM> directory; it will create a
@@ -208,13 +212,7 @@
<P><PRE>
cd <EM>gccbuilddir</EM>
- <EM>gccsrcdir</EM>/configure --prefix=<EM>destdir</EM> --enable-libstdcxx-v3</PRE>
- </P>
-
- <P>Adding <TT>--enable-libstdcxx-v3</TT> automatically selects libstdc++-v3
- as the C++ library to be used alongside the C++ compiler being built,
- and also enables -fhonor-std by default. This option is not available
- with gcc-2.95.2.
+ <EM>gccsrcdir</EM>/configure --prefix=<EM>destdir</EM> --other-opts...</PRE>
</P>
@@ -239,10 +237,6 @@
This will configure and build the C++ library in the
<EM>gccbuilddir/cpu-vendor-OS/</EM>libstdc++ directory.
</P>
- <P>If the build fails with a &quot;warning: can't inline call&quot;
- message when compiling stringMAIN.cc, see <A HREF="#Werror">the
- resolution at the end of this document</A>.
- </P>
<P>If you are rebuilding from a previous build [attempt], some
information is kept in a cache file. This is stored in
<EM>gccbuilddir/cpu-vendor-OS/</EM> if you are building with
@@ -258,7 +252,7 @@
or
<PRE>
make install-gcc
- make install-target-<EM>libstdc++-rule</EM></PRE>
+ make install-target-libstdc++-v3</PRE>
</P>
@@ -271,7 +265,7 @@
include/g++-v3/
bits/
ext/
- cpu-vendor-OS/include/g++-v3/
+ CPU-vendor-OS/include/g++-v3/
bits/
ext/</PRE>
</P>
@@ -326,35 +320,6 @@
</P>
-<HR>
-<H3><A NAME="Werror"><TT>warning: can't inline call to</TT>...</A></H3>
- <P>When building the .8 snapshot with g++ 2.95.2, compilation may halt
- with this warning message. The &quot;problem&quot; is the -Werror
- flag being passed to the compiler, which says to treat warnings as
- errors. (This plus a high warning level makes us track down bugs
- <EM>quickly</EM>.) The compiler can't inline a certain call, prints
- a warning, and dies.
- </P>
- <P>The workaround is to edit either <EM>libsrcdir</EM>/src/Makefile.in
- (before configuring) or <EM>bld-libstdc++</EM>/src/Makefile
- (after configuring). There's one line that reads
- <PRE>
- WERROR = -Werror</PRE>
- Delete the flag itself, so that the line reads
- <PRE>
- WERROR =</PRE>
- Then the compiler will still print a warning, but it won't die.
- </P>
- <P>For the curious, this &quot;problem&quot; is actually a symptom
- of something else. The compiler in CVS could inline more than what
- 2.95.2 does, and the libstdc++ changes were made with that
- compiler. One of the libstdc++ maintainers explains this
-<A HREF="http://gcc.gnu.org/ml/libstdc++/2000-q1/msg00420.html">here</A>.
- </P>
- <P>This has been patched in current CVS sources.
- </P>
-
-
<!--
<HR>
<H2><A NAME=""></A></H2>
@@ -370,7 +335,7 @@
Comments and suggestions are welcome, and may be sent to
<A HREF="mailto:pme@sources.redhat.com">Phil Edwards</A> or
<A HREF="mailto:gdr@gcc.gnu.org">Gabriel Dos Reis</A>.
-<BR> $Id: install.html,v 1.2 2001/01/21 09:36:09 pme Exp $
+<BR> $Id: install.html,v 1.3 2001/01/23 17:02:26 pme Exp $
</EM></P>