gcc/libstdc++-v3
Stephen M. Webb 02d92e3b70 All occurrences of the __value_type() and __distance_type() functions...
2001-07-17  Stephen M. Webb   <stephen@bregmasoft.com>r

	All occurrences of the __value_type() and __distance_type()
	functions, which were required to support the HP STL, have been
	removed along with all the auxiliary forwarding functions that
	were required to support their use.

	The __iterator_category() function was pretty much left alone
	because there was no benefit to removing it and its use made code
	just a little more readable.

	Incidences of distance() with nonstandard argument list were
	replaced by calls to the standard function (only in the files
	affected by the removal of the other HP functions).

	The signature of the rotate() algorithm was changed to match the
	standard.

	Headers were reformatted under C++STYLE guidelines (indentation,
	linebreaks, typename keyword).

	* include/bits/stl_algo.h: replaced __value_type() and
	__distance_type() with iterator_traits, eliminated auxiliary
	support functions required to support said function usage.
	Changed nonstandard distance() call to standard call.

	* include/bits/stl_algobase.h: Same.
	* include/bits/stl_heap.h: Same.
	* include/bits/stl_numeric.h: Same.
	* include/bits/stl_uninitialized.h: Same.
	* include/bits/stl_iterator_base_types.h (__value_type()):
	Removed.
	(__distance_type()): Removed.
	(value_type()): Gone.
	(distance_type()): Done in.
	(iterator_category()): Hasta la vista, baby.

	* include/bits/stl_iterator_base_funcs.h (iterator_category()):
	Replaced with __iterator_category().
	* include/backward/iterator.h: moved definition of value_type(),
	distance_type(), and iterator_category() out of std:: and into
	here.
	* testsuite/23_containers/vector_ctor.cc (test03): New testcases.
	* testsuite/23_containers/vector_modifiers.cc (test03): New testcases.
	* testsuite/25_algorithms/rotate.cc: New testcase.
	* testsuite/25_algorithms/copy.cc: New testcase.
	* testsuite/25_algorithms/sort.cc: Same.
	* testsuite/25_algorithms/heap.cc: Same.
	* testsuite/25_algorithms/partition.cc: Same.
	* testsuite/25_algorithms/binary_search.cc: Same.
	* testsuite/26_numerics/sum_diff.cc: Ditto.

From-SVN: r44117
2001-07-18 17:09:02 +00:00
..
config porting.texi: Add documentation about libstdc++-v3-specific macros that are currently... 2001-06-12 23:09:09 +00:00
docs porting-howto.xml: Initial checkin of master copy. 2001-07-12 00:02:34 +00:00
include All occurrences of the __value_type() and __distance_type() functions... 2001-07-18 17:09:02 +00:00
libio All occurrences of the __value_type() and __distance_type() functions... 2001-07-18 17:09:02 +00:00
libmath All occurrences of the __value_type() and __distance_type() functions... 2001-07-18 17:09:02 +00:00
libsupc++ All occurrences of the __value_type() and __distance_type() functions... 2001-07-18 17:09:02 +00:00
src All occurrences of the __value_type() and __distance_type() functions... 2001-07-18 17:09:02 +00:00
testsuite All occurrences of the __value_type() and __distance_type() functions... 2001-07-18 17:09:02 +00:00
acconfig.h threads-no.h: Remove file. 2001-06-08 03:53:35 +00:00
acinclude.m4 acinclude.m4 (GLIBCPP_ENABLE_CHEADERS): Use glibcpp_srcdir when setting C_INCLUDE_DIR. 2001-07-16 17:43:54 +00:00
aclocal.m4 acinclude.m4 (GLIBCPP_ENABLE_CHEADERS): Use glibcpp_srcdir when setting C_INCLUDE_DIR. 2001-07-16 17:43:54 +00:00
ChangeLog All occurrences of the __value_type() and __distance_type() functions... 2001-07-18 17:09:02 +00:00
ChangeLog-2000
config.h.in Makefile.am: New file encapsulating header generation rules. 2001-07-13 16:47:56 +00:00
configure All occurrences of the __value_type() and __distance_type() functions... 2001-07-18 17:09:02 +00:00
configure.host
configure.in acinclude.m4 (GLIBCPP_ENABLE_CHEADERS): Use glibcpp_srcdir when setting C_INCLUDE_DIR. 2001-07-16 17:43:54 +00:00
configure.target
Makefile.am Makefile.am: New file encapsulating header generation rules. 2001-07-13 16:47:56 +00:00
Makefile.in All occurrences of the __value_type() and __distance_type() functions... 2001-07-18 17:09:02 +00:00
mkcheck.in std_sstream.h (basic_stringbuf::basic_stringbuf(string): Initialize _M_string with pointer-and-size constructor, not just pointer. 2001-07-13 20:50:03 +00:00
mkcshadow
mkinclosure
mknumeric_limits Makefile.am: New file encapsulating header generation rules. 2001-07-13 16:47:56 +00:00
porting.texi porting.texi: Add documentation about libstdc++-v3-specific macros that are currently... 2001-06-12 23:09:09 +00:00
README README: Update to reflect reality. 2001-06-11 19:35:32 +00:00
testsuite_flags.in Makefile.am: New file encapsulating header generation rules. 2001-07-13 16:47:56 +00:00

file: libstdc++-v3/README

New users may wish to point their web browsers to the file documentation.html
in the 'docs/html' subdirectory.  It contains brief building instructions and
notes on how to configure the library in interesting ways.


Instructions for configuring and building this snapshot appear
in docs/html/install.html.

This directory contains the files needed to create [a still broken
subset of] an ISO Standard C++ Library.

It has subdirectories:

  docs
     Files in HTML and text format that document usage, quirks of the
     implementation, and contributor checklists.

  include/bits
     Files included by standard headers and by other files in
     the bits directory.  Includes a set of files bits/std_xxxx.h
     that implement the standard headers <xxxx>.

  include/std
     Files meant to be found by #include <name> directives in
     standard-conforming user programs.  These headers are not
     referred to by other headers, because such dependencies
     confuse Make (leading it to delete them, all too often).
     Installations may substitute symbolic links in place of
     these files.

  include/ext
     Headers that define extensions to the standard library.  No
     standard header refers to any of them.

  include/backward
     Headers provided for backward compatibility, such as <iostream.h>.
     They are not used in this library.

  include/c_shadow
     Headers intended to shadow standard C headers provided by an
     underlying OS or C library, and other headers depended on directly
     by C++ headers (e.g. unistd.h).  These are meant to wrap the names
     defined there into the _C_legacy namespace.
     [NB: this can be enabled via --enable-cheaders=c_shadow]

  include/c
     Headers intended to directly include standard C headers. 
     [NB: this can be enabled via --enable-cheaders=c]

  include/c_std
     Headers intended to include standard C headers, and put select
     names into the std:: namespace.
     [NB: this is the default, and is the same as --enable-cheaders=c_std]

  src
     Files that are used in constructing the library, but are not
     installed.

  testsuites/17_* to 27_*
     Test programs are here, and may be used to begin to exercise the 
     library.  Support for "make check" and "make check-install" is
     complete, and runs through all the subdirectories here when this
     command is issued from the build directory.  Please note that
     "make check" requires DejaGNU 1.4 or later to be installed.  Please
     note that "make check-script" calls the script mkcheck, which
     requires bash, and which may need the paths to bash adjusted to
     work properly, as /bin/bash is assumed.

Other subdirectories contain variant versions of certain files
that are meant to be copied or linked by the configure script.
Currently these are:

  config/cpu
  config/os

Files needed only to construct the library, but not installed,
are in src/.  Files to be copied as part of an installation are
all found in the subdirectories mentioned above.  (A configure
script may link files from another directory into one of these.)

In a normal installation the bits/ directory is copied
under the std/ directory, and arranged to be searched only
when an include directive specifies a filename of "bits/..."
or <bits/...>.  When building the library, we use

  -I. -Iinclude/std -Iinclude -Iconfig/os/* -Iconfig/cpu/*

to get the same effect.

Note that glibc also has a bits/ subdirectory.  We will either
need to be careful not to collide with names in its bits/
directory; or rename bits to (e.g.) cppbits/.

To install libstdc++ you need GNU make.  The makefiles do not work with
any other make.

In files throughout the system, lines marked with an "XXX" indicate
a bug or incompletely-implemented feature.  Lines marked "XXX MT"
indicate a place that may require attention for multi-thread safety.