aboutsummaryrefslogtreecommitdiff
path: root/libstdc++-v3/docs/doxygen
diff options
context:
space:
mode:
authorPhil Edwards <pme@gcc.gnu.org>2002-02-02 00:18:24 +0000
committerPhil Edwards <pme@gcc.gnu.org>2002-02-02 00:18:24 +0000
commit00181da3af1afe94c49be480bde27cb6cbb54dd4 (patch)
tree070bfda42825c50364b0a98e3da24745a577674b /libstdc++-v3/docs/doxygen
parentb24d861d0e29de3e7f136d62bf22d60fe00e9fce (diff)
downloadgcc-00181da3af1afe94c49be480bde27cb6cbb54dd4.zip
gcc-00181da3af1afe94c49be480bde27cb6cbb54dd4.tar.gz
gcc-00181da3af1afe94c49be480bde27cb6cbb54dd4.tar.bz2
documentation.html: Update for 3.0.96.
2002-02-01 Phil Edwards <pme@gcc.gnu.org> * docs/html/documentation.html: Update for 3.0.96. * docs/html/faq/index.html: Update for 3.0.96. * docs/html/faq/index.txt: Regenerated. * docs/doxygen/TODO: Update notes. * docs/html/17_intro/howto.html: Initial impl-specific listing. From-SVN: r49422
Diffstat (limited to 'libstdc++-v3/docs/doxygen')
-rw-r--r--libstdc++-v3/docs/doxygen/TODO16
1 files changed, 10 insertions, 6 deletions
diff --git a/libstdc++-v3/docs/doxygen/TODO b/libstdc++-v3/docs/doxygen/TODO
index 718421a..0a8cfbb 100644
--- a/libstdc++-v3/docs/doxygen/TODO
+++ b/libstdc++-v3/docs/doxygen/TODO
@@ -23,18 +23,19 @@ c25 stl_algo.h (lots of stuff)
c26 <complex>, <valarray>, stl_numeric.h[26.4], Note A
c27 Untouched
-backward/ Not scanned by doxygen. Should it be?
+backward/* Not scanned by doxygen. Should it be? Doubtful.
-ext/ Some of the SGI algorithm/functional extensions.
+ext/* Some of the SGI algorithm/functional extensions.
All of rope/hashing/slist need docs.
-__gnu_cxx Tricky.
+__gnu_cxx Tricky. Right now ext/* are in this namespace.
[1.3.5] "implementation-defined behavior: behavior ... that depends
on the implementation *and that each implementation shall
document*." [my emphasis] Not all implementation choices
have been thus described; doxygen is not necessarily the
- appropriate place for such descriptions, either.
+ appropriate place for such descriptions, either. I suggest
+ adding this list to the Chapter 17 HOWTO.
-----------------------------------------------------------
@@ -46,8 +47,11 @@ do not have the C code (to which the doxygen comments would be attached),
this would need to be done in entirely separate files, a la doxygroups.cc.
B) Huge chunks of containers and strings are described in common "Tables"
-in the standard. How to reproduce this information?
-
+in the standard. How to reproduce this information? I suspect we should
+simply write some HTML tables (say, one <table> per Table per file), and
+use doxygen hooks like @pre and @see to reference the tables. Then the
+individual classes would do like the standard does, and only document
+members for which additional info is available.
STYLE: