diff options
| author | pme <pme@138bc75d-0d04-0410-961f-82ee72b054a4> | 2002-02-02 00:18:24 +0000 |
|---|---|---|
| committer | pme <pme@138bc75d-0d04-0410-961f-82ee72b054a4> | 2002-02-02 00:18:24 +0000 |
| commit | 7af41b037926d2229e3123d3f4a33d63ee036118 (patch) | |
| tree | 070bfda42825c50364b0a98e3da24745a577674b /libstdc++-v3/docs/doxygen/TODO | |
| parent | e0f546342f4b4976c2b7c48c6739a2d8c187b9ed (diff) | |
| download | ppe42-gcc-7af41b037926d2229e3123d3f4a33d63ee036118.tar.gz ppe42-gcc-7af41b037926d2229e3123d3f4a33d63ee036118.zip | |
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.
git-svn-id: svn+ssh://gcc.gnu.org/svn/gcc/trunk@49422 138bc75d-0d04-0410-961f-82ee72b054a4
Diffstat (limited to 'libstdc++-v3/docs/doxygen/TODO')
| -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 718421a1de9..0a8cfbb36e8 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: |
