2002-02-05 01:14:37 +01:00
|
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
|
|
|
|
<html>
|
|
|
|
|
<head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
|
|
|
|
|
<title>Main Page</title>
|
|
|
|
|
<link href="style.css" rel="stylesheet" type="text/css">
|
|
|
|
|
</head>
|
|
|
|
|
|
|
|
|
|
<body bgcolor="#ffffff">
|
|
|
|
|
<!--
|
|
|
|
|
Originally generated by Doxygen 1.2.12.
|
|
|
|
|
|
|
|
|
|
This used to be surrounded by /* */ marks and tagged with @mainpage, so
|
|
|
|
|
that Doxygen would create the index page from it. HOWEVER, Doxygen
|
|
|
|
|
ignores all but the most basic HTML tags, and even with those it strips
|
|
|
|
|
all the attributes. (See, the HTML you write for @mainpage isn't used
|
|
|
|
|
directly; it all gets run through Doxygen and re-output.) So lots of
|
|
|
|
|
tags were all being mangled.
|
|
|
|
|
|
2002-03-27 22:41:36 +01:00
|
|
|
Funk 'dat. Now we let Doxygen do whatever it feels like doing for the
|
2002-02-05 01:14:37 +01:00
|
|
|
index page, and then we just flat copy this over top of it. Voila!
|
2002-03-27 22:41:36 +01:00
|
|
|
Tags actually work like they're supposed to in HTML.
|
2002-02-05 01:14:37 +01:00
|
|
|
-->
|
|
|
|
|
|
|
|
|
|
<h1>libstdc++-v3 Source Documentation</h1>
|
2001-04-28 01:38:14 +02:00
|
|
|
|
2001-09-28 00:44:24 +02:00
|
|
|
<h2> Documentation Overview </h2>
|
2001-04-28 01:38:14 +02:00
|
|
|
|
2002-04-02 04:07:22 +02:00
|
|
|
<p class="smallertext">@LEVEL@-level docs, generated @DATE@.</p>
|
2002-02-05 01:14:37 +01:00
|
|
|
|
2001-09-28 00:44:24 +02:00
|
|
|
<p>There are two types of documentation for libstdc++-v3. One is the
|
|
|
|
|
distribution documentation, which can be read online at
|
|
|
|
|
<a href="http://gcc.gnu.org/onlinedocs/libstdc++/documentation.html">http://gcc.gnu.org/onlinedocs/libstdc++/documentation.html</a>
|
|
|
|
|
or offline from docs/html/documentation.html in the library source
|
|
|
|
|
directory.
|
2001-04-28 01:38:14 +02:00
|
|
|
</p>
|
|
|
|
|
|
2001-09-28 00:44:24 +02:00
|
|
|
<p>The other type is the source documentation, of which this is the first page.
|
2002-04-02 04:07:22 +02:00
|
|
|
Both "user-level" and "maintainer-level" source
|
|
|
|
|
documentation is produced: user-level docs are for the users of this
|
|
|
|
|
library. The maint-level docs are for those interested in the underlying
|
|
|
|
|
workings of the library; they include all the user-level docs plus
|
|
|
|
|
additional notes and additional classes/functions/etc.
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
<p>Here are quick links to the pages which we seem to use the most; a full
|
2001-09-28 00:44:24 +02:00
|
|
|
index is at the bottom:
|
|
|
|
|
<!-- Keep this in sync with below. -->
|
|
|
|
|
<ul>
|
|
|
|
|
<li><a href="annotated.html">Compound List</a>
|
|
|
|
|
<li><a href="classes.html">Alphabetical List</a>
|
|
|
|
|
<li><a href="files.html">File List</a>
|
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 18:38:11 +01:00
|
|
|
<li><a href="modules.html">Modules</a>
|
2001-09-28 00:44:24 +02:00
|
|
|
</ul>
|
2001-04-28 01:38:14 +02:00
|
|
|
</p>
|
|
|
|
|
|
2001-09-28 00:44:24 +02:00
|
|
|
<h2> Generating this file </h2>
|
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 18:38:11 +01:00
|
|
|
<p>These HTML pages are automatically generated, along with the man pages.
|
2002-04-02 04:07:22 +02:00
|
|
|
The Makefile rules <code> 'make doxygen' </code> and
|
|
|
|
|
<code> 'make doxygen-maint' </code> in the libstdc++-v3 build directory
|
|
|
|
|
generates these pages using a tool called, appropriately enough, Doxygen.
|
|
|
|
|
To learn more about Doxygen, take a look at
|
2002-02-05 01:14:37 +01:00
|
|
|
<a href="http://www.doxygen.org/">
|
|
|
|
|
<!-- snagged from the generated page -->
|
2002-04-18 03:42:50 +02:00
|
|
|
<img src="doxygen.png" alt="the Doxygen homepage"
|
2002-02-05 01:14:37 +01:00
|
|
|
align=center border=0 width=110 height=53>
|
|
|
|
|
</a>
|
2001-04-28 01:38:14 +02:00
|
|
|
</p>
|
|
|
|
|
|
2001-09-28 00:44:24 +02:00
|
|
|
<p>The libstdc++-v3 configuration files needed to generate doxygen output
|
|
|
|
|
are located:
|
|
|
|
|
<ul><li><code>docs/doxygen/user.cfg.in</code>
|
Makefile.am (doxygen, [...]): Tweak targets.
2002-01-28 Phil Edwards <pme@gcc.gnu.org>
* Makefile.am (doxygen, doxygen-maint, doxygen-man): Tweak targets.
* Makefile.in: Regenerate.
* docs/doxygen/run_doxygen: Update, mostly for man pages.
* docs/doxygen/Intro.3: Update.
* docs/doxygen/TODO: Update.
* docs/doxygen/doxygroups.cc: Add namespace hook for __gnu_cxx.
* docs/doxygen/mainpage.doxy: Update.
* docs/doxygen/user.cfg.in: Update for header rename. Also
regenerate comments and variables with 1.2.12.
* docs/doxygen/maint.cfg.in: Remove file.
* include/bits/stl_relops.h: Doxygenate.
* include/bits/stl_tempbuf.h (std::_Temporary_buffer): Likewise.
* include/c_std/std_cassert.h, include/c_std/std_cctype.h,
include/c_std/std_cerrno.h, include/c_std/std_cfloat.h,
include/c_std/std_ciso646.h, include/c_std/std_climits.h,
include/c_std/std_clocale.h, include/c_std/std_cmath.h,
include/c_std/std_csetjmp.h, include/c_std/std_csignal.h,
include/c_std/std_cstdarg.h, include/c_std/std_cstddef.h,
include/c_std/std_cstdio.h, include/c_std/std_cstdlib.h,
include/c_std/std_cstring.h, include/c_std/std_ctime.h,
include/c_std/std_cwchar.h, include/c_std/std_cwctype.h,
include/ext/algorithm, include/ext/functional, include/ext/hash_map,
include/ext/hash_set, include/ext/iterator, include/ext/memory,
include/ext/numeric, include/ext/rb_tree, include/ext/rope,
include/ext/ropeimpl.h, include/ext/slist, include/ext/stl_hash_fun.h,
include/ext/stl_hashtable.h, include/ext/stl_rope.h,
include/std/std_algorithm.h, include/std/std_bitset.h,
include/std/std_complex.h, include/std/std_deque.h,
include/std/std_fstream.h, include/std/std_functional.h,
include/std/std_iomanip.h, include/std/std_ios.h,
include/std/std_iosfwd.h, include/std/std_iostream.h,
include/std/std_istream.h, include/std/std_iterator.h,
include/std/std_limits.h, include/std/std_list.h,
include/std/std_locale.h, include/std/std_map.h,
include/std/std_memory.h, include/std/std_numeric.h,
include/std/std_ostream.h, include/std/std_queue.h,
include/std/std_set.h, include/std/std_sstream.h,
include/std/std_stack.h, include/std/std_stdexcept.h,
include/std/std_streambuf.h, include/std/std_string.h,
include/std/std_utility.h, include/std/std_valarray.h,
include/std/std_vector.h: Add/correct @file doxygen hook.
* include/ext/memory: Doxygenate most of rest of file.
* libsupc++/exception: Doxygen output formatting.
* libsupc++/new: Say which header it is.
* testsuite/lib/libstdc++-v3-dg.exp: Fix spacing.
* docs/html/19_diagnostics/howto.html: Describe concept-checks switch.
* docs/html/23_containers/howto.html: Describe O(n) list::size().
* docs/html/27_io/howto.html: Also link to Langer and Kreft text.
From-SVN: r49300
2002-01-28 23:13:12 +01:00
|
|
|
<li><code>docs/doxygen/run_doxygen</code>
|
2001-09-28 00:44:24 +02:00
|
|
|
</ul>
|
2001-04-28 01:38:14 +02:00
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
<h2> libstdc++-v3 doxygen style guide </h2>
|
2001-09-28 00:44:24 +02:00
|
|
|
<p>In general, libstdc++-v3 files should be formatted according to the
|
|
|
|
|
GNU C++ Coding Standard rules found in the file <a
|
2001-04-28 01:38:14 +02:00
|
|
|
href="http://gcc.gnu.org/onlinedocs/libstdc++/17_intro/C++STYLE">C++STYLE</a>.
|
2001-09-28 00:44:24 +02:00
|
|
|
Before any doxygen-specific formatting tweaks are made, please try to
|
|
|
|
|
make sure that the initial formatting is sound.
|
2001-04-28 01:38:14 +02:00
|
|
|
</p>
|
|
|
|
|
|
2001-09-28 00:44:24 +02:00
|
|
|
<p>The formatting guidelines for using libstdc++-v3 with doxygen are still
|
|
|
|
|
incomplete. There seems to be a marginal preference for the use of
|
|
|
|
|
Java-Doc style formatting, with the idea that the single-line style
|
|
|
|
|
(triple-slash) is the least intrusive mechanism for getting libstdc++-v3
|
|
|
|
|
documented and cross-referenced while at the same time minimizing
|
|
|
|
|
disruption to the current formatting. Full documentation of functions
|
|
|
|
|
(parameter types, return values, etc) will require the slash-splat-splat
|
|
|
|
|
"extended C" commenting style.
|
2001-04-28 01:38:14 +02:00
|
|
|
</p>
|
|
|
|
|
|
2001-09-28 00:44:24 +02:00
|
|
|
<h2> Full page index </h2>
|
|
|
|
|
<p>Here are entry points to all the pages generated by Doxygen:
|
|
|
|
|
<ul>
|
|
|
|
|
<li><a href="index.html">Main Page</a>
|
|
|
|
|
<li><a href="modules.html">Modules</a>
|
|
|
|
|
<li><a href="namespaces.html">Namespace List</a>
|
|
|
|
|
<li><a href="hierarchy.html">Class Hierarchy</a>
|
|
|
|
|
<li><a href="classes.html">Alphabetical List</a>
|
|
|
|
|
<li><a href="annotated.html">Compound List</a>
|
|
|
|
|
<li><a href="files.html">File List</a>
|
|
|
|
|
<li><a href="namespacemembers.html">Namespace Members</a>
|
|
|
|
|
<li><a href="functions.html">Compound Members</a>
|
|
|
|
|
<li><a href="globals.html">File Members</a>
|
2002-02-08 08:34:54 +01:00
|
|
|
<li><a href="todo.html">TODO List</a> (This is incomplete... how ironic.)
|
2001-09-28 00:44:24 +02:00
|
|
|
</ul>
|
2001-04-28 01:38:14 +02:00
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
2002-02-05 01:14:37 +01:00
|
|
|
<h2> License, Copyright, and Other Lawyerly Verbosity </h2>
|
|
|
|
|
<p>The libstdc++-v3 documentation is released under
|
|
|
|
|
<a href="http://gcc.gnu.org/onlinedocs/libstdc++/17_intro/license.html">
|
|
|
|
|
these terms</a>.
|
|
|
|
|
</p>
|
|
|
|
|
<p>Part of the generated documentation involved comments
|
|
|
|
|
and notes from SGI, who says we gotta say this:
|
|
|
|
|
<blockquote>
|
|
|
|
|
Permission to use, copy, modify, distribute and sell this software and its
|
|
|
|
|
documentation for any purpose is hereby granted without fee, provided
|
|
|
|
|
that the below copyright notice appears in all copies and that both
|
|
|
|
|
the copyright notice and this permission notice appear in supporting
|
|
|
|
|
documentation. Silicon Graphics makes no representations about the
|
|
|
|
|
suitability of this software for any purpose. It is provided "as is"
|
|
|
|
|
without express or implied warranty.
|
|
|
|
|
<br><br>
|
|
|
|
|
Copyright © 1994
|
|
|
|
|
Hewlett-Packard Company
|
|
|
|
|
</blockquote>
|
|
|
|
|
</p>
|
2002-03-27 22:41:36 +01:00
|
|
|
<p>Part of the generated documentation is quoted from the ISO C++ Standard,
|
|
|
|
|
which is Copyright © 1998 by Information Technology Industry Council.
|
2002-02-05 01:14:37 +01:00
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</body>
|
|
|
|
|
</html>
|
2001-04-28 01:38:14 +02:00
|
|
|
|