Hi Sean,<div><br></div><div>Oh, I didn't even know you were working on another version.  Feel free to merge and edit as you want to.  Or to instruct me to merge it into the existing version.</div><div><br></div><div>Thank you very much for the detailed feedback!  I'll fix all of the issues that you bring up later today when I get some time for it.</div>

<div><br></div><div><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div>+The former is gradually being outphased in favor of the latter so you should</div>

</blockquote><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div>I think you mean "phased-out". I have never seen "outphased" used before. Google hits for "outphased" are unrelated (or vaguely-related) to this usage.</div>

</blockquote><div><br></div><div>That's a Danish term that slipped through: udfase (outphase).  I'll fix it. </div><div><br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">

<div>+   Major Division 1 (Chapter)</div></blockquote><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div>I don't think ==== means "chapter" at all. The Sphinx documentation <<a href="http://sphinx.pocoo.org/rest.html#sections" target="_blank">http://sphinx.pocoo.org/rest.html#sections</a>> mentions the breakdown for adornments used by the Python docs (which we are trying to follow), and it says ==== means "section"</div>

</blockquote><div><br></div><div>Okay, I'm just trying to give the reader some mental handles to grasp the new concepts by.   As far as I know, we are using "===" as a chapter marker, "----" as a section marker, and "^^^" as a subsection marker.  But I can see the value of sticking to the Sphinx terminology, so I'll fix this as well.</div>
<div><br></div><div><br></div><div>Regards,</div><div>Mikael</div><div>-- Disclaimer: I am <b>not</b> arrogant in real life, so if you perceive me as being arrogant, you are to blame ;-)
</div><div><br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div><span><font color="#888888"><div><br></div><div>--Sean Silva</div><div><br></div></font></span><div><div class="gmail_quote"><div><div>On Tue, Jun 19, 2012 at 1:28 PM, Mikael Lyngvig <span dir="ltr"><<a href="mailto:mikael@lyngvig.org" target="_blank">mikael@lyngvig.org</a>></span> wrote:<br>


</div></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div><div>Hi,<div><br></div><div>I've written a tiny, light-weight Technical Writing FAQ for those of us who venture into the land of converting existing HTML to Sphinx or even writing new documentation.  I posted it to LLVMdev, but got not a single reply.  </div>



<div><br></div><div>I have intentionally not linked it into the existing documentation because I have no clue where to put it.  I figure that the person who checks the document in, if it is accepted that is, can link it in somewhere.</div>



<div><br></div><div><br></div><div>Cheers,</div><div>Mikael<br clear="all"><div>-- Disclaimer: I am <b>not</b> arrogant in real life, so if you perceive me as being arrogant, you are to blame ;-)</div>
</div>
<br></div></div><div>_______________________________________________<br>
llvm-commits mailing list<br>
<a href="mailto:llvm-commits@cs.uiuc.edu" target="_blank">llvm-commits@cs.uiuc.edu</a><br>
<a href="http://lists.cs.uiuc.edu/mailman/listinfo/llvm-commits" target="_blank">http://lists.cs.uiuc.edu/mailman/listinfo/llvm-commits</a><br>
<br></div></blockquote></div><br></div></div>
</blockquote></div><br>
</div>