DDoc and @comments

[Jarrett Billingsley]

"Ty Tower" <tytower at hotmail.com.au> wrote in message 
news:fqdadg$1hq9$1 at digitalmars.com...
> Jarrett Billingsley Wrote:
>> Have you read the DDoc documentation?
> > http://www.digitalmars.com/d/1.0/ddoc.html
>> It doesn't use the same syntax as doxygen.
>
>
> I suppose you are trying to tell me something but you are not doing well 
> with that
> What do you mean? The documentation does not mention @ anywhere in the 
> page !
>

Stop being an ingrateful ass to everyone.  Seriously.  People try to help 
you and you make fun of them?  Get over yourself.

As has been mentioned, I don't know how many times by now, stuff like @param 
means nothing to DDoc, and it's why it's not mentioned anywhere on the 
specification page.

As for why something like this:

 @see DWT#NO_BACKGROUND
 @see DWT#NO_FOCUS
 @see DWT#NO_MERGE_PAINTS
 @see DWT#NO_REDRAW_RESIZE
 @see DWT#NO_RADIO_GROUP
 @see Widget#getStyle

becomes:

 @see DWT#NO_BACKGROUND @see DWT#NO_FOCUS @see DWT#NO_MERGE_PAINTS @see 
DWT#NO_REDRAW_RESIZE @see DWT#NO_RADIO_GROUP @see Widget#getStyle

It's because whitespace is ignored in HTML when you view the result in a web 
browser.  The compiler outputs that first block of text exactly as it 
appears, but your browser will render it without linebreaks because, well, 
that's how HTML works.  If you were to open the HTML file in a text editor 
or view the source in your browser, you'd see that the text still has the 
linebreaks in it.

Don't bother replying with some other scathing remark.  You're not going to 
impress anyone by being a douchebag.