Andrei's Google Talk
Mike James
foo at bar.com
Mon Aug 9 10:00:50 PDT 2010
"Justin Spahr-Summers" <Justin.SpahrSummers at gmail.com> wrote in message
news:MPG.26c91a1af538b8829896b8 at news.digitalmars.com...
> 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
>
> ;)
Best April Fools joke I've seen in a while :-)
No doubt someone will implement it for the exercise...
-=mike=-
More information about the Digitalmars-d
mailing list