Andrei's Google Talk

Adrian Matoga epi at atari8.info
Mon Aug 9 11:55:36 PDT 2010


On 2010-08-09 05:47, Justin Spahr-Summers wrote:
> On Sat, 7 Aug 2010 01:19:03 -0400, Nick Sabalausky <a at a.a> wrote:
>> "Jesse Phillips" <jessekphillips+D at gmail.com> wrote in message 
>> news:i3hr7p$1s1$1 at digitalmars.com...
>>> Steven Schveighoffer Wrote:
>>>
>>>> I wouldn't mind the current docs, but I'd like to have some document to
>>>> know what tags are defined and what they mean (like a ddocdoc), and how 
>>>> to
>>>> define new tags.  Maybe this already exists?
>>> My two comments are, shouldn't paragraphs be handled with a blank line?
>> YES.
>>
>> And along those exact lines, may I say I'm a big fan of the Natural Docs 
>> approach. IMO, comments should be [*easily*] readable *before* being run 
>> through a doc generator, not just after. Of course, in that regard (not to 
>> mention writeability) DDoc beats the snot out of C#'s horrid XML comments 
>> (I've never understood MS's enormous obsession with XML), but DDoc still has 
>> that same fundamental problem.
> 
> Just in case you haven't seen this page before:
> http://www.charlespetzold.com/etc/CSAML.html
> 
> ;)

But, you see, it was easy to believe it was truth. :)


More information about the Digitalmars-d mailing list