<html><head><meta http-equiv="Content-Type" content="text/html charset=utf-8"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class=""><br class=""><div><blockquote type="cite" class=""><div class="">On 7 Apr 2017, at 11:10, Brian Cain via llvm-dev <<a href="mailto:llvm-dev@lists.llvm.org" class="">llvm-dev@lists.llvm.org</a>> wrote:</div><br class="Apple-interchange-newline"><div class=""><div dir="ltr" style="font-family: Verdana; font-size: 14px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px;" class=""><div class="gmail_extra"><br class="Apple-interchange-newline"><br class=""><div class="gmail_quote">On Thu, Apr 6, 2017 at 6:17 PM, Tanya Lattner via llvm-dev<span class="Apple-converted-space"> </span><span dir="ltr" class=""><<a href="mailto:llvm-dev@lists.llvm.org" target="_blank" class="">llvm-dev@lists.llvm.org</a>></span><span class="Apple-converted-space"> </span>wrote:<br class=""><blockquote class="gmail_quote" style="margin: 0px 0px 0px 0.8ex; border-left-width: 1px; border-left-style: solid; border-left-color: rgb(204, 204, 204); padding-left: 1ex;"><span class="gmail-"><br class="">> On Apr 6, 2017, at 2:52 AM, Renato Golin <<a href="mailto:renato.golin@linaro.org" class="">renato.golin@linaro.org</a>> wrote:<br class="">><br class="">> On 6 April 2017 at 05:49, Dean Michael Berris <<a href="mailto:dean.berris@gmail.com" class="">dean.berris@gmail.com</a>> wrote:<br class="">>> I'll have a look if I can untangle that.<br class="">>><br class="">>> Thanks Renato!<br class="">><br class="">> Well, that didn't last long. Now I remember why last time I fixed<br class="">> hundreds of warnings on the docs directly instead of fixing the<br class="">> server...<br class="">><br class="">><br class="">>> Has anybody looked into potentially getting the LLVM docs hosted on<br class="">>><span class="Apple-converted-space"> </span><a href="http://readthedocs.org/" rel="noreferrer" target="_blank" class="">readthedocs.org</a><span class="Apple-converted-space"> </span>and automatically built from the LLVM Git mirror (or through<br class="">>> Subversion post-commit hooks)? Since we're already using Sphinx, this seems<br class="">>> like a low-cost, low-interference way of hosting the generated<br class="">>> documentation.<br class="">><br class="">> This is actually a very good idea. I'll let Tanya and Anton further<br class="">> comment on that from a foundation's point of view.<br class=""><br class=""></span>The docs are built via SVN post-commit hook, but thats not the bigger issue in my opinion. I don’t know enough about<span class="Apple-converted-space"> </span><a href="http://readthedocs.org/" rel="noreferrer" target="_blank" class="">readthedocs.org</a><span class="Apple-converted-space"> </span>but if someone has a lot of experience.. perhaps they could summarize pros and cons of using it?<br class=""><br class="">I’m not opposed to change just need to understand it. I’m actually going to be handing off most of this stuff as soon as I can write the email to the list (sorry its Spring Break here in the US so my time is limited this week). I have someone who is going to help with sys admin on<span class="Apple-converted-space"> </span><a href="http://llvm.org/" rel="noreferrer" target="_blank" class="">llvm.org</a><span class="Apple-converted-space"> </span>and head things up in that area but ideally its a team of people.<br class=""><br class=""></blockquote><div class=""><br class=""></div><div class="">I don't know the answers re: pros/cons, I've never built anything with readthedocs before. But I was curious about how hard it is to setup so I gave it a whirl. The answer appears to be: not very hard at all. I added a two-line YAML config file but from the docs I read it seems like it was a superfluous step. Most of the work was clicking a handful of buttons on github and readthedocs' websites.</div><div class=""><div class=""><br class="gmail-Apple-interchange-newline"></div></div></div></div><blockquote style="margin: 0px 0px 0px 40px; border: none; padding: 0px;" class=""><div class="gmail_extra"><div class="gmail_quote"><div class=""><div class=""><a href="https://llvm.readthedocs.io/en/latest/" class="">https://llvm.readthedocs.io/en/latest/</a></div></div></div></div></blockquote><div class="gmail_extra"><div class="gmail_quote"><div class=""><div class=""><br class=""></div><div class="">Apologies for squatting on the project name, I thought the url would be qualified by my username. I'll see how I can get it changed to move out of the way for the LLVM project.</div></div><div class=""><br class=""></div><div class="">I did a spot check of several pages and couldn't find obvious missing/invalid parts of the docs. This is just llvm and not clang nor any other project, though.</div><div class=""><br class=""></div></div></div><blockquote style="margin: 0px 0px 0px 40px; border: none; padding: 0px;" class=""><div class="gmail_extra"><div class="gmail_quote"><div class=""><a href="https://llvm.readthedocs.io/en/latest/GoldPlugin.html" class="">https://llvm.readthedocs.io/en/latest/GoldPlugin.html</a></div></div></div></blockquote><blockquote style="margin: 0px 0px 0px 40px; border: none; padding: 0px;" class=""><div class="gmail_extra"><div class="gmail_quote"><div class=""><a href="https://llvm.readthedocs.io/en/latest/WritingAnLLVMPass.html" class="">https://llvm.readthedocs.io/en/latest/WritingAnLLVMPass.html</a></div></div></div></blockquote><blockquote style="margin: 0px 0px 0px 40px; border: none; padding: 0px;" class=""><div class="gmail_extra"><div class="gmail_quote"><div class=""><a href="https://llvm.readthedocs.io/en/latest/HowToCrossCompileLLVM.html" class="">https://llvm.readthedocs.io/en/latest/HowToCrossCompileLLVM.html</a></div></div></div></blockquote><div class="gmail_extra"><div class="gmail_quote"><div class=""><br class=""></div><div class="">Even search works:</div></div></div><blockquote style="margin: 0px 0px 0px 40px; border: none; padding: 0px;" class=""><div class="gmail_extra"><div class="gmail_quote"><div class=""><a href="https://llvm.readthedocs.io/en/latest/search.html?q=bitcode" class="">https://llvm.readthedocs.io/en/latest/search.html?q=bitcode</a></div></div></div></blockquote><div class="gmail_extra"><div class="gmail_quote"><div class=""><br class=""></div></div></div></div></div></blockquote><div><br class=""></div><div>You beat me to it Brian, thank you for giving this a go!</div><div><br class=""></div><div>/me just happy to see <a href="https://llvm.readthedocs.io/en/latest/XRayExample.html" class="">https://llvm.readthedocs.io/en/latest/XRayExample.html</a> working out just fine. :)</div></div><br class=""><div class="">
<div style="color: rgb(0, 0, 0); letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class=""><div style="color: rgb(0, 0, 0); letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class="">-- Dean</div></div>
</div>
<br class=""></body></html>