Why is List(T) documented in std.concurrency?

Jonathan M Davis jmdavisProg at gmx.com
Wed Apr 25 14:15:46 PDT 2012


On Wednesday, April 25, 2012 22:01:45 Mirko Pilger wrote:
> > Since there's only one *, it shouldn't show up in the docs, even if it's
> > public.
> 
> "If there is no documentation comment for a declaration, that
> declaration may not appear in the output. To ensure it does appear in
> the output, put an empty declaration comment for it."
> 
> http://dlang.org/ddoc.html

Yes, but the comment on it is _not_ a ddoc comment. It's a regular comment. 
So, it shouldn't appear in the docs. For it to be a ddoc comment it would need 
to start with /++ or /**, but it starts with /*.

- Jonathan Davis


More information about the Digitalmars-d-learn mailing list