Andrei's Google Talk

Justin Spahr-Summers Justin.SpahrSummers at gmail.com
Sun Aug 8 20:47:10 PDT 2010


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

;)


More information about the Digitalmars-d mailing list