gcc/libstdc++-v3
Phil Edwards 729e3d3f01 c_io_stdio.h: Correct grammar in comments.
2001-11-02  Phil Edwards  <pme@gcc.gnu.org>

	* config/io/c_io_stdio.h:  Correct grammar in comments.
	* docs/doxygen/Intro.3:  Expand "top-level" man page.
	* docs/doxygen/doxygroups.cc:  New module definitions (comments).
	* docs/doxygen/mainpage.doxy:  Tweaks.
	* docs/doxygen/run_doxygen:  Update Doxygen version, massage man pages.

	Add @file hooks so that headers are considered to be documented.
	* include/bits/basic_ios.h, include/bits/basic_file.h,
	include/bits/basic_string.h, include/bits/boost_concept_check.h,
	include/bits/char_traits.h, include/bits/codecvt.h,
	include/bits/concept_check.h, include/bits/cpp_type_traits.h,
	include/bits/fpos.h, include/bits/gslice.h, include/bits/gslice_array.h,
	include/bits/indirect_array.h, include/bits/ios_base.h,
	include/bits/locale_facets.h, include/bits/localefwd.h,
	include/bits/mask_array.h, include/bits/pthread_allocimpl.h,
	include/bits/slice.h, include/bits/slice_array.h,
	include/bits/std_algorithm.h, include/bits/std_bitset.h,
	include/bits/std_complex.h, include/bits/std_deque.h,
	include/bits/std_fstream.h, include/bits/std_functional.h,
	include/bits/std_iomanip.h, include/bits/std_ios.h,
	include/bits/std_iosfwd.h, include/bits/std_iostream.h,
	include/bits/std_istream.h, include/bits/std_iterator.h,
	include/bits/std_limits.h, include/bits/std_list.h,
	include/bits/std_locale.h, include/bits/std_map.h,
	include/bits/std_memory.h, include/bits/std_numeric.h,
	include/bits/std_ostream.h, include/bits/std_queue.h,
	include/bits/std_set.h, include/bits/std_sstream.h,
	include/bits/std_stack.h, include/bits/std_streambuf.h,
	include/bits/std_string.h, include/bits/std_utility.h,
	include/bits/std_valarray.h, include/bits/std_vector.h,
	include/bits/stl_algo.h, include/bits/stl_alloc.h,
	include/bits/stl_bvector.h, include/bits/stl_construct.h,
	include/bits/stl_deque.h, include/bits/stl_heap.h,
	include/bits/stl_iterator.h, include/bits/stl_iterator_base_funcs.h,
	include/bits/stl_iterator_base_types.h, include/bits/stl_list.h,
	include/bits/stl_map.h, include/bits/stl_multimap.h,
	include/bits/stl_multiset.h, include/bits/stl_numeric.h,
	include/bits/stl_pair.h, include/bits/stl_pthread_alloc.h,
	include/bits/stl_queue.h, include/bits/stl_raw_storage_iter.h,
	include/bits/stl_relops.h, include/bits/stl_set.h,
	include/bits/stl_stack.h, include/bits/stl_tempbuf.h,
	include/bits/stl_threads.h, include/bits/stl_tree.h,
	include/bits/stl_uninitialized.h, include/bits/stl_vector.h,
	include/bits/stream_iterator.h, include/bits/streambuf_iterator.h,
	include/bits/stringfwd.h, include/bits/type_traits.h,
	include/bits/valarray_array.h, include/bits/valarray_meta.h:
	Add hooks, tweak comments only.

	* include/bits/stl_algobase.h (swap, min, iter_swap):  Also
	document these functions.
	* include/bits/stl_function.h:  Tweak link comments.

From-SVN: r46717
2001-11-02 17:38:11 +00:00
..
config c_io_stdio.h: Correct grammar in comments. 2001-11-02 17:38:11 +00:00
docs c_io_stdio.h: Correct grammar in comments. 2001-11-02 17:38:11 +00:00
include c_io_stdio.h: Correct grammar in comments. 2001-11-02 17:38:11 +00:00
libio limits.h: Move to... 2001-10-23 21:40:31 +00:00
libmath limits.h: Move to... 2001-10-23 21:40:31 +00:00
libsupc++ Make -fno-exceptions work. 2001-10-24 02:37:56 +00:00
po limits.h: Move to... 2001-10-23 21:40:31 +00:00
src re PR libstdc++/3666 (Invalid concept-checking code.) 2001-11-01 15:46:48 +00:00
testsuite ios_manip_fmtflags.cc: Fix for non-interactive output. 2001-11-02 03:48:09 +00:00
acconfig.h re PR libstdc++/3666 (Invalid concept-checking code.) 2001-11-01 15:46:48 +00:00
acinclude.m4 re PR libstdc++/3666 (Invalid concept-checking code.) 2001-11-01 15:46:48 +00:00
aclocal.m4 re PR libstdc++/3666 (Invalid concept-checking code.) 2001-11-01 15:46:48 +00:00
ChangeLog c_io_stdio.h: Correct grammar in comments. 2001-11-02 17:38:11 +00:00
ChangeLog-2000
config.h.in re PR libstdc++/3666 (Invalid concept-checking code.) 2001-11-01 15:46:48 +00:00
configure re PR libstdc++/3666 (Invalid concept-checking code.) 2001-11-01 15:46:48 +00:00
configure.host
configure.in re PR libstdc++/3666 (Invalid concept-checking code.) 2001-11-01 15:46:48 +00:00
configure.target limits.h: Move to... 2001-10-23 21:40:31 +00:00
Makefile.am testsuite_flags.in: No longer need to search testsuite builddir. 2001-09-05 22:38:06 +00:00
Makefile.in limits.h: Move to... 2001-10-23 21:40:31 +00:00
mkcheck.in mkcheck.in (static_fail): Remove older memory limit functionality. 2001-10-19 23:05:15 +00:00
mkcshadow
mkinclosure
porting.texi
README mkcheck.in (static_fail): Remove older memory limit functionality. 2001-10-19 23:05:15 +00:00
testsuite_flags.in testsuite_flags.in: No longer need to search testsuite builddir. 2001-09-05 22:38:06 +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.  

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

  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]

  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
  config/io
  config/locale

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

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

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.