[Bug libstdc++/44015] template parameters not documented
http://gcc.gnu.org/bugzilla/show_bug.cgi?id=44015 --- Comment #3 from Benjamin Kosnik 2012-05-02 22:25:36 UTC --- Author: bkoz Date: Wed May 2 22:25:28 2012 New Revision: 187066 URL: http://gcc.gnu.org/viewcvs?root=gcc&view=rev&rev=187066 Log: 2012-05-02 Benjamin Kosnik PR libstdc++/44015 * include/bits/basic_ios.h: Add tparam markup for * doxygen. include/bits/basic_string.h: Same. * include/bits/forward_list.h: Same. * include/bits/stl_bvector.h: Same. * include/bits/stl_deque.h: Same. * include/bits/stl_list.h: Same. include/bits/stl_map.h: * Same. include/bits/stl_multimap.h: Same. * include/bits/stl_multiset.h: Same. * include/bits/stl_pair.h: Same. * include/bits/stl_queue.h: Same. * include/bits/stl_set.h: Same. * include/bits/stl_stack.h: Same. * include/bits/stl_vector.h: Same. * include/bits/unordered_map.h: Same. * include/bits/unordered_set.h: Same. include/std/array: * Same. include/std/atomic: Same. include/std/fstream: * Same. include/std/istream: Same. include/std/ostream: * Same. include/std/sstream: Same. * include/std/streambuf: Same. * testsuite/23_containers/deque/requirements/dr438/*: Adjust line numbers. * testsuite/23_containers/list/requirements/dr438/*: Same. * testsuite/23_containers/vector/requirements/dr438/*: Same. Modified: trunk/libstdc++-v3/ChangeLog trunk/libstdc++-v3/include/bits/basic_ios.h trunk/libstdc++-v3/include/bits/basic_string.h trunk/libstdc++-v3/include/bits/forward_list.h trunk/libstdc++-v3/include/bits/stl_bvector.h trunk/libstdc++-v3/include/bits/stl_deque.h trunk/libstdc++-v3/include/bits/stl_list.h trunk/libstdc++-v3/include/bits/stl_map.h trunk/libstdc++-v3/include/bits/stl_multimap.h trunk/libstdc++-v3/include/bits/stl_multiset.h trunk/libstdc++-v3/include/bits/stl_pair.h trunk/libstdc++-v3/include/bits/stl_queue.h trunk/libstdc++-v3/include/bits/stl_set.h trunk/libstdc++-v3/include/bits/stl_stack.h trunk/libstdc++-v3/include/bits/stl_vector.h trunk/libstdc++-v3/include/bits/unordered_map.h trunk/libstdc++-v3/include/bits/unordered_set.h trunk/libstdc++-v3/include/std/array trunk/libstdc++-v3/include/std/atomic trunk/libstdc++-v3/include/std/fstream trunk/libstdc++-v3/include/std/istream trunk/libstdc++-v3/include/std/ostream trunk/libstdc++-v3/include/std/sstream trunk/libstdc++-v3/include/std/streambuf trunk/libstdc++-v3/testsuite/23_containers/deque/requirements/dr438/assign_neg.cc trunk/libstdc++-v3/testsuite/23_containers/deque/requirements/dr438/constructor_1_neg.cc trunk/libstdc++-v3/testsuite/23_containers/deque/requirements/dr438/constructor_2_neg.cc trunk/libstdc++-v3/testsuite/23_containers/deque/requirements/dr438/insert_neg.cc trunk/libstdc++-v3/testsuite/23_containers/list/requirements/dr438/assign_neg.cc trunk/libstdc++-v3/testsuite/23_containers/list/requirements/dr438/constructor_1_neg.cc trunk/libstdc++-v3/testsuite/23_containers/list/requirements/dr438/constructor_2_neg.cc trunk/libstdc++-v3/testsuite/23_containers/list/requirements/dr438/insert_neg.cc trunk/libstdc++-v3/testsuite/23_containers/vector/requirements/dr438/assign_neg.cc trunk/libstdc++-v3/testsuite/23_containers/vector/requirements/dr438/constructor_1_neg.cc trunk/libstdc++-v3/testsuite/23_containers/vector/requirements/dr438/constructor_2_neg.cc trunk/libstdc++-v3/testsuite/23_containers/vector/requirements/dr438/insert_neg.cc
[Bug libstdc++/44015] template parameters not documented
http://gcc.gnu.org/bugzilla/show_bug.cgi?id=44015 Benjamin Kosnik changed: What|Removed |Added Status|UNCONFIRMED |ASSIGNED Last reconfirmed||2012-05-02 CC||bkoz at gcc dot gnu.org AssignedTo|unassigned at gcc dot |bkoz at gcc dot gnu.org |gnu.org | Target Milestone|--- |4.8.0 Ever Confirmed|0 |1 --- Comment #4 from Benjamin Kosnik 2012-05-02 22:41:44 UTC --- I noticed this again recently, while mucking with std::unordered_set etc. The checked-in patch adds in the necessary markup for containers and io. It seems complete and consistent: string http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00428.html array http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00569.html basic_istream http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00425.html etc. This is the way to write the markup for template parameters, and default arguments to them.
[Bug libstdc++/44015] template parameters not documented
--- Comment #1 from paolo dot carlini at oracle dot com 2010-05-06 17:39 --- Let's add Benjamin for this one too. Are you sure the template parameters and the defaults are documented for *all* the other classes besides basic_string? Seems really weird. -- paolo dot carlini at oracle dot com changed: What|Removed |Added CC||bkoz at redhat dot com http://gcc.gnu.org/bugzilla/show_bug.cgi?id=44015
[Bug libstdc++/44015] template parameters not documented
--- Comment #2 from redi at gcc dot gnu dot org 2010-05-06 19:44 --- basic_stringstream etc. are missing docs for their default template arguments too, I think it's because the doxygen comments are on the class template definitions, not on the forward declarations in and , and the default parameters are only defined in the forward declarations. For types, such as vector, with no forward declaration the default template args are documented by doxygen -- redi at gcc dot gnu dot org changed: What|Removed |Added Keywords||documentation http://gcc.gnu.org/bugzilla/show_bug.cgi?id=44015
[Bug libstdc++/44015] template parameters not documented
http://gcc.gnu.org/bugzilla/show_bug.cgi?id=44015 Jakub Jelinek changed: What|Removed |Added Target Milestone|4.8.0 |4.8.1 --- Comment #5 from Jakub Jelinek 2013-03-22 14:41:45 UTC --- GCC 4.8.0 is being released, adjusting target milestone.
[Bug libstdc++/44015] template parameters not documented
https://gcc.gnu.org/bugzilla/show_bug.cgi?id=44015 Richard Biener changed: What|Removed |Added Target Milestone|4.8.3 |---
[Bug libstdc++/44015] template parameters not documented
http://gcc.gnu.org/bugzilla/show_bug.cgi?id=44015 Jakub Jelinek changed: What|Removed |Added Target Milestone|4.8.1 |4.8.2 --- Comment #6 from Jakub Jelinek --- GCC 4.8.1 has been released.
[Bug libstdc++/44015] template parameters not documented
https://gcc.gnu.org/bugzilla/show_bug.cgi?id=44015 Andrew Pinski changed: What|Removed |Added Status|ASSIGNED|NEW Assignee|bkoz at gcc dot gnu.org|unassigned at gcc dot gnu.org --- Comment #8 from Andrew Pinski --- Unassigning since Benjamin since not been active in GCC development for over 8 years now.