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