LilyPond Contributor's Guide: 3.2.3 Other repositories

[ << Working with source code ]	[Top][Contents][Index][ ? ]			[ Compiling >> ]
[ < Git for the impatient ]		[ Up : Starting with Git ]	[ lilypond-extra > ]

3.2.3 Other repositories

We have a few other code repositories.

[ << Working with source code ]	[Top][Contents][Index][ ? ]			[ Compiling >> ]
[ < Other repositories ]		[ Up : Other repositories ]	[ Grand Unified Builder (GUB) > ]

lilypond-extra

There is a separate repository for general administrative scripts, as well as pictures and media files for the website. People interested in working on the website should download this repository, and set their $LILYPOND_WEB_MEDIA_GIT environment variable to point to that repository.

https://github.com/gperciva/lilypond-extra

To configure an environment variable in bash (the default for most GNU/Linux distributions),

export LILYPOND_WEB_MEDIA_GIT=$HOME/dir/of/lilypond-extra/

Be aware that lilypond-extra is the definitive source for some binary files - in particular PDF versions of papers concerning LilyPond. To add further PDFs of this sort, all that is necessary is to add the PDF to lilypond-extra and then add a reference to it in the documentation. The file will then be copied to the website when make website is run.

However, pictures that are also used in the documentation build are mastered in the main git repository. If any of these is changed, it should be updated in git, and then the updates copied to lilypond-extra.

[ << Working with source code ]	[Top][Contents][Index][ ? ]			[ Compiling >> ]
[ < lilypond-extra ]		[ Up : Other repositories ]	[ LilyPad > ]

Grand Unified Builder (GUB)

Another item of interest might be the Grand Unified Builder, our cross-platform building tool. Since it is used by other projects as well, it is not stored in our gub repository. For more info, see http://lilypond.org/gub.

There are two locations for this repository: the version being used to build lilypond, which is at

http://github.com/gperciva/gub

and the original version by Jan Nieuwenhuizen, kept at

http://github.com/janneke/gub

[ << Working with source code ]	[Top][Contents][Index][ ? ]			[ Compiling >> ]
[ < Grand Unified Builder (GUB) ]		[ Up : Other repositories ]	[ yet more repositories > ]

LilyPad

Our binary releases on MacOS X and Windows contain a lightweight text editor.

To make any modifications the Windows editor, you will need to do the following:

Clone the git repository from https://github.com/gperciva/lilypad
Make changes to the source, and check it compiles. In a Windows environment MinGW provides both a Git installation and a gcc compiler. This can be obtained from http://www.mingw.org/
Update the version which is contained in the ‘rsrc.rc’. Check this compiles, too.
Commit the changes with an informative commit message.
Push the changes to github. You will need to use syntax similiar to this:
```
git push https://UserName@github.com/gperciva/lilypad.git
```
You will need to have push access to the git repository for this to be successful.
Make a tarball of the source code to be used by GUB by pulling the updated repository from GitHub. Ensure that the tarball has the correct Version number.
Copy the tarball to http://lilypond.org/downloads/gub-sources/lilypad/. You will need to have SSH access to lilypond.org. If you do not, contact the Release Manager via the lilypond-devel mailing list.
Update GUB to make it use the new tarball by editing ‘gub/specs/lilypad.py’ and changing the source = line to point to the new source.
Push this updated ‘lilypad.py’ version to the GUB repository on GitHub.
Test the changes with a new GUB compile.

[ << Working with source code ]	[Top][Contents][Index][ ? ]			[ Compiling >> ]
[ < LilyPad ]		[ Up : Other repositories ]	[ Downloading remote branches > ]

yet more repositories

There are a few other repositories floating around, which will hopefully be documented in the near future.

[ << Working with source code ]	[Top][Contents][Index][ ? ]			[ Compiling >> ]
[ < LilyPad ]		[ Up : Other repositories ]	[ Downloading remote branches > ]

3.2.3 Other repositories

lilypond-extra

Grand Unified Builder (GUB)

LilyPad

yet more repositories

LilyPond — Contributor’s Guide v2.21.0 (development-branch).