Documentation comments - /// feature request

Jarrett Billingsley kb3ctd2 at yahoo.com
Mon Jan 21 07:47:01 PST 2008


"Unknown W. Brackets" <unknown at simplemachines.org> wrote in message 
news:fn1jah$2nkh$1 at digitalmars.com...
> I'm a fan of the C# style of documentation comments, that is like this:
>
> /// Summary.
> ///
> /// Some longer description of the function being documented.
> ///
> /// Params:
> ///    foo =     a number, most possibly 42.
> ///
> /// Returns:     a random number based on the answer to the question
> ///              of life, the universe, and everything.
>
> It seems to me this was once supported, although ddoc.html has always 
> listed "///" as a single line documentation comment.
>
> Is there any chance of parsing the above?  I can't really see any reason 
> why two ///'s in a row would be parsed differently.  Right now blank lines 
> are inserted in between each line of the comments.

I think it's just a bug. 





More information about the Digitalmars-d mailing list