X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fcontributor%2Frelease-work.itexi;h=cc05df8c65a576dac5c4a97b1e9dc4d9e16f5cc4;hb=22855043fa1b13262cf1c2a0def27ae9afec6d69;hp=aa918760adb8282c5f2ba7c9fd5d862c1a690c93;hpb=27ddce04fc8db52eeb181464de26a86a3bef91a1;p=lilypond.git diff --git a/Documentation/contributor/release-work.itexi b/Documentation/contributor/release-work.itexi index aa918760ad..cc05df8c65 100644 --- a/Documentation/contributor/release-work.itexi +++ b/Documentation/contributor/release-work.itexi @@ -74,6 +74,10 @@ A @qq{minor release} means an update of @code{y} in @code{2.x.y}. @enumerate +@item +Don't forget to prepare the GUB build machine by deleting and moving unneeded +files: see @qq{Subsequent builds} in @ref{Notes on builds with GUB}. + @item Using any system with git pull access (not necessarily the GUB build machine), use the commands below to do the following: @@ -104,7 +108,7 @@ VERSION_STABLE = the current stable version (probably no change here) @end itemize @item -update the @qq{Welcome to Lilypond} version numbers to the version about to be +update the @qq{Welcome to LilyPond} version numbers to the version about to be released @end itemize @@ -127,11 +131,31 @@ git checkout release/unstable git merge origin/master make -C $LILYPOND_BUILD_DIR po-replace mv $LILYPOND_BUILD_DIR/po/lilypond.pot po/ -gedit Documentation/web/news-front.itexi Documentation/web/news.itexi +gedit Documentation/web/news-new.itexi Documentation/web/news-old.itexi +gedit Documentation/web/news-headlines.itexi gedit VERSION gedit ly/Wel*.ly @end example +Editing the @file{news-headlines.itexi} file is a bit tricky, since it contains +URLs with escaped characters. An example of what is needed is that releasing +@code{2.19.50} after the release of @code{2.19.49} needed the line: + +@example +@@uref@{news.html#LilyPond-2_002e19_002e49-released-October-16_002c-2016, + LilyPond 2.19.49 released - @@emph@{October 16, 2016@}@} +@end example + +to be changed to: + +@example +@@uref@{news.html#LilyPond-2_002e19_002e50-released-November-6_002c-2016, + LilyPond 2.19.50 released - @@emph@{November 6, 2016@}@} +@end example + +Don't forget to update the entry above that line to show the latest release +version. + @item Commit, push, switch back to master (or wherever else): @@ -584,7 +608,7 @@ to continue uninterrupted. Download GUB and start the set up: @example -git clone git://github.com/gperciva/gub/gub.git +git clone git://github.com/gperciva/gub.git cd gub make bootstrap @end example @@ -608,11 +632,11 @@ Download the test output from lilypond.org (you will need to replace @code{2.15.33-1} with the latest build): @smallexample -@uref{http://lilypond.org/download/binaries/test-output/lilypond-2.15.33-1.test-output.tar.bz2} +@uref{http://lilypond.org/downloads/binaries/test-output/lilypond-2.15.33-1.test-output.tar.bz2} @end smallexample -Copy the tarball into @file{gub/regtests/}, and tell the build -system that you have done this: +Copy the tarball into @file{regtests/}, and tell the build system that +you have done this: @example touch regtests/ignore @@ -714,7 +738,7 @@ pulls git master to the web server, and the other makes the website with the standard @code{make website} command. They run hourly, 30 minutes apart. So - to update the front page of the website, it's necessary to update @code{VERSION} and -@code{news-front.itexi} in master and then wait for the cron +@code{news-headlines.itexi} in master and then wait for the cron jobs to run. (N.B. - this is done by pushing the changes to staging and letting patchy do its checks before it pushes to master).