Andrei's Google Talk
Nick Sabalausky
a at a.a
Fri Aug 6 22:19:03 PDT 2010
"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.
More information about the Digitalmars-d
mailing list