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