<br><div class="gmail_quote">On Fri, Aug 6, 2010 at 21:02, Andrei Alexandrescu <span dir="ltr">&lt;<a href="mailto:SeeWebsiteForEmail@erdani.org">SeeWebsiteForEmail@erdani.org</a>&gt;</span> wrote:<br><blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;">
<div><div></div><div class="h5"><br></div></div>
I have an experimental std.ddoc that generates TeX.<br></blockquote><div><br>From a &#39;pure ddoc&#39; file or from a .d file?<br>It transforms ddoc mark-up into TeX mak-up?<br><br>Would it allow (theoretically) for literate programming?<br>
<br>weave(&quot;file.ld&quot;); // creates file.tex<br>tangle(&quot;file.ld&quot;); // creates file.d<br><br> </div><blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;">


I understand your arguments - they&#39;re pretty much echoing those of myself and of Janice Caron when we first saw the Phobos docs. It didn&#39;t take me a long time to appreciate ddoc. Right now I&#39;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.<br>

<br>
So how about this - give it a while and it&#39;s not impossible that your view might change.<br></blockquote><div><br>I still would like DDoc to allow for some sectioning:<br><br>/**<br>section: sectionName<br>some section comments. This section is all about fun and foo.<br>
*/<br><br>// fun doc<br>fun();<br><br>//foo doc<br>foo();<br><br>/**<br>section: next section,about bar and baz<br>*/<br>etc.<br><br>But, as far as I understand it, right the comments are all associated to the next declaration.<br>
<br>Philippe<br><br></div></div>