<div><font face="arial, sans-serif">Hi Mikael,</font></div><div><font face="arial, sans-serif"><br></font></div><div><font face="arial, sans-serif">It seems like the ugly underlining that Michael mentioned is actually a CSS problem and not a document structure problem. </font><span style="font-family:arial,sans-serif">Michael Spencer and I are working on updating the CSS to avoid it.</span></div>
<div><span style="font-family:arial,sans-serif"><br></span></div><div><span style="font-family:arial,sans-serif">Also, you should prepare this as a patch that creates the reST file and removes the FAQ.html file and links the reST FAQ into the main toctree somehow, in order to avoid the conflict between FAQ.html and the generated FAQ.rst -> FAQ.html.</span></div>
<div><span style="font-family:arial,sans-serif"><br></span></div><div><span style="font-family:arial,sans-serif">btw, there was a recent change I caught out of the corner of my eye to the FAQ removing references to the C backend. Could you doublecheck to make sure that those changes get pulled into your reST version? Thanks.</span></div>
<div><span style="font-family:arial,sans-serif"><br></span></div><div><span style="font-family:arial,sans-serif">--Sean Silva</span></div><br><div class="gmail_quote">On Fri, Jun 15, 2012 at 1:46 PM, Mikael Lyngvig <span dir="ltr"><<a href="mailto:mikael@lyngvig.org" target="_blank">mikael@lyngvig.org</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">I don't seem to be able to make it fit in 80 chars. For instance, the numbered lists require more than 80 chars and Sphinx won't accept them if they are broken into multiple lines. The same goes for the questions: Several Sphinx commands must fit within a line for Sphinx to accept them. I've tried backquoting the end-of-line character (text text text \), but that didn't work either.<div>
<br></div><div>It all looked very nice in my end, but I didn't use the LLVM configuration of Sphinx as I don't know where to get it from.<br><div><br></div><div>I got some pointers to the SVN repository for the FAQ, but the first didn't include the FAQ and the second gave me a cycle while trying an SVN pull. What URL do you use to pull out the documentation for LLVM?</div>
<div class="im">
<div><br><div class="gmail_quote">2012/6/15 Michael Spencer <span dir="ltr"><<a href="mailto:bigcheesegs@gmail.com" target="_blank">bigcheesegs@gmail.com</a>></span><br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div><div>On Fri, Jun 15, 2012 at 2:25 AM, Mikael Lyngvig <<a href="mailto:mikael@lyngvig.org" target="_blank">mikael@lyngvig.org</a>> wrote:<br>
> Can't really make a patch file as it is a new file based on FAQ.html from<br>
> the website.<br>
><br>
> Changes are:<br>
><br>
> 1. The format is now reST instead of HTML.<br>
> 2. A few (like two or three) missing code markups have been added.<br>
> 3. Sphinx code-blocks are now used for all kinds of code: bash, c, and<br>
> llvm.<br>
><br>
> Other than that, the file should be a faithful and precise conversion from<br>
> HTML to reST.<br>
><br>
><br>
> Cheers,<br>
> Mikael<br>
<br>
</div></div>It needs to be 80-col except for underlined headers. Also it needs to<br>
be linked from a toctree and properly integrated. It also currently<br>
conflicts with the FAQ.html that gets copied in so I had to rename it<br>
to even see what it looked like.<br>
<br>
Each header is currently getting underlined by Sphinx, this looks<br>
pretty weird. It should be using a different header level.<br>
<span><font color="#888888"><br>
- Michael Spencer<br>
</font></span></blockquote></div><br></div></div></div>
<br>_______________________________________________<br>
llvm-commits mailing list<br>
<a href="mailto:llvm-commits@cs.uiuc.edu">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></blockquote></div><br>