<div class="gmail_quote">On Tue, Aug 17, 2010 at 4:50 PM, OvermindDL1 <span dir="ltr"><<a href="mailto:overminddl1@gmail.com">overminddl1@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;">
<div class="im">On Tue, Aug 17, 2010 at 5:25 PM, Chris Lattner <<a href="mailto:clattner@apple.com">clattner@apple.com</a>> wrote:<br>
><br>
> On Aug 17, 2010, at 3:42 PM, OvermindDL1 wrote:<br>
><br>
>><br>
>> On Tue, Aug 17, 2010 at 4:09 PM, David A. Greene <<a href="mailto:greened@obbligato.org">greened@obbligato.org</a>> wrote:<br>
>>> OvermindDL1 <<a href="mailto:overminddl1@gmail.com">overminddl1@gmail.com</a>> writes:<br>
>>><br>
>>>> Correction, even the zip by itself is too big, here is the 7z, if<br>
>>>> someone wants a giant zip, I can host it somewhere...<br>
>>><br>
>>> Please do.  7z is not supported on Linux.  I would love to take a look<br>
>>> at this, but I can't.  :(<br>
>><br>
>> 7z is supported just fine on Linux, I use it all the time, and it<br>
>> compresses text like that a heck of a lot better then zip (about a 4:1<br>
>> ratio).  But I will still put the zip up on my server, now at url:<br>
>>  <a href="http://www.overminddl1.com/stuff/llvm_doc.zip" target="_blank">http://www.overminddl1.com/stuff/llvm_doc.zip</a><br>
><br>
> Requiring people to get and install boost to work on docs is a non-starter.<br>
><br>
> What is wrong with sphinx?<br>
<br>
</div>They would not need to, as stated, it is simple to take what is needed<br>
thanks to bcp, only thing needed is docbook, which is a *lot* more<br>
prevalent than Sphinx and more well known.  The useful thing about<br>
quickbook over Sphinx is it is designed for C++ project documentation<br>
in a variety of formats, from html pages, single html document, pdf,<br>
man pages, straight docbook, etc...<br></blockquote><div><br></div><div>Just a random observation from the Python world: Once Sphinx started taking over as the dominant documentation tool, the quality of Python documentation greatly improved. This is not just because sphinx produces well formatted docs; it appears that the real driver behind the improvement is that writing docs with sphinx / ReST is pleasant and easy, so more people do it.</div>
<div><br>Keir</div><div><br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;">
<div><div></div><div class="h5"><br>
_______________________________________________<br>
LLVM Developers mailing list<br>
<a href="mailto:LLVMdev@cs.uiuc.edu">LLVMdev@cs.uiuc.edu</a>         <a href="http://llvm.cs.uiuc.edu" target="_blank">http://llvm.cs.uiuc.edu</a><br>
<a href="http://lists.cs.uiuc.edu/mailman/listinfo/llvmdev" target="_blank">http://lists.cs.uiuc.edu/mailman/listinfo/llvmdev</a><br>
</div></div></blockquote></div><br>