<div dir="ltr"><br><div class="gmail_extra"><br><br><div class="gmail_quote">On Sun, May 26, 2013 at 5:57 AM, Renato Golin <span dir="ltr"><<a href="mailto:renato.golin@linaro.org" target="_blank">renato.golin@linaro.org</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div dir="ltr"><div class="im">On 26 May 2013 03:03, Sean Silva <span dir="ltr"><<a href="mailto:silvas@purdue.edu" target="_blank">silvas@purdue.edu</a>></span> wrote:<br>
</div><div class="gmail_extra"><div class="gmail_quote"><div class="im"><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
<div dir="ltr">AFAIK, the closest we have is <<a href="http://llvm.org/docs/HowToReleaseLLVM.html" target="_blank">http://llvm.org/docs/HowToReleaseLLVM.html</a>>, which details basically what the release manager has to do (i.e., the audience is LLVM developers, and release managers in particular). I really liked the article you linked because it seemed to be targeted at an audience of external developers and packagers, for whom we don't (AFAIK) really have any docs about the release process, how to get involved, etc. Since the audience is different, I think it should be its own page (probably "ReleaseProcess.rst" would be fine, but I don't have a strong preference).<br>
</div></blockquote><div><br></div></div><div>Hi Sean,</div><div><br></div><div>I've created ReleaseProcess.rst, how can I force generation of HTML on the rst file without rebuilding the whole thing?</div><div><br></div>
</div></div></div></blockquote><div><br></div><div style>The following incantation should work (invoked from docs/):</div><div style><br></div><div style>sphinx-build -b html -d _build/doctrees . _build/html $BUILD_THIS.rst<br>
</div><div style><br></div><div style>Basically, this is the command that the makefile executes by default, with $BUILD_THIS.rst appended. Trailing filenames given to sphinx-build are interpreted to mean that it should build just those; if given no filenames (as when invoked by the Makefile), it defaults to building all of them (it automatically tracks file modification times and does incremental rebuilds, though).</div>
<div style><br></div><div style>Note that partial rebuilds may cause Sphinx to not be able to resolve all inter-document link references if it doesn't have the link targets cached from a previous full rebuild.</div><div style>
<br></div><div style>-- Sean Silva</div></div></div></div>