Documentation comments - /// feature request

Bill Baxter dnewsgroup at billbaxter.com
Tue Jan 22 08:48:37 PST 2008


Jason House wrote:
> Unknown W. Brackets Wrote:
>> 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've switched to using
> /**
>  *
>  **/
> 
> for the very reason you've mentioned.  I'm ok with both styles, but agree that multiple /// is intuitive and should probably be supported better.


I really prefer things like
///--------------------------

or /**-----------------------

or /**=======================

But all those print an annoying row of - or = in the generated 
documentation. :-(

The community could probably do a pretty good job of making fixes like 
this if the tool weren't all rolled into the compiler.

--bb



More information about the Digitalmars-d mailing list