I was thinking that the underlining you experience PERHAPS is because Sphinx makes backlinks from each topic header to the TOC.  Depending on how links are rendered, you may see a huge underline even though I'm not using any Sphinx code that should be rendered with an underline.<br>
<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 class="im">On Fri, Jun 15, 2012 at 1:46 PM, Mikael Lyngvig <<a href="mailto:mikael@lyngvig.org">mikael@lyngvig.org</a>> wrote:<br>
> I don't seem to be able to make it fit in 80 chars.  For instance, the<br>
> numbered lists require more than 80 chars and Sphinx won't accept them if<br>
> they are broken into multiple lines.  The same goes for the questions:<br>
> Several Sphinx commands must fit within a line for Sphinx to accept them.<br>
>  I've tried backquoting the end-of-line character (text text text \), but<br>
> that didn't work either.<br>
><br>
> It all looked very nice in my end, but I didn't use the LLVM configuration<br>
> of Sphinx as I don't know where to get it from.<br>
><br>
> I got some pointers to the SVN repository for the FAQ, but the first didn't<br>
> include the FAQ and the second gave me a cycle while trying an SVN pull.<br>
>  What URL do you use to pull out the documentation for LLVM?<br>
<br>
</div>It's in the llvm repo under docs.<br>
<span class="HOEnZb"><font color="#888888"><br>
- Michael Spencer<br>
</font></span><div class="HOEnZb"><div class="h5"><br>
> 2012/6/15 Michael Spencer <<a href="mailto:bigcheesegs@gmail.com">bigcheesegs@gmail.com</a>><br>
>><br>
>> On Fri, Jun 15, 2012 at 2:25 AM, Mikael Lyngvig <<a href="mailto:mikael@lyngvig.org">mikael@lyngvig.org</a>><br>
>> wrote:<br>
>> > Can't really make a patch file as it is a new file based on FAQ.html<br>
>> > 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,<br>
>> > and<br>
>> > llvm.<br>
>> ><br>
>> > Other than that, the file should be a faithful and precise conversion<br>
>> > from<br>
>> > HTML to reST.<br>
>> ><br>
>> ><br>
>> > Cheers,<br>
>> > Mikael<br>
>><br>
>> 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>
>><br>
>> - Michael Spencer<br>
><br>
><br>
</div></div></blockquote></div><br>