head	1.14;
access;
symbols
	isolib-2:1.1.1.1 isolib:1.1.1;
locks; strict;
comment	@# @;


1.14
date	2000.04.19.01.30.37;	author bkoz;	state Exp;
branches;
next	1.13;

1.13
date	2000.02.01.02.56.38;	author bkoz;	state Exp;
branches;
next	1.12;

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

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

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

1.9
date	98.10.31.01.13.48;	author ncm;	state Exp;
branches;
next	1.8;

1.8
date	98.10.31.00.50.42;	author ncm;	state Exp;
branches;
next	1.7;

1.7
date	98.10.30.21.18.15;	author ncm;	state Exp;
branches;
next	1.6;

1.6
date	98.10.30.02.43.33;	author drepper;	state Exp;
branches;
next	1.5;

1.5
date	98.07.14.10.40.23;	author ncm;	state Exp;
branches;
next	1.4;

1.4
date	98.07.13.21.49.22;	author ncm;	state Exp;
branches;
next	1.3;

1.3
date	98.05.19.07.19.23;	author ncm;	state Exp;
branches;
next	1.2;

1.2
date	98.05.19.02.17.58;	author ncm;	state Exp;
branches;
next	1.1;

1.1
date	98.04.15.04.57.47;	author ncm;	state Exp;
branches
	1.1.1.1;
next	;

1.1.1.1
date	98.04.15.04.57.47;	author ncm;	state Exp;
branches;
next	;


desc
@@


1.14
log
@
2000-04-18  Benjamin Kosnik  <bkoz@@redhat.com>

	* stl/*: Integrate contents of this directory into top-level
	directories.
	* ext/bvector hash_map hash_set rope ropeimpl.h slist
	stl_bvector.h stl_hash_fun.h stl_hashtable.h stl_rope.h tree: Add.
	* bits/pthread_allocimpl.h std_algorithm.h std_bitset.h
	std_deque.h std_functional.h std_iterator.h std_list.h std_map.h
	std_memory.h std_numeric.h std_queue.h std_set.h std_stack.h
	std_stdexcept.h std_strstream.h std_utility.h std_vector.h
	stl_algo.h stl_algobase.h stl_alloc.h stl_config.h stl_construct.h
	stl_deque.h stl_function.h stl_heap.h stl_iterator.h
	stl_iterator_base.h stl_list.h stl_map.h stl_multimap.h
	stl_multiset.h stl_numeric.h stl_pair.h stl_pthread_alloc.h
	stl_queue.h stl_range_errors.h stl_raw_storage_iter.h stl_relops.h
	stl_set.h stl_stack.h stl_string_fwd.h stl_tempbuf.h stl_threads.h
	stl_tree.h stl_uninitialized.h stl_vector.h type_traits.h: Add.
	* backward/algo.h algobase.h alloc.h bvector.h defalloc.h deque.h
	function.h hash_map.h hash_set.h hashtable.h heap.h iterator.h
	list.h map.h multimap.h multiset.h pair.h rope.h set.h slist.h
	stack.h tempbuf.h tree.h vector.h: Add.
	* README (file): Update.
	* docs/documentation.html: README not being found.
	* src/Makefile.am (sources): Take out stl directory.
	* mkcheck.in (SRC_DIR): And here.
	* src/Makefile.in: Regenerate.
@
text
@file: isolib/README

New users may wish to point their web browsers to the file index.html
in the 'docs' 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 install.html.

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

It has subdirectories:

  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>.

  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.

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

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

  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" calls the script mkcheck, which requires bash, and which
     may need the paths to bash adjusted to work properly, as /bin/bash is
     assumed.

  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 _CSwamp namespace.
     [NB: this is still experimental, and is not currently used.]

  cshadow
     The contents of this directory are constructed by scripts which 
     examine the underlying C headers to discover other headers they
     depend on.  These headers are wrappers for them.
     [NB: this is still experimental, and is not currently used.]

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

  amm1 generic glibc math

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

  -Istd -I. -Iconfig/* -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.
(Warning: places that need an atomic read are not so marked yet.)

@


1.13
log
@
2000-01-31  Benjamin Kosnik  <bkoz@@gnu.org>

	META-QUESTION: Can we just make a "header.html" file and a
	"footer.html" and just include them in all the doc sub-pages. The
	duplication of the header info is kind of gross, and weak
	considering that if you change order or layout then all this stuff
	has to be changed in all the sub-files.

	* docs/17_intro/contribute.html: Yeah. Take out duplicate file info.
	* README: Should just contain a link to the docs/index.html
	page. Duplicate information removed.
	* docs/faq/index.html (http): Remove indexes into HOWTOS.
	* docs/17_intro/howto.html: Make intro and docs part more
	centralized. Move intro stuff to documentation.html.
	* docs/how.html: Tweak. Does this file need to exist? What calls it?
	* docs/README.html: Move documentation files to
	documentation.html. Should this file be renamed
	"config_and_install.html" as that is what is apparently covered
	here. . .
	* docs/install.html: Yes. New file, moved and renamed README.html.
	* docs/documentation.html: New file. This is the index file for
	the documentation.
	* docs/index.html: Edit sidebar order. Insert new link to new
	documentation spine, documentation.html.
@
text
@a62 7
Another directory, stl, also contains directories bits, backward,
and ext.  These directories contain files which are not protected
under any GNU license.  For build purposes they are treated the same
as the top level directories, via (e.g.) the -I compiler option.  On
installation all files (e.g. under bits/ and stl/bits/) are copied
into a common target directory (e.g. $TARGET_INCLUDE/bits).

d79 1
a79 1
  -Istd -I. -Istl
@


1.12
log
@
2000-01-31  Nathan Myers  <ncm@@zembu.com>

	* README (Documentation): Add path info, fix typos.
@
text
@d3 1
a3 1
New users may wish to point their web browsers to the file README.html
d9 1
a9 1
in RELEASE-NOTES.
a101 41
Documentation:

docs/17_intro/BADNAMES
  A list of short uglified names that must not be used in code
  because they would collide with names built into the compilers, or used
  in C headers, of target systems.

docs/17_intro/BUGS
  Known bugs are logged here.  This file may be out of date; it certainly
  is always incomplete.  Omissions are not placed here, except for 
  components marked as finished in the CHECKLIST.

docs/17_intro/C++STYLE
  A minimalist example of the style guidelines which this library will 
  be held to.  Note that it differs significantly from the GNU "C" 
  coding style.  This is deliberate: this is a C++ library, not a
  C library.  Note that there is a significant amount of GNU-style
  use of "()" remaining in the library.  This will be combed out.

docs/17_intro/CHECKLIST
  A list of what is and is not implemented in each current snapshot.

ChangeLog
  Changes to the library are logged here.

docs/17_intro/HEADER_POLICY
  Describes the policy for use of headers in the library 
  implementation.  Failure to obey it strictly will break the library
  in subtle ways.

docs/17_intro/PROBLEMS
  Portability and use issues.

README
  This file.

docs/17_intro/RELEASE-NOTES
  Notes about a particular snapshot or release.

docs/17_intro/TODO
  Cryptic notes about high-priority goals for the library.
@


1.11
log
@
2000-01-04  Phil Edwards  <pme@@sourceware.cygnus.com>
            Nicolai Josuttis <nicolai.josuttis@@braunschweig.netsurf.de>

	* README:  Add a note referring to README.html.
	* docs/README.html:  New file from Nicolai.
	* docs/faq/index.html:  Move "how to get a copy" to here.
	* docs/gentop/footchunk.html:  Update.
	* docs/gentop/headchunk.html:  New links according to
	  bkoz's idea for "How to..." stuff.
	* docs/gentop/thanks:  Actually put people here.
	* docs/download.html:  Regenerated.
	* docs/index.html, docs/links.html, docs/mail.html,
	  docs/status.html, docs/thanks.html, docs/faq/index.txt:  Ditto.
	* docs/how.html:  Ditto.  (This file should go away soon.)
@
text
@d104 1
a104 1
BADNAMES
d106 1
a106 1
  because they would collide with names build into the compilers, or used
d109 1
a109 1
BUGS
d114 1
a114 1
C++STYLE
d121 1
a121 1
CHECKLIST
d127 1
a127 1
HEADER_POLICY
d132 1
a132 4
LICENSE.STD
  Terms of use.

PROBLEMS
d138 1
a138 1
RELEASE-NOTES
d141 1
a141 1
TODO
@


1.10
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
@d3 5
@


1.9
log
@
 	* RELEASE-NOTES: more tweaks
	* README:
@
text
@d36 1
a36 1
  testsuites/21, 27
d38 6
a43 1
     library.  Support for "make test" based on these is not done yet.
d50 1
a50 1
     [note: this is still experimental, and is not currently used.]
d56 1
a56 1
     [note: this is still experimental, and is not currently used.]
@


1.8
log
@
	* README: add note about testsuite/ directory
@
text
@d3 3
@


1.7
log
@
        * bits/basic_string.h: churn definition of npos again.
        * bits/ios.cc: remove #ifdef on ios_base locale member initialization
        * BUGS: clear cruft.
        * C++STYLE: Touchup for release.
        * CHECKLIST: Touchup for release.
        * DESIGN: New file.
        * LICENSE.STD: Add requirement to retain copyrights and to provide
        the license with any copies.
        * README: Update for release.
        * TODO: Minor touchup for release.
	* RELEASE-NOTES: Prepare for release.
@
text
@d33 4
@


1.6
log
@Mention that GNU make is needed.
@
text
@d33 13
d69 1
a69 1
  -Istd. -I. -Istl
d75 1
a75 2
directory, or rename bits to (e.g.) cppbits/.

d79 50
@


1.5
log
@Release preps.
@
text
@d1 1
a1 1
file: isolib/README 
d3 2
a4 2
This directory contains the files needed to create [a still broken 
subset of] an ISO Standard C++ Library.  
d8 3
a10 3
  bits 
     Files included by standard headers and by other files in 
     the bits directory.  Includes a set of files bits/std_xxxx.h 
d14 5
a18 5
     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 
d20 1
a20 1
  
d22 1
a22 1
     Headers that define extensions to the standard library.  No 
d24 1
a24 1
  
d26 1
a26 1
     Headers provided for backward compatibility, such as <iostream.h>.  
d33 5
a37 5
Another directory, stl, also contains directories bits, backward, 
and ext.  These directories contain files which are not protected 
under any GNU license.  For build purposes they are treated the same 
as the top level directories, via (e.g.) the -I compiler option.  On 
installation all files (e.g. under bits/ and stl/bits/) are copied 
d41 1
a41 1
that are meant to be copied or linked by the configure script.  
d44 1
a44 1
  amm1 generic glibc math 
d47 2
a48 2
are in src/.  Files to be copied as part of an installation are 
all found in the subdirectories mentioned above.  (A configure 
d51 4
a54 4
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 
d56 1
a56 1
  -Istd. -I. -Istl 
d58 1
a58 1
to get the same effect.  
d61 1
a61 1
need to be careful not to collide with names in its bits/ 
d64 3
@


1.4
log
@bits/gslice*.h,
bits/valarray*.h: Gabriel's updates
bits/std_string.h,
bits/string.tcc,
bits/char_traits: fix typos.
LICENSE.STD: new license; note it still says "Draft", need to fix this.
README: updates for current directory structure.
@
text
@d3 2
a4 2
This directory contains the files needed to create an 
ISO Standard C++ Library.  
d33 6
a38 7
There is another directory, stl, which also contains directories
bits, backward, and ext.  These directories contain files which
are not protected under any GNU license.  For build purposes they 
are treated the same as the top level directories, via (e.g.) the 
-I compiler option.  On installation all files (e.g. under bits/
and stl/bits/) are copied into a common target directory 
(e.g. $TARGET_INCLUDE/bits).
d46 4
a49 4
Files needed only to construct the library, and 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.)
@


1.3
log
@Add remarks about stl directory
@
text
@d29 4
d37 3
a39 2
-I compiler option.  On installation the files are copied into
a common target directory.
d48 3
a50 4
are in the top-level directory.  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.)
d60 4
@


1.2
log
@README: typo
locale.cc: minor improvement to hash function
makefile: random changes
ostream.cc: many fixes, still badly broken
@
text
@d17 3
a19 2
     confuse Make.  Installations may substitute symbolic links
     for these files.
d29 6
d44 3
a46 3
installation are all found in the three subdirectories mentioned
above.  (A configure script may link files from another directory 
into one of these.)
d51 4
a54 1
or <bits/...>.  When building the library, we use "-Istd. -I. " 
@


1.1
log
@Initial revision
@
text
@d9 3
a11 3
     Files included by standard headers and by other files in this
     directory.  Includes a set of files bits/std_xxxx.h that 
     implement the standard headers <xxxx>.
@


1.1.1.1
log
@everything renamed
@
text
@@
