On Fri, Aug 6, 2010 at 21:02, Andrei Alexandrescu < seewebsiteforem...@erdani.org> wrote:
> > I have an experimental std.ddoc that generates TeX. > >From a 'pure ddoc' file or from a .d file? It transforms ddoc mark-up into TeX mak-up? Would it allow (theoretically) for literate programming? weave("file.ld"); // creates file.tex tangle("file.ld"); // creates file.d > I understand your arguments - they're pretty much echoing those of myself > and of Janice Caron when we first saw the Phobos docs. It didn't take me a > long time to appreciate ddoc. Right now I'm considering converting my entire > website to use ddoc. HTML is a pile of dung to actually write text in, and > somehow I always up editing the raw HTML no matter how much editors are > trying to hide it from me. > > So how about this - give it a while and it's not impossible that your view > might change. > I still would like DDoc to allow for some sectioning: /** section: sectionName some section comments. This section is all about fun and foo. */ // fun doc fun(); //foo doc foo(); /** section: next section,about bar and baz */ etc. But, as far as I understand it, right the comments are all associated to the next declaration. Philippe