public inbox for gcc-bugs@sourceware.org
help / color / mirror / Atom feed
* [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; 3+ 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] 3+ messages in thread

* [Bug libstdc++/44015] template parameters not documented
  2010-05-06 17:36 [Bug libstdc++/44015] New: template parameters not documented 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; 3+ 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] 3+ messages in thread

* [Bug libstdc++/44015] template parameters not documented
  2010-05-06 17:36 [Bug libstdc++/44015] New: template parameters not documented 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; 3+ 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] 3+ messages in thread

end of thread, other threads:[~2010-05-06 19:44 UTC | newest]

Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2010-05-06 17:36 [Bug libstdc++/44015] New: template parameters not documented 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).