Andrei's Google Talk

BCS none at anon.com
Sun Aug 8 21:11:50 PDT 2010


Hello Justin Spahr-Summers,

> 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
> ;)
> 

I wonder how long that took to write. Just the typing must have taken some 
time but if you factor in the time take to recover from the laughter induce 
injuries it may have taken weeks!

-- 
... <IXOYE><





More information about the Digitalmars-d mailing list