This is the mail archive of the
gcc-patches@gcc.gnu.org
mailing list for the GCC project.
[libstdc++] FAQ update, doxygen config tweaks
- From: Phil Edwards <phil at jaj dot com>
- To: libstdc++ at gcc dot gnu dot org, gcc-patches at gcc dot gnu dot org
- Date: Wed, 17 Apr 2002 21:43:47 -0400
- Subject: [libstdc++] FAQ update, doxygen config tweaks
Only thing noteworthy here is a reminder on using dlopen/dlsym with
libstdc++. Documentation change only, applied to trunk and branch.
2002-04-17 Phil Edwards <pme@gcc.gnu.org>
* docs/doxygen/mainpage.html: Doxygen logo is now a PNG file.
* docs/doxygen/run_doxygen: Bump required version.
* docs/doxygen/user.cfg.in: Revert accidental change.
* docs/html/faq/index.html: Reindent a block of links.
(4.4): New note on using dlsym.
* docs/html/faq/index.txt: Regenerated.
Index: docs/doxygen/mainpage.html
===================================================================
RCS file: /cvs/gcc/gcc/libstdc++-v3/docs/doxygen/mainpage.html,v
retrieving revision 1.4
diff -u -3 -p -r1.4 mainpage.html
--- docs/doxygen/mainpage.html 2 Apr 2002 02:07:19 -0000 1.4
+++ docs/doxygen/mainpage.html 18 Apr 2002 01:40:27 -0000
@@ -61,7 +61,7 @@
To learn more about Doxygen, take a look at
<a href="http://www.doxygen.org/">
<!-- snagged from the generated page -->
- <img src="doxygen.gif" alt="the Doxygen homepage"
+ <img src="doxygen.png" alt="the Doxygen homepage"
align=center border=0 width=110 height=53>
</a>
</p>
Index: docs/doxygen/run_doxygen
===================================================================
RCS file: /cvs/gcc/gcc/libstdc++-v3/docs/doxygen/run_doxygen,v
retrieving revision 1.15
diff -u -3 -p -r1.15 run_doxygen
--- docs/doxygen/run_doxygen 2 Apr 2002 02:07:19 -0000 1.15
+++ docs/doxygen/run_doxygen 18 Apr 2002 01:40:27 -0000
@@ -9,7 +9,7 @@
# We can check now that the version of doxygen is >= this variable.
-DOXYVER=1.2.14
+DOXYVER=1.2.15
doxygen=
find_doxygen() {
Index: docs/doxygen/user.cfg.in
===================================================================
RCS file: /cvs/gcc/gcc/libstdc++-v3/docs/doxygen/user.cfg.in,v
retrieving revision 1.16
diff -u -3 -p -r1.16 user.cfg.in
--- docs/doxygen/user.cfg.in 27 Mar 2002 21:41:30 -0000 1.16
+++ docs/doxygen/user.cfg.in 18 Apr 2002 01:40:28 -0000
@@ -271,7 +271,7 @@ WARNINGS = NO
# for undocumented members. If EXTRACT_ALL is set to YES then this flag will
# automatically be disabled.
-WARN_IF_UNDOCUMENTED = YES
+WARN_IF_UNDOCUMENTED = NO
# The WARN_FORMAT tag determines the format of the warning messages that
# doxygen can produce. The string should contain the $file, $line, and $text
Index: docs/html/faq/index.html
===================================================================
RCS file: /cvs/gcc/gcc/libstdc++-v3/docs/html/faq/index.html,v
retrieving revision 1.35
diff -u -3 -p -r1.35 index.html
--- docs/html/faq/index.html 19 Mar 2002 20:16:12 -0000 1.35
+++ docs/html/faq/index.html 18 Apr 2002 01:40:28 -0000
@@ -69,18 +69,19 @@
<li><a href="#4_1">What works already?</a>
<li><a href="#4_2">Bugs in gcc/g++ (not libstdc++-v3)</a>
<li><a href="#4_3">Bugs in the C++ language/lib specification</a>
- <li><a href="#4_4">Things in libstdc++ that look like bugs</a>
- <ul>
- <li><a href="#4_4_iostreamclear">reopening a stream fails</a>
- <li><a href="#4_4_Weff">-Weffc++ complains too much</a>
- <li><a href="#4_4_rel_ops">"ambiguous overloads"
- after including an old-style header</a>
- <li><a href="#4_4_interface">The g++-3 headers are
- <strong>not ours</strong></a>
- <li><a href="#4_4_glibc">compilation errors from streambuf.h</a>
- <li><a href="#4_4_checks">errors about <em>*Cconcept</em> and
- <em>constraints</em> in the STL...</a>
- </ul>
+ <li><a href="#4_4">Things in libstdc++ that only look like bugs</a><ul>
+ <li><a href="#4_4_iostreamclear">reopening a stream fails</a>
+ <li><a href="#4_4_Weff">-Weffc++ complains too much</a>
+ <li><a href="#4_4_rel_ops">"ambiguous overloads"
+ after including an old-style header</a>
+ <li><a href="#4_4_interface">The g++-3 headers are
+ <strong>not ours</strong></a>
+ <li><a href="#4_4_glibc">compilation errors from streambuf.h</a>
+ <li><a href="#4_4_checks">errors about <em>*Cconcept</em> and
+ <em>constraints</em> in the STL...</a>
+ <li><a href="#4_4_dlsym">program crashes when using library code
+ in a dynamically-loaded library</a>
+ </ul>
<li><a href="#4_5">Aw, that's easy to fix!</a>
</ol>
@@ -566,7 +567,7 @@ New in 3.0.97:
</p>
<hr>
- <h2><a name="4_4">4.4 Things in libstdc++ that look like bugs</a></h2>
+ <h2><a name="4_4">4.4 Things in libstdc++ that only look like bugs</a></h2>
<p>There are things which are not bugs in the compiler (4.2) nor
the language specification (4.3), but aren't really bugs in
libstdc++, either. Really! Please do not report these as bugs.
@@ -675,6 +676,24 @@ http://clisp.cons.org/~haible/gccinclude
checks, is available
<a href="../19_diagnostics/howto.html#3">here</a>.
</p>
+ </a>
+ <a name="4_4_dlsym">
+ <p><strong>dlopen/dlsym</strong>
+ If you are using the C++ library across dynamically-loaded
+ objects, make certain that you are passing the correct options
+ when compiling and linking:
+ <pre>
+ // compile the library components
+ g++ -fPIC -c a.cc
+ g++ -fPIC -c b.cc
+ ...
+ g++ -fPIC -c z.cc
+
+ // create the library
+ g++ -fPIC -shared -rdynamic -o libfoo.so a.o b.o ... z.o
+
+ // link the executable
+ g++ -fPIC -rdynamic -o foo ... -L. -lfoo -ldl</pre></p>
</a>
<hr>