public inbox for gcc-bugs@sourceware.org
help / color / mirror / Atom feed
* [Bug libstdc++/44015] template parameters not documented
[not found] <bug-44015-4@http.gcc.gnu.org/bugzilla/>
@ 2012-05-02 22:26 ` bkoz at gcc dot gnu.org
2012-05-02 22:42 ` bkoz at gcc dot gnu.org
` (5 subsequent siblings)
6 siblings, 0 replies; 9+ messages in thread
From: bkoz at gcc dot gnu.org @ 2012-05-02 22:26 UTC (permalink / raw)
To: gcc-bugs
http://gcc.gnu.org/bugzilla/show_bug.cgi?id=44015
--- Comment #3 from Benjamin Kosnik <bkoz at gcc dot gnu.org> 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 <bkoz@redhat.com>
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
^ permalink raw reply [flat|nested] 9+ messages in thread* [Bug libstdc++/44015] template parameters not documented
[not found] <bug-44015-4@http.gcc.gnu.org/bugzilla/>
2012-05-02 22:26 ` [Bug libstdc++/44015] template parameters not documented bkoz at gcc dot gnu.org
@ 2012-05-02 22:42 ` bkoz at gcc dot gnu.org
2013-03-22 14:43 ` jakub at gcc dot gnu.org
` (4 subsequent siblings)
6 siblings, 0 replies; 9+ messages in thread
From: bkoz at gcc dot gnu.org @ 2012-05-02 22:42 UTC (permalink / raw)
To: gcc-bugs
http://gcc.gnu.org/bugzilla/show_bug.cgi?id=44015
Benjamin Kosnik <bkoz at gcc dot gnu.org> 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 <bkoz at gcc dot gnu.org> 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.
^ permalink raw reply [flat|nested] 9+ messages in thread* [Bug libstdc++/44015] template parameters not documented
[not found] <bug-44015-4@http.gcc.gnu.org/bugzilla/>
2012-05-02 22:26 ` [Bug libstdc++/44015] template parameters not documented bkoz at gcc dot gnu.org
2012-05-02 22:42 ` bkoz at gcc dot gnu.org
@ 2013-03-22 14:43 ` jakub at gcc dot gnu.org
2013-05-31 10:57 ` jakub at gcc dot gnu.org
` (3 subsequent siblings)
6 siblings, 0 replies; 9+ messages in thread
From: jakub at gcc dot gnu.org @ 2013-03-22 14:43 UTC (permalink / raw)
To: gcc-bugs
http://gcc.gnu.org/bugzilla/show_bug.cgi?id=44015
Jakub Jelinek <jakub at gcc dot gnu.org> changed:
What |Removed |Added
----------------------------------------------------------------------------
Target Milestone|4.8.0 |4.8.1
--- Comment #5 from Jakub Jelinek <jakub at gcc dot gnu.org> 2013-03-22 14:41:45 UTC ---
GCC 4.8.0 is being released, adjusting target milestone.
^ permalink raw reply [flat|nested] 9+ messages in thread* [Bug libstdc++/44015] template parameters not documented
[not found] <bug-44015-4@http.gcc.gnu.org/bugzilla/>
` (2 preceding siblings ...)
2013-03-22 14:43 ` jakub at gcc dot gnu.org
@ 2013-05-31 10:57 ` jakub at gcc dot gnu.org
2013-10-16 9:51 ` jakub at gcc dot gnu.org
` (2 subsequent siblings)
6 siblings, 0 replies; 9+ messages in thread
From: jakub at gcc dot gnu.org @ 2013-05-31 10:57 UTC (permalink / raw)
To: gcc-bugs
http://gcc.gnu.org/bugzilla/show_bug.cgi?id=44015
Jakub Jelinek <jakub at gcc dot gnu.org> changed:
What |Removed |Added
----------------------------------------------------------------------------
Target Milestone|4.8.1 |4.8.2
--- Comment #6 from Jakub Jelinek <jakub at gcc dot gnu.org> ---
GCC 4.8.1 has been released.
^ permalink raw reply [flat|nested] 9+ messages in thread* [Bug libstdc++/44015] template parameters not documented
[not found] <bug-44015-4@http.gcc.gnu.org/bugzilla/>
` (3 preceding siblings ...)
2013-05-31 10:57 ` jakub at gcc dot gnu.org
@ 2013-10-16 9:51 ` jakub at gcc dot gnu.org
2015-06-22 14:26 ` rguenth at gcc dot gnu.org
2023-05-16 19:41 ` pinskia at gcc dot gnu.org
6 siblings, 0 replies; 9+ messages in thread
From: jakub at gcc dot gnu.org @ 2013-10-16 9:51 UTC (permalink / raw)
To: gcc-bugs
http://gcc.gnu.org/bugzilla/show_bug.cgi?id=44015
Jakub Jelinek <jakub at gcc dot gnu.org> changed:
What |Removed |Added
----------------------------------------------------------------------------
Target Milestone|4.8.2 |4.8.3
--- Comment #7 from Jakub Jelinek <jakub at gcc dot gnu.org> ---
GCC 4.8.2 has been released.
^ permalink raw reply [flat|nested] 9+ messages in thread* [Bug libstdc++/44015] template parameters not documented
[not found] <bug-44015-4@http.gcc.gnu.org/bugzilla/>
` (4 preceding siblings ...)
2013-10-16 9:51 ` jakub at gcc dot gnu.org
@ 2015-06-22 14:26 ` rguenth at gcc dot gnu.org
2023-05-16 19:41 ` pinskia at gcc dot gnu.org
6 siblings, 0 replies; 9+ messages in thread
From: rguenth at gcc dot gnu.org @ 2015-06-22 14:26 UTC (permalink / raw)
To: gcc-bugs
https://gcc.gnu.org/bugzilla/show_bug.cgi?id=44015
Richard Biener <rguenth at gcc dot gnu.org> changed:
What |Removed |Added
----------------------------------------------------------------------------
Target Milestone|4.8.3 |---
^ permalink raw reply [flat|nested] 9+ messages in thread* [Bug libstdc++/44015] template parameters not documented
[not found] <bug-44015-4@http.gcc.gnu.org/bugzilla/>
` (5 preceding siblings ...)
2015-06-22 14:26 ` rguenth at gcc dot gnu.org
@ 2023-05-16 19:41 ` pinskia at gcc dot gnu.org
6 siblings, 0 replies; 9+ messages in thread
From: pinskia at gcc dot gnu.org @ 2023-05-16 19:41 UTC (permalink / raw)
To: gcc-bugs
https://gcc.gnu.org/bugzilla/show_bug.cgi?id=44015
Andrew Pinski <pinskia at gcc dot gnu.org> 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 <pinskia at gcc dot gnu.org> ---
Unassigning since Benjamin since not been active in GCC development for over 8
years now.
^ permalink raw reply [flat|nested] 9+ messages in thread
* [Bug libstdc++/44015] New: template parameters not documented
@ 2010-05-06 17:36 giecrilj at stegny dot 2a dot pl
2010-05-06 17:39 ` [Bug libstdc++/44015] " paolo dot carlini at oracle dot com
2010-05-06 19:44 ` redi at gcc dot gnu dot org
0 siblings, 2 replies; 9+ messages in thread
From: giecrilj at stegny dot 2a dot pl @ 2010-05-06 17:36 UTC (permalink / raw)
To: gcc-bugs
Reading the page "std::basic_string< _CharT, _Traits, _Alloc > Class Template
Reference" [1]:
The template parameters are not documented; in particular, their default
assignments are not mentioned.
[1]
<URL:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00260.html#_details>
--
Summary: template parameters not documented
Product: gcc
Version: unknown
Status: UNCONFIRMED
Severity: normal
Priority: P3
Component: libstdc++
AssignedTo: unassigned at gcc dot gnu dot org
ReportedBy: giecrilj at stegny dot 2a dot pl
http://gcc.gnu.org/bugzilla/show_bug.cgi?id=44015
^ permalink raw reply [flat|nested] 9+ messages in thread* [Bug libstdc++/44015] template parameters not documented
2010-05-06 17:36 [Bug libstdc++/44015] New: " giecrilj at stegny dot 2a dot pl
@ 2010-05-06 17:39 ` paolo dot carlini at oracle dot com
2010-05-06 19:44 ` redi at gcc dot gnu dot org
1 sibling, 0 replies; 9+ messages in thread
From: paolo dot carlini at oracle dot com @ 2010-05-06 17:39 UTC (permalink / raw)
To: gcc-bugs
------- 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
^ permalink raw reply [flat|nested] 9+ messages in thread* [Bug libstdc++/44015] template parameters not documented
2010-05-06 17:36 [Bug libstdc++/44015] New: " giecrilj at stegny dot 2a dot pl
2010-05-06 17:39 ` [Bug libstdc++/44015] " paolo dot carlini at oracle dot com
@ 2010-05-06 19:44 ` redi at gcc dot gnu dot org
1 sibling, 0 replies; 9+ messages in thread
From: redi at gcc dot gnu dot org @ 2010-05-06 19:44 UTC (permalink / raw)
To: gcc-bugs
------- 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 <iosfwd> and
<bits/stringfwd.h>, 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
^ permalink raw reply [flat|nested] 9+ messages in thread
end of thread, other threads:[~2023-05-16 19:41 UTC | newest]
Thread overview: 9+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
[not found] <bug-44015-4@http.gcc.gnu.org/bugzilla/>
2012-05-02 22:26 ` [Bug libstdc++/44015] template parameters not documented bkoz at gcc dot gnu.org
2012-05-02 22:42 ` bkoz at gcc dot gnu.org
2013-03-22 14:43 ` jakub at gcc dot gnu.org
2013-05-31 10:57 ` jakub at gcc dot gnu.org
2013-10-16 9:51 ` jakub at gcc dot gnu.org
2015-06-22 14:26 ` rguenth at gcc dot gnu.org
2023-05-16 19:41 ` pinskia at gcc dot gnu.org
2010-05-06 17:36 [Bug libstdc++/44015] New: " giecrilj at stegny dot 2a dot pl
2010-05-06 17:39 ` [Bug libstdc++/44015] " paolo dot carlini at oracle dot com
2010-05-06 19:44 ` redi at gcc dot gnu dot org
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).