Skip to content

R
riscv-gcc-1
Commit 1b4a6975 by Phil Edwards
Options

Intro.3: More notes. 

2001-11-19  Phil Edwards  <pme@gcc.gnu.org>

	* docs/doxygen/Intro.3:  More notes.
	* docs/doxygen/style.css:  Update to default style from Doxygen 1.2.10.
	* include/bits/stl_algobase.h:  Add doxygen hooks for functions.
	* include/ext/hash_map:  Add @file hook.
	* include/ext/hash_set:  Likewise.
	* include/ext/rope:  Likewise.
	* include/ext/ropeimpl.h:  Likewise.
	* include/ext/slist:  Likewise.
	* include/ext/stl_hash_fun.h:  Likewise.
	* include/ext/stl_hashtable.h:  Likewise.
	* include/ext/stl_rope.h:  Likewise.

	* docs/html/17_intro/license.html:  Remove "experimental" sentence.
	* docs/html/19_diagnostics/howto.html:  Document new verbose
	terminate handler.
	* testsuite/27_io/filebuf.cc:  Fix comment, move tweakable parameter
	to more visible (closer to description) position.

	* libsupc++/eh_type.cc:  Formatting tweak.
	* libsupc++/exception:  Likewise.
	* src/vterminate.cc:  Likewise.

	* docs/html/17_intro/porting.html:  Regenerate.
	* docs/html/faq/index.txt:  Regenerate.

From-SVN: r47193
parent b73f6494
Showing with 139 additions and 34 deletions
libstdc++-v3/ChangeLog
2001-11-19 Phil Edwards <pme@gcc.gnu.org>
* docs/doxygen/Intro.3: More notes.
* docs/doxygen/style.css: Update to default style from Doxygen 1.2.10.
* include/bits/stl_algobase.h: Add doxygen hooks for functions.
* include/ext/hash_map: Add @file hook.
* include/ext/hash_set: Likewise.
* include/ext/rope: Likewise.
* include/ext/ropeimpl.h: Likewise.
* include/ext/slist: Likewise.
* include/ext/stl_hash_fun.h: Likewise.
* include/ext/stl_hashtable.h: Likewise.
* include/ext/stl_rope.h: Likewise.
* docs/html/17_intro/license.html: Remove "experimental" sentence.
* docs/html/19_diagnostics/howto.html: Document new verbose
terminate handler.
* testsuite/27_io/filebuf.cc: Fix comment, move tweakable parameter
to more visible (closer to description) position.
* libsupc++/eh_type.cc: Formatting tweak.
* libsupc++/exception: Likewise.
* src/vterminate.cc: Likewise.
* docs/html/17_intro/porting.html: Regenerate.
* docs/html/faq/index.txt: Regenerate.
2001-11-18 Jason Merrill <jason@redhat.com>
* libsupc++/eh_personality.cc (__cxa_call_unexpected): Take void*.
......
libstdc++-v3/docs/doxygen/Intro.3
......@@ -15,7 +15,8 @@ All standard library entities are declared within
and have manual entries beginning with "std_". For example, to see
documentation of the template class
.I std::vector
one would use "man std_vector".
one would use "man std_vector". Some entities do not have a separate man
page; for those see the main listing in "man Namespace_Std".
.P
All the man pages are automatically generated by Doxygen. For more
information on this tool, see the HTML counterpart to these man pages.
......
libstdc++-v3/docs/doxygen/style.css
......@@ -5,12 +5,15 @@ A.el { text-decoration: none; font-weight: bold }
A.elRef { font-weight: bold }
A.code { text-decoration: none; font-weight: normal; color: #4444ee }
A.codeRef { font-weight: normal; color: #4444ee }
A:hover { text-decoration: none; background-color: #f2f2ff }
DL.el { margin-left: -1cm }
DIV.fragment { width: 100%; border: none; background-color: #eeeeee }
DIV.ah { background-color: black; margin-bottom: 3; margin-top: 3 }
TD.md { background-color: #f2f2ff }
DIV.groupHeader { margin-left: 16; margin-top: 12; margin-bottom: 6; font-weight: bold }
DIV.groupText { margin-left: 16; font-style: italic; font-size: smaller }
DIV.ah { background-color: black; font-weight: bold; color: #ffffff; margin-bottom: 3px; margin-top: 3px }
TD.md { background-color: #f2f2ff; font-weight: bold; }
TD.mdname1 { background-color: #f2f2ff; font-weight: bold; font-style: italic; }
TD.mdname { background-color: #f2f2ff; font-weight: bold; font-style: italic; width: 600px; }
DIV.groupHeader { margin-left: 16px; margin-top: 12px; margin-bottom: 6px; font-weight: bold }
DIV.groupText { margin-left: 16px; font-style: italic; font-size: smaller }
FONT.keyword { color: #008000 }
FONT.keywordtype { color: #604020 }
FONT.keywordflow { color: #e08000 }
......
libstdc++-v3/docs/html/17_intro/license.html
......@@ -13,9 +13,6 @@
<h1 class="centered"><a name="top">Licenses for the Library</a></h1>
<p><strong>As long as this sentence is in place, this page isn't
official. It is still experimental if you are reading this.</strong></p>
<p>There are two licenses affecting GNU libstdc++-v3: one for the code, and
one for the documentation. Here we will describe both of them, and try
to answer some of the widespread questions. If you have more questions,
......
libstdc++-v3/docs/html/17_intro/porting.html
......@@ -115,8 +115,8 @@ stream (or one hooked to a pipe) is not allowed by the OS. In this
case, getc()/ungetc() will be used at some key locations in the library
implementation instead of fseek(). Currently, the code path to avoid
fseek() is only enabled when the seek size is 1 character away from the
current stream position. This is known to improve *-unknown-freebsd*
and sparc-sun-solaris2.*.
current stream position. This is known to improve *-unknown-freebsd*,
sparc-sun-solaris2.* and *-*-mingw32*.
<p>Finally, you should bracket the entire file in an include-guard, like
this:
......
libstdc++-v3/docs/html/19_diagnostics/howto.html
......@@ -26,6 +26,7 @@
<li><a href="#1">Adding data to exceptions</a>
<li><a href="#2">Exception class hierarchy diagram</a>
<li><a href="#3">Concept checkers -- <strong>new and improved!</strong></a>
<li><a href="#4">Verbose <code>terminate</code></a>
</ul>
<hr>
......@@ -101,7 +102,65 @@
<p>Right now they are off by default. More will be added once
GCC 3.0 is released and we have time to revisit this topic.
</p>
<p>Return <a href="#top">to top of page</a> or
<a href="../faq/index.html">to the FAQ</a>.
</p>
<hr>
<h2><a name="4">Verbose <code>terminate</code></a></h2>
<p>If you are having difficulty with uncaught exceptions and want a
little bit of help debugging the causes of the core dumps, you can
make use of a GNU extension in GCC 3.1 and later:
<pre>
#include &lt;exception&gt;
int main()
{
std::set_terminate (__gnu_cxx::verbose_terminate_handler);
...
throw <em>anything</em>;
}</pre>
</p>
<p>The <code> verbose_terminate_handler </code> function obtains the name
of the current exception, attempts to demangle it, and prints it to
stderr. If the exception is derived from <code> std::exception </code>
then the output from <code>what()</code> will be included.
</p>
<p>Any replacement termination function is required to kill the program
without returning; this one calls abort.
</p>
<p>For example:
<pre>
#include &lt;exception&gt;
#include &lt;stdexcept&gt;
struct BLARGH : std::runtime_error
{
BLARGH (const string&amp; whatarg)
: std::runtime_error(whatarg) { }
};
int main (int argc)
{
std::set_terminate (__gnu_cxx::verbose_terminate_handler);
if (argc &gt; 5)
throw BLARGH(&quot;argc is greater than 5!&quot;);
else
throw argc;
}</pre>
</p>
<p>In GCC 3.1 and later, this gives
<pre>
% ./a.out
terminate called after throwing a `int'
Aborted
% ./a.out f f f f f f f f f f f
terminate called after throwing a `BLARGH'
what(): argc is greater than 5!
Aborted
%</pre>
The 'Aborted' line comes from the call to abort(), of course.
</p>
<p>Return <a href="#top">to top of page</a> or
<a href="../faq/index.html">to the FAQ</a>.
</p>
......
libstdc++-v3/docs/html/faq/index.txt
......@@ -643,9 +643,10 @@ a
All library objects are safe to use in a multithreaded program as long
as each thread carefully locks out access by any other thread while it
uses any object visible to another thread. This requirement includes
both read and write access to objects; do not assume that two threads
may read a shared standard container at the same time.
uses any object visible to another thread. In general, this
requirement includes both read and write access to objects; unless
otherwise documented as safe, do not assume that two threads may
access a shared standard library object at the same time.
See chapters [84]17 (library introduction), [85]23 (containers), and
[86]27 (I/O) for more information.
......
libstdc++-v3/include/ext/hash_map
......@@ -53,8 +53,9 @@
*
*/
/* NOTE: This is an internal header file, included by other STL headers.
* You should not attempt to use it directly.
/** @file hash_map
* This header file is an extension to the Standard C++ Library. You should
* use the "ext/" path prefix in your @c #include statements.
*/
#ifndef __SGI_STL_INTERNAL_HASH_MAP_H
......
libstdc++-v3/include/ext/hash_set
......@@ -53,8 +53,9 @@
*
*/
/* NOTE: This is an internal header file, included by other STL headers.
* You should not attempt to use it directly.
/** @file hash_set
* This header file is an extension to the Standard C++ Library. You should
* use the "ext/" path prefix in your @c #include statements.
*/
#ifndef __SGI_STL_INTERNAL_HASH_SET_H
......
libstdc++-v3/include/ext/rope
......@@ -40,6 +40,11 @@
* purpose. It is provided "as is" without express or implied warranty.
*/
/** @file rope
* This header file is an extension to the Standard C++ Library. You should
* use the "ext/" path prefix in your @c #include statements.
*/
#ifndef __SGI_STL_ROPE
#define __SGI_STL_ROPE
......
libstdc++-v3/include/ext/ropeimpl.h
......@@ -40,13 +40,14 @@
* purpose. It is provided "as is" without express or implied warranty.
*/
/* NOTE: This is an internal header file, included by other STL headers.
* You should not attempt to use it directly.
/** @file ropeimpl.h
* This is an internal header file, included by other library headers.
* You should not attempt to use it directly.
*/
#include <bits/std_cstdio.h>
#include <bits/std_iostream.h>
# include <bits/functexcept.h>
#include <bits/functexcept.h>
namespace std
{
......
libstdc++-v3/include/ext/slist
......@@ -41,8 +41,9 @@
*
*/
/* NOTE: This is an internal header file, included by other STL headers.
* You should not attempt to use it directly.
/** @file slist
* This header file is an extension to the Standard C++ Library. You should
* use the "ext/" path prefix in your @c #include statements.
*/
#ifndef __SGI_STL_INTERNAL_SLIST_H
......
libstdc++-v3/include/ext/stl_hash_fun.h
......@@ -53,8 +53,9 @@
*
*/
/* NOTE: This is an internal header file, included by other STL headers.
* You should not attempt to use it directly.
/** @file stl_hash_fun.h
* This is an internal header file, included by other library headers.
* You should not attempt to use it directly.
*/
#ifndef _CPP_BITS_STL_HASH_FUN_H
......
libstdc++-v3/include/ext/stl_hashtable.h
......@@ -53,8 +53,9 @@
*
*/
/* NOTE: This is an internal header file, included by other STL headers.
* You should not attempt to use it directly.
/** @file stl_hashtable.h
* This is an internal header file, included by other library headers.
* You should not attempt to use it directly.
*/
#ifndef __SGI_STL_INTERNAL_HASHTABLE_H
......
libstdc++-v3/include/ext/stl_rope.h
......@@ -40,8 +40,9 @@
* purpose. It is provided "as is" without express or implied warranty.
*/
/* NOTE: This is an internal header file, included by other STL headers.
* You should not attempt to use it directly.
/** @file stl_rope.h
* This is an internal header file, included by other library headers.
* You should not attempt to use it directly.
*/
// rope<_CharT,_Alloc> is a sequence of _CharT.
......
libstdc++-v3/libsupc++/eh_type.cc
......@@ -31,7 +31,8 @@
#include <typeinfo>
#include "unwind-cxx.h"
namespace __cxxabiv1 {
namespace __cxxabiv1
{
// Returns the type_info for the currently handled exception [15.3/8], or
// null if there is none.
......
libstdc++-v3/libsupc++/exception
......@@ -95,7 +95,8 @@ namespace std
bool uncaught_exception() throw();
} // namespace std
namespace __gnu_cxx {
namespace __gnu_cxx
{
/** A replacement for the standard terminate_handler which prints more
information about the terminating exception (if any) on stderr. */
void verbose_terminate_handler ();
......
libstdc++-v3/src/vterminate.cc
......@@ -36,7 +36,8 @@
using namespace std;
using namespace abi;
namespace __gnu_cxx {
namespace __gnu_cxx
{
/** This is a replacement for the standard terminate_handler which prints
more information about the terminating exception (if any) on stderr. */
......
libstdc++-v3/testsuite/27_io/filebuf.cc
......@@ -19,12 +19,16 @@
// USA.
// NB: this test assumes that _M_buf_size == 40, and not the usual
// buffer_size length of 8092, so that overflow/underflow can be
// buffer_size length of BUFSIZ (8192), so that overflow/underflow can be
// simulated a bit more readily.
// NRB (Nota Really Bene): setting it to 40 breaks the test, as intended.
// @require@ %-*.tst %-*.txt
// @diff@ %-*.tst %*.txt
const int buffer_size = 8192;
//const int buffer_size = 40;
#include <fstream>
#include <iostream>
#include <testsuite_hooks.h>
......@@ -46,8 +50,6 @@ derived_filebuf fb_01; // in
derived_filebuf fb_02; // out
derived_filebuf fb_03; // in | out
const int buffer_size = 8192;
// initialize filebufs to be the same size regardless of platform
void test00()
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment