llvm dev - May 2013 - [LLVMdev] [cfe-dev] [3.3 Release] Release Candidate 2 Available

On Sun, May 26, 2013 at 5:57 AM, Renato Golin <renato.golin at
linaro.org>wrote:
> On 26 May 2013 03:03, Sean Silva <silvas at purdue.edu> wrote:
>
>> AFAIK, the closest we have is
<http://llvm.org/docs/HowToReleaseLLVM.html>,
>> 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).
>>
>
> Hi Sean,
>
> I've created ReleaseProcess.rst, how can I force generation of HTML on
the
> rst file without rebuilding the whole thing?
>
>
The following incantation should work (invoked from docs/):

sphinx-build -b html -d _build/doctrees . _build/html $BUILD_THIS.rst

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).

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.

-- Sean Silva
-------------- next part --------------
An HTML attachment was scrubbed...
URL:
<http://lists.llvm.org/pipermail/llvm-dev/attachments/20130527/d43f1b89/attachment.html>

Thanks Sean,

Got in r182759, feel free to add/remove/fix whatever you think it's
appropriate.

cheers,
--renato


On 28 May 2013 00:50, Sean Silva <silvas at purdue.edu> wrote:
>
>
>
> On Sun, May 26, 2013 at 5:57 AM, Renato Golin <renato.golin at
linaro.org>wrote:
>
>> On 26 May 2013 03:03, Sean Silva <silvas at purdue.edu> wrote:
>>
>>> AFAIK, the closest we have is <
>>> http://llvm.org/docs/HowToReleaseLLVM.html>, 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).
>>>
>>
>> Hi Sean,
>>
>> I've created ReleaseProcess.rst, how can I force generation of HTML
on
>> the rst file without rebuilding the whole thing?
>>
>>
> The following incantation should work (invoked from docs/):
>
> sphinx-build -b html -d _build/doctrees . _build/html $BUILD_THIS.rst
>
> 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).
>
> 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.
>
> -- Sean Silva
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL:
<http://lists.llvm.org/pipermail/llvm-dev/attachments/20130528/81f588e1/attachment.html>

On Tue, May 28, 2013 at 2:50 AM, Renato Golin <renato.golin at
linaro.org>wrote:
> Thanks Sean,
>
> Got in r182759, feel free to add/remove/fix whatever you think it's
> appropriate.
>
>
Thanks!

-- Sean Silva
-------------- next part --------------
An HTML attachment was scrubbed...
URL:
<http://lists.llvm.org/pipermail/llvm-dev/attachments/20130528/8e275b7b/attachment.html>