DESCRIPTION
- This page documents how to distribute your changes to
+ This page documents how to distribute your changes to
GNU lilypond
ABSTRACT
- We would like to have unified context diffs with full
-pathnames. A script automating supplied with Lily. Dis-
+ We would like to have unified context diffs with full
+pathnames. A script automating supplied with Lily. Dis-
tributing a change normally goes like this:
o make your fix/add your code
-o Add changes to NEWS, and add yourself to Documenta-
- tion/AUTHORS.yo
+o Add changes to NEWS, and add yourself to Documenta-
+ tion/topdocs/AUTHORS.yo
o generate a patch,
-o e-mail your patch to one of the mailing lists gnu-
+o e-mail your patch to one of the mailing lists gnu-
music-discuss@gnu.org or bug-gnu-music@gnu.org
GENERATING A PATCH
make dist
make diff
-which rolls the tarball ../releases/lilypond-0.1.73.tar.gz
-and leaves your patch as ./lilypond-0.1.73.jcn1.diff. [1]
-We assume that there is a tarball lilypond-0.1.73.tar.gz in
+which rolls the tarball ../releases/lilypond-0.1.73.tar.gz
+and leaves your patch as ./lilypond-0.1.73.jcn1.diff. [1]
+We assume that there is a tarball lilypond-0.1.73.tar.gz in
the directory ../releases.
If you didn't configure Lily using --srcdir, you can do:
For creating a patch you need
-o All items mentioned in INSTALL. You're not going to
+o All items mentioned in INSTALL. You're not going to
send a patch that you haven't even built, right?
o GNU diff
-o Python (version 1.5 or newer). You can of course make
+o Python (version 1.5 or newer). You can of course make
a patch by hand, which would go something like:
-----------
cd ..
diff -urN lilypond-0.1.73 lilypond-0.1.73.jcn1 > lilypond-0.1.73.jcn1
- but there are handy python scripts available. If
- you're doing development, you'll need Python for other
+ but there are handy python scripts available. If
+ you're doing development, you'll need Python for other
LilyPond scripts anyway.
o The Lily directory structure, which looks like:
yodl -> yodl-1.30.17
yodl-1.30.17
- with prefix $HOME/usr/src and (for building rpms only)
+ with prefix $HOME/usr/src and (for building rpms only)
in $HOME/.rpmrc:
topdir: /home/fred/usr/src/RedHat
APPLYING PATCHES
-If you're following LilyPond development regularly, you
+If you're following LilyPond development regularly, you
probably want to download just the patch for each subsequent
-release. After downloading the patch (into the patches
+release. After downloading the patch (into the patches
directory, of course), simply apply it:
gzip -dc ../patches/lilypond-0.1.74.diff.gz | patch -p1 -E
SYNCHRONISE
-If you're not very quick with sending your patch, there's a
+If you're not very quick with sending your patch, there's a
good chance that an new release of LilyPond comes available.
In such a case, the maintainer will probably ask you to make
a new patch against the latest release. Your best bet is to
-download the latest release, and apply your patch against
+download the latest release, and apply your patch against
this new source tree:
cd lilypond-0.1.74