diff options
author | Phil Edwards <pme@gcc.gnu.org> | 2002-02-02 00:18:24 +0000 |
---|---|---|
committer | Phil Edwards <pme@gcc.gnu.org> | 2002-02-02 00:18:24 +0000 |
commit | 00181da3af1afe94c49be480bde27cb6cbb54dd4 (patch) | |
tree | 070bfda42825c50364b0a98e3da24745a577674b /libstdc++-v3/docs/doxygen | |
parent | b24d861d0e29de3e7f136d62bf22d60fe00e9fce (diff) | |
download | gcc-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/TODO | 16 |
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: |