head	1.12;
access;
symbols;
locks; strict;
comment	@# @;


1.12
date	2000.03.24.19.29.42;	author bkoz;	state Exp;
branches;
next	1.11;

1.11
date	2000.03.23.20.58.37;	author pme;	state Exp;
branches;
next	1.10;

1.10
date	2000.03.22.08.35.31;	author bkoz;	state Exp;
branches;
next	1.9;

1.9
date	2000.03.21.03.54.40;	author bkoz;	state Exp;
branches;
next	1.8;

1.8
date	99.12.20.20.05.38;	author bkoz;	state Exp;
branches;
next	1.7;

1.7
date	99.12.18.19.24.23;	author gdr;	state Exp;
branches;
next	1.6;

1.6
date	99.12.18.10.16.41;	author bkoz;	state Exp;
branches;
next	1.5;

1.5
date	99.08.12.03.54.16;	author bkoz;	state Exp;
branches;
next	1.4;

1.4
date	99.08.04.03.50.17;	author bkoz;	state Exp;
branches;
next	1.3;

1.3
date	99.05.18.15.34.29;	author gdr;	state Exp;
branches;
next	1.2;

1.2
date	99.05.18.15.00.19;	author bkoz;	state Exp;
branches;
next	1.1;

1.1
date	99.05.11.23.50.48;	author bkoz;	state Exp;
branches;
next	;


desc
@@


1.12
log
@
2000-03-24  Benjamin Kosnik  <bkoz@@cygnus.com>

	* docs/17_intro/RELEASE-NOTES: Fix typos.
	* docs/index.html: Update.
	* docs/17_intro/BUGS: Update.
	* docs/status.html: Update for 2.90.8 release.
@
text
@2000-03-24

Release Notes   
-------------
The Standard C++ Library v3, or libstdc++-2.90.x, is an ongoing
project to implement the ISO 14882 Standard C++ library as described
in chapters 17 through 27 and annex D, as a drop-in replacement
for the current (ARM-conformant) library.

This is the ninth snapshot of the libstdc++ rewrite.  It is still
incomplet and incorrekt. It's a lot less incomplete and incorrect than
some of the earlier snapshots though, and quite usable.

The Standard C++ Library v3, or libstdc++-2.90.x, follows an open
development model, attempting to be fully buzzword, bazaar, and GNU
compliant. Full details on participating, including contributor
guidelines, mailing list subscription, mailing list archives,
up-to-date documentation, and various and sundry other details can be
found at the following URL:

  http://sourceware.cygnus.com/libstdc++/


New: 
--- 

- MT safe string. Supported CPUs are alpha, powerpc, x86, sparc32 and sparc64.
- Configure support for --enable-threads=posix, as well as initial IO
  locking implementation.
- Support for native building on Solaris 2.5.1, Solaris 2.6, Solaris
  2.7, cygwin, [alpha, powerpc, x86]-linux, and preliminary support for
  Irix and Aix4.2, Aix 4.3 hosts.
- --enable-namespaces is on by default.
- Configure and Makefile support for "drop-in" replacement to
  libstdc++-v2 completed. It is now possible to bootstrap g++, and
  have g++ find libstdc++-v3 headers and libraries by default.
- Synched with CVS egcs libio. 
- Cygwin native compiling supported.
- Cross compiling and embedded targets (newlib) with multilibs support added.
- SGI's strstream implementation has been added.
- Copyright on all sources assigned to the FSF.
- Configure, build and install documentation has been added.
- Support to enable long long has been added.
- More valarray improvements.
- Extractors and inserters for std::complex have been added.
- Extractors and inserters for void* have been fixed.
- autoconf macros are now in _GLIBCPP_ namespace.
- group checking for num_get implemented.
- Many, many bug fixes.


What doesn't:
-------------
- see BUGS.

 
Build and Install
-----------------
Up to date build and install directions can be found at:
http://sourceware.cygnus.com/libstdc++/install.html


Contact:
--------
Places have changed from previous snapshots.  The web page, which has
information about joining the mailing list and searching its archives,
CVS access, and contribution information is now at:

  http://sourceware.cygnus.com/libstdc++/

Please note that the mailing list has recently moved, and is now
hosted on sourceware.cygnus.com. (The web site above has the most
up-to-date info.)
   
Obtain the library snapshot via ftp (including these release notes) from

  ftp://sourceware.cygnus.com/pub/libstdc++/

The library is maintained by Benjamin Kosnik, Nathan Myers, Gabriel
Dos Reis, and Ulrich Drepper.  


Development tools:
------------------
You will need a recent version of gcc to compile the snapshot of
libstdc++. The recently released gcc-2.95.2 works well. In addition,
you may need up-to-date tools for modifying Makefiles and regenerating
configure scripts: automake (version 1.4 from Cygnus, not the one on
the net) and autoconf (version 2.13 and higher). Please see the
website for more info on where to obtain these additional tools.

If you compile programs -fnew-abi -fno-honor-std, uses of RTTI and
certain other language features will link only if you build your
compiler's libgcc using the same flags.  (The defaults use the old
abi.)  Using -fnew-abi offers real benefits, but note that it is not
stable: later snapshots will *not* be binary-compatible with code
compiled with older snapshots. See the configuration options page in
the Documentation section.

@


1.11
log
@2000-03-23  Phil Edwards  <pme@@sourceware.cygnus.com>

	* Makefile.am:  Better error message when missing libgcc2.ready.
	* Makefile.in:  Regenerate.
	* acinclude.m4:  Fastidious nitpicking reformatting.
	* aclocal.m4:  Regenerate.
	* configure:  Regenerate.
	* mkcheck.in:  Must use same namespace settings as the library being
	  tested.  Also log ST_FLAG, since it's being passed.
	* docs/install.html:  Add brief chunk on configuration.
	* docs/17_intro/RELEASE-NOTES:  Fix minor Cygwin typo.
	* docs/23_containers/howto.html:  Mention MT-safe string.
	* docs/faq/index.html:  Minor updates.
	* docs/faq/index.txt:  Regerarate.
@
text
@d5 1
a5 1
The Standard C++ Library v3, or libstc++-2.90.x, is an ongoing
d14 1
a14 1
The Standard C++ Library v3, or libstc++-2.90.x, follows an open
@


1.10
log
@
2000-03-21  Benjamin Kosnik  <bkoz@@cygnus.com>

	* docs/17_intro/RELEASE-NOTES (New): Add bits.

	* configure.in: Move AC_CHECK_HEADERS to a point where we know we
	are compiling natively.

	* libio/*: Update to CVS libio from egcs.
@
text
@d27 1
a27 1
- MT safe string. Supported cpus are alpha, powerpc, x86, sparc32 and sparc64.
d31 1
a31 1
  2.7, cywin, [alpha, powerpc, x86]-linux, and preliminary support for
@


1.9
log
@
2000-03-20  Benjamin Kosnik  <bkoz@@cygnus.com>

	* docs/configopts.html: Explain what "hella versions" means.
	* docs/install.html: Some tweaks--nice job on this Phil.
	* docs/documentation.html: Add a direct link to configuration options.

	* src/Makefile.am (OPTIMIZE_CXXFLAGS): Add in extras.
	* docs/17_intro/RELEASE-NOTES (New): Add.
	* bits/c++config.h (__GLIBCPP__): Bump version.

	* config/c_io_libio.cc (__basic__file(__c_lock*)): Change argument
	type to match prototype.
@
text
@d27 22
@


1.8
log
@
1999-12-20  Benjamin Kosnik  <bkoz@@cygnus.com>

	* docs/17_intro/RELEASE-NOTES: Fix typos.

	* bits/locale_facets.h (ctype): Modify, use __to_type to abstract
	out platform-specific bits.
	* config/default/ctype.cc: And here.
	* config/defaults/bits/ctype_base.h: And here.
	* config/linux/ctype.cc: And here.
	* config/linux/bits/ctype_base.h (ctype_base): And here.
	* config/solaris/bits/ctype_base.h (ctype_base): Add
	__to_type. Comment, as it looks like this is for solaris2.6 and
	above: solaris2.5.1 doesn't seem to have the same definitions.
	* config/solaris/ctype.cc: And here.
@
text
@d1 1
a1 1
1999-12-20
d10 3
a12 2
This is the eigth snapshot of the libstdc++ rewrite.  It is still 
incomplet and incorrekt.  
d26 1
a26 35
- Now compiling with -Wall -Werror -Winline works, and is on by default.
- Conditional compilation for hosts that don't support wchar_t.
- Attempts have been made to get this to compile hosted on cygwin. 
  Mumit Khan has done bunches here.
- Chapter 22:
  Kevin Ediger did some killer formatting work for the floating point parts of 
  num_put::do_put.
- Chapter 26: 
  valarray fixes: 
    the non-standard member function
    'valarray<T>::product()' is removed for Standard compliance purpose.
    Some missing non member functions (e.g. tanh) are added.
    valarray::sum() now uses operator+= instead of operator+.
    valarray::min() and valarray::max() no longer causes parse errors.
    Typographical errors that used to cause a seg fault are corrected.
  complex fixes:  some missing constructors are added.
  Optimized calling of cmath funcs for targets that support builtin functions.
  mknumeric_limits was robustified.
- Chapter 27: 
  Preliminary inlining for all buffering and iostream classes and manipulators.
  Testing for istream and ostream operators complete.
  istream validation testing complete.
  ostream formatting validations mostly complete.
  ostream<<operator(float, double, etc.) now work.
  Testing for correct stream state and thrown exceptions complete.
  A lot of stringbuf changes.
  Attempts to make includes take as little time as possible.
  streambuf to streambuf copies now work.
  A brain-dead and in-elegant (but conformant) facet caching mechanism
  replaces the elegant but non-conformant design.
  iostream callbacks now work correctly.
  A lot of the library working group issues are now implemented.
- Additional documentation by Phil Edwards.
- New website and mailing list interface.
- For CVS egcs, -O2 and tree-level inlining works.
d37 2
a38 61
Unpack the tarball using GNU tar; it will create a directory libstdc++-2.90.7.

  tar xfz libstdc++-2.90.7.tar.gz

It's recommended that you create a separate build directory apart from
the source directory for the building of the library: this is optimal,
and will be assumed for the rest of the instructions. (It is possible
to configure/build in the same directory.) Call this build directory
(say) bld-libstdc++, and cd into it:

  mkdir bld-libstdc++
  cd    bld-libstdc++

You must have a recent snapshot release of gcc built (tested with
gcc-2.95.2), and massaged your PATH variable so that it is used for the
building of the library. Run configure; for example, using bash:

  ../libstdc++-2.90.7/configure --prefix=${PWD%/*}/H-libstdc++

Then 

  make
  make install

To check the status of your build, type

  make check

or this, to check the installed library:

  make check-install

This will create (according to the above configure arguments) a directory
H-libstdc++ containing 

  lib/
  include/g++-v3/
    bits/
    backward/
    ext/

To link against that you can say, for example,

  LIBINC=$prefix/include/g++-v3
  g++ -Wall -I$LIBINC -L$prefix/lib foo.cc -o foo

where prefix is set to the full name of your H-libstdc++ directory.
If you want the SGI STL extensions (e.g. hash tables) you can add
  -I$LIBINC/ext 
and/or 
  -I$LIBINC/backward

To run it, you will need to set LD_LIBRARY_PATH in your environment
correctly, so that the shared library for libstdc++ can be found and
loaded. (Or, you can compile with -static to link statically if you
are debugging or would rather not deal with the extra bits for shared
libraries.)

To set LD_LIBRARY_PATH try this (again, assuming bash):

  LD_LIBRARY_PATH=$prefix/lib foo
d70 7
a76 24
For the adventurous, testing may be done with different flags than the
current defaults. More information and a commentary on how to to this
can be found here:
http://sourceware.cygnus.com/ml/libstdc++/1999-q3/msg00066.html

If you compile programs -fnew-abi -fno-honor-std, uses of RTTI and 
certain other language features will link only if you build your 
compiler's libgcc using the same flags.  (The defaults use the old abi.)  
Using -fnew-abi offers real benefits, but note that it is not stable: 
later snapshots will *not* be binary-compatible with code compiled with 
older snapshots.

Some fun flags to try might include combinations of:

CXXFLAGS=  -g -Wall -O3 -fstrict-aliasing -ansi -fsquangle \
	   -fhonor-std -fnew-exceptions -fvtable-gc -ffunction-sections
CXXDEFINES= 
CXXINCLUDE= -I$LIBINC/std -I$LIBDIR -I$LIBINC/stl 






@


1.7
log
@1999-12-18  Gabriel Dos Reis  <dosreis@@cmla.ens-cachan.fr>

        * docs/17_intro/TODO: Update
        * docs/17_intro/RELEASE-NOTES (New): Update.
@
text
@d25 1
a25 1
- Now compiling with -Wall -Werror -Winline works, and is on be default.
d70 1
a70 1
Unpack the tarball using GNU tar; it will create a directory libstdc++-2.90.6.
d84 1
a84 1
gcc-2_95), and massaged your PATH variable so that it is used for the
@


1.6
log
@
1999-12-17  Benjamin Kosnik  <bkoz@@milou.cygnus.com>

	* bits/c++config.h.in (__GLIBCPP__): Bump.
	* docs/17_intro/RELEASE-NOTES: Update, Gaby please add your stuff.
	* docs/17_intro/TODO: Update.

	* bits/locale_facets.h: Touch this too.
	* bits/localefwd.h: Add typedefs for loooooong vector names.
	* bits/locale_facets.tcc (locale::operator()): Need parens.
	(has_facet): Simplify.
	* src/locale-inst.cc: Add instantiations.
	* src/locale.cc: Tweaks.

	* bits/std_streambuf.h: Move indeterminates into. .
	* bits/std_fstream.h: Here.
	* bits/fstream.tcc (underflow): Rewind just for ios_base::out
	streams.
	* bits/sstream.tcc: Very minor formatting tweaks.
	* bits/std_streambuf.h (_M_set_determinate): If exclusively an
	input buffer, set _M_buf to offset.
	* bits/istream.tcc (std): Tweaks.
	* testsuite/27_io/istream_unformatted.cc (test05): More tweaks,
	include fstream.
	* testsuite/27_io/filebuf.cc: Tweaks.

1999-12-13  Benjamin Kosnik  <bkoz@@cygnus.com>

	* bits/istream.tcc (seekg): Don't set _M_gcount.
	(tellg): Same.
	* bits/fstream.tcc (filebuf::underflow): Re-sync
	external byte sequence's input buffer only. . .
	* testsuite/27_io/istream_unformatted.cc (test04): New tests for
	tellg, seekg and filebufs.
	(test05): Same for stringbufs.
	* testsuite/27_io/istream_unformatted-2.tst: New file.
	* testsuite/27_io/istream_unformatted-1.tst: New file.
	* testsuite/27_io/istream_unformatted-1.txt: New file.
	* testsuite/21_strings/inserters_extractors.cc (test05): Change
	output file.
@
text
@d33 8
a40 2
  valarray_meta.h fixes, tests.
  **Gaby, you did some stuff here I don't understand :) please put it in**
d42 1
@


1.5
log
@
1999-08-11  Benjamin Kosnik  <bkoz@@tintin.cygnus.com>

	* testsuite/27_io/istream_unformatted.cc: New file.

	* testsuite/27_io/istream_extractor_arith.cc (test02): Add more
	elaborate tests for int types with noskipws.

	* testsuite/27_io/istream_extractor_other-1.txt: New file.
	* testsuite/27_io/istream_extractor_other-1.tst: New file.
	* testsuite/27_io/istream_extractor_other-2.tst: New file.
	* testsuite/27_io/istream_extractor_other.cc: Add tests.
	* bits/istream.tcc: Fix operator>>(streambuf*).

	* testsuite/23_containers/vector_ctor.cc (test01): Add.

	* docs/index.html: Remove references to egcs.
	* docs/17_intro/DESIGN: Same.
	* docs/17_intro/contribute.html: Same.
	* docs/17_intro/RELEASE-NOTES: Ditto.
	* docs/17_intro/howto.html: Same here.

	Russell Davidson <russell@@ehess.cnrs-mrs.fr>
	* stl/bits/stl_vector.h (_M_insert_aux):
	* bits/locale_facets.tcc (_M_extract): Tweaks for preliminary
	decimal/floating point support.
	* bits/locale_facets.h: Change _M_extract prototype.
	* bits/char_traits.h (char_traits::to_int_type): Cast to unsigned.
	* bits/std_istream.h (istream::read(char_type, streamsize)): Fix.
@
text
@d1 1
a1 1
1999-08-04
d10 1
a10 1
This is the seventh snapshot of the libstdc++ rewrite.  It is still 
d25 25
a49 16

- basic_string<char> has passed validation, with the cavet empor noted
  in BUGS. Documentation for string internals has been added to the
  source code. Ryszard Kabatek has optimized and fixed numerous member
  functions, also Alfred Minarik and Vadim Egorov.
- Include-path optimizations.
- The library and testsuite have been made namespace friendly 
  thanks to Alfred Minarik 
- bits/std_cmath.h and math/mathconf tweaks by Gabriel Dos Reis.
- complex, valarray, gslice  work by Gabriel Dos Reis.
- Preliminary port to cygwin by Mumit Khan
- basic_stringbuf was re-implemented to fix problems with ostringstreams.
- ios_base and basic_ios data member optimization/clarification. The
  ios heirarchy now has preliminary facet caching.
- istream::ws, getline, and all extraction operators were fixed and
  have undergone preliminary testing.
d51 2
d65 1
a65 1
  tar xfz libstdc++-2.90.6.tar.gz
d80 1
a80 1
  ../libstdc++-2.90.6/configure --prefix=${PWD%/*}/H-libstdc++
d149 5
a153 5
libstdc++. The recently released gcc-2_95 works well. In addition, you
may need up-to-date tools for modifying Makefiles and regenerating
configure scripts: automake (version 1.4 and above works nicely) and
autoconf (version 2.13 and higher). Please see the website for more
info on where to obtain these additional tools.
d173 4
@


1.4
log
@
1999-08-03  Benjamin Kosnik  <bkoz@@cygnus.com>

	* docs/index.html: Update for libstdc++-2.90.6 release.
	* docs/17_intro/RELEASE-NOTES (New): Update.
	* docs/17_intro/BUGS: Update.
	* bits/c++config.h.in (__GLIBCPP__): Bump version number.
	* README (file): Update.
@
text
@d5 1
a5 1
The Egcs Standard C++ Library v3, or libstc++-2.90.x, is an ongoing
d13 1
a13 1
The Egcs Standard C++ Library v3, or libstc++-2.90.x, follows an open
d150 1
a150 1
certain other language features will link only if you build your Egcs 
@


1.3
log
@        * docs/17_intro/RELEASE-NOTES: remove outdated
        documentation about numeric_limits. Correct CXXINCLUDE setting
        documentation.
@
text
@d1 1
a1 1
1999-05-18
d10 1
a10 1
This is the sixth snapshot of the libstdc++ rewrite.  It is still 
d25 18
a42 21
 - Update to SGI STL 3.2
 - Automatically-generated <limits> header for each architecture. 
 - Partially re-written valarray.
 - Extensible documentation-synched-to-webpage architecture. 
 - Check script to check installation and builds, with facilities for
   tracking size and compile speed.
 - Stringbufs and stringstreams for basic types work.
 - Various bugfixes.
 - Re-written num_get::do_get.

What works: (noted with the chapter # of the ISO-14882 standard)
-----------
 - exceptions, op new etc. (18, 19)
 - SGI-STL release 3.2 utilities, containers, algorithms, and iterators.
   (20,23,24,25), and ostreambuf_iterator<>. Plus fixes for auto_ptr,
   and an interator class for vector and string.
 - basic_string<> (21)
 - locale, some facets (ctype, num_put, collate), stubs for the rest. (22)
 - Gabriel Dos Reis's valarray<>, and Drepper's complex<>.
 - ios_base, basic_ios<>, basic_streambuf<>, basic_stringbuf<>, 
   basic_filebuf<>, ostream<>, operator<< for integers, strings. (27)
d47 1
a47 12
 - Too many parts of istream, op>>, op<<(double&) etc. (27) 
 - Many facet implementations are stubs. (22) 
 - Almost no optimizations for small-footprint/low-overhead. (22,27) 
 - It has not been fully audited for standard conformance in the areas 
   that do work--check out the testsuite directory for an idea of the 
   limitations of the current implementation. 
 - It has not been made thread-safe. 
 - There has been some work to wrap the C headers in namespace std::, but 
   it may not be complete yet, and C macros are not shadowed. Please consult 
   the mailing list archives for more information. 
 - Some parts of numeric_limits specialization for floating point types
   are stubs. 
a49 27
How to participate:
-------------------
Read:

 - RELEASE_NOTES - this file
 - README        - directory structure
 - HEADER_POLICY - header naming and sub-include structure
 - DESIGN        - overview of the implementation plan
 - TODO          - tasks
 - C++STYLE      - coding style by example
 - BADNAMES      - names to avoid because of potential collisions
 - LICENSE.STD   - the terms of use

The license for all non-STL parts of the library is a
slightly-modified version of the GPL that allows for template
instantiations: in particular, you may "use this file as part of a free
software library without restrictions." See the file COPYING for more
info, and any of the source files for the exception clause.

The STL portion of the library, under the stl/ directory, is under
a much weaker license specified by HP and SGI, that only requires
that the copyright notices not be stripped off.

Any patches accepted must be assigned under the same copyright terms.
Please contact Benjamin Kosnik <benjamin@@cygnus.com> for further details.


d52 1
a52 1
Unpack the tarball using GNU tar; it will create a directory libstdc++-2.90.5.
d54 1
a54 1
  tar xfz libstdc++-2.90.5.tar.gz
d65 3
a67 3
You must have a recent snapshot release of Egcs built, and massaged
your PATH variable so that it is used for the building of the
library. Run configure; for example, using bash:
d69 1
a69 1
  ../libstdc++-2.90.5/configure --prefix=${PWD%/*}/H-libstdc++
d76 8
d137 11
a147 5
Testing was done with 

CXXFLAGS=  -g -Wall -O3 -fstrict-aliasing -ansi -fnew-abi -fhonor-std
CXXDEFINES= 
CXXINCLUDE= -I$LIBINC/std -I$LIBDIR -I$LIBINC/stl 
d156 7
a162 6
You will need a recent version of Egcs. (Egcs 1.1.2 does not work: see
the newsgroup archive for more info.)  In addition, you may need
up-to-date tools for modifying Makefiles and regenerating configure
scripts: automake (version 1.4 and above works nicely) and autoconf
(version 2.13 and higher). Please see the website for more info on
where to obtain these additional tools.
@


1.2
log
@`
1999-05-18  Benjamin Kosnik  <bkoz@@tintin.cygnus.com>
	* bits/c++config.h (__GLIBCPP__): Set version to 19990518.
	* docs/17_intro/RELEASE-NOTES: Update.
	* docs/index.html: Correct link to mailing list help page, update News.
	* docs/faq/index.html: Change fifth to sixth for snapshot.
	* src/Makefile.am (myinstallheaders): Bring over Gaby's changes to
 	install $(top_builddir)/bits/std_limits.h into
 	$(myincludepfx)/bits. This was mistakenly omitted from yesterday's
 	Makefile.am changes.
	* *Makefile*: Regenerate using automake.
	* mkcheck (LOG_FILE): Fix filebuf directory oddness.
	* testsuite/27_io/filebuf.cc: Same.
@
text
@d27 1
a27 1
 - Re-written valarray.
d43 1
a43 3
 - Gabriel dos Reis's valarray<>, and Drepper's complex<>.  (However, 
   note that numeric_limits<> is not tailored for your target.  You 
   must do that by hand.) (26)
d60 2
d174 1
a174 1
CXXINCLUDE= -I$LIBDIR/std -I$LIBDIR -I$LIBDIR/stl 
a188 5





@


1.1
log
@b
1999-05-11  Benjamin Kosnik  <bkoz@@loony.cygnus.com>
	* stl/bits/stl_config.h (__USE_MALLOC): Change underlying allocator.
	Check __USE_MALLOC before defining specializations containing
	__default_alloc_template.
	* src/stl-inst.cc: Here too.
	* bits/basic_string.h: Change.
	* testsuite/make_check_libfree++: More tweaks.
	* testsuite/21/capacity.cc: New file.
	* src/string.cc: Rename to be consistent with other inst files.
	Rename to string-inst.cc.
	* src/string*.cc: Change include.
	* src/wstring.cc: Rename to wstring-inst.cc.
	* src/wstring*.cc: Ditto.
	* src/Makefile.in: Also here.
	* src/Makefile.am: Ditto.
	* src/traits.cc: Remove.
	* src/wtraits.cc: Same.
	Try a new way of organizing documentation, one with synchronicity
	between testsuites and docs subdirectories, and see who yelps.
	* docs/html: Remove, use chapter and subject specific directories
	instead of forcing things immediately into format of
	documentation.
	* docs/text: Same.
	* docs/image: Same.
	* docs/faq/text, docs/faq/html: Remove, put in the docs/faq
	directory and sort by filename and extension.
	* docs/17_intro, 18_support, 19_diagnostics, 20_util, 21_strings,
	22_locale, 23_containers, 24_iterators, 25_algorithms,
	26_numerics, 27_io: Add.
	* docs/17_intro/*: Populate with all the text files. . .
	* docs/index.html: Construct.
	* testsuite/*: Update with same names as the docs subdir.
	* testsuite/results: Where to stash conformance results for the
	different snapshots, so that progress/size/speed issues can be
	tracked over time.
@
text
@d1 1
a1 1
1999-03-16
d10 1
a10 1
This is the fifth snapshot of the libstdc++ rewrite.  It is still 
d25 9
a33 16
 - Update to SGI STL 3.12
 - STL auto_ptr fixes
 - A string and vector iterator class 
 - Minor valarray tweaks. 
 - New buffering classes and abstractions for the underlying byte sequences, 
   with filebufs approaching (unoptimized) usability. 
 - Facets have been cached, stashed, and used throughout the iostream 
   hierarchy. Note the caching strategy is still developing, and the actual 
   locations they are saved may be changed.
 - Initialization of standard streams is done in a coherent and 
   standards-conformant manner.  
 - Preliminary wchar_t support has been added, although this isn't yet usable. 
 - Libio has been imported directly into the distribution, resulting in it's 
   larger size, but allowing input/output to work on other platforms--Solaris 
   in particular.

d38 1
a38 1
 - SGI-STL release 3.12 utilities, containers, algorithms, and iterators.
d52 2
a53 2
 - too many parts of istream, op>>, op<<(double&) etc. (27) 
 - Most facet implementations are stubs. (22) 
d93 1
a93 1
Unpack the tarball using GNU tar; it will create a directory libstdc++-2.90.4.
d95 1
a95 1
  tar xfz libstdc++-2.90.4.tar.gz
d110 1
a110 1
  ../libstdc++-2.90.4/configure --prefix=${PWD%/*}/H-libstdc++
d172 1
a172 1
CXXFLAGS=  -g -Wall -O3 -fstrict-aliasing -ansi -fnew-abi -fno-honor-std
d183 6
a188 6
You will need a recent released version of Egcs.  We have used the
egcs-1.1.1 release successfully. In addition, you may need up-to-date
tools for modifying Makefiles and regenerating configure scripts:
automake (version 1.4 and above works nicely) and autoconf (version
2.13 and higher). Please see the website for more info on where to
obtain these additional tools.
@

