Sean Silva
2013-May-26 02:03 UTC
[LLVMdev] [cfe-dev] [3.3 Release] Release Candidate 2 Available
On Sat, May 25, 2013 at 1:52 PM, Renato Golin <renato.golin at linaro.org>wrote:> On 25 May 2013 20:42, Sean Silva <silvas at purdue.edu> wrote: > >> Could you please incorporate this useful document into LLVM's official >> documentation? I think that this is good content for encouraging greater >> external/downstream involvement in the release process. See >> docs/SphinxQuickstartTemplate.rst to get up and running fast. >> > > I sure can. I thought there was already a doc on that at LLVM about that. > If there is, would be good to start there. > >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). -- Sean Silva -------------- next part -------------- An HTML attachment was scrubbed... URL: <http://lists.llvm.org/pipermail/llvm-dev/attachments/20130525/ef64f761/attachment.html>
Renato Golin
2013-May-26 11:57 UTC
[LLVMdev] [cfe-dev] [3.3 Release] Release Candidate 2 Available
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? cheers, --renato -------------- next part -------------- An HTML attachment was scrubbed... URL: <http://lists.llvm.org/pipermail/llvm-dev/attachments/20130526/dbbdeb4c/attachment.html>
Sean Silva
2013-May-27 23:50 UTC
[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>
Apparently Analagous Threads
- [LLVMdev] [cfe-dev] [3.3 Release] Release Candidate 2 Available
- [LLVMdev] [cfe-dev] [3.3 Release] Release Candidate 2 Available
- [LLVMdev] [cfe-dev] [3.3 Release] Release Candidate 2 Available
- Updating release docs and minimal tools
- [xiph-wiki] ReleaseProcess