README

TL;DR
=====

vim lucid/genome-snapshot-deps-perl.depends
git commit
make all # manual build to test
sudo dpkg -i build/*.deb
git push

How to Add New Dependencies
===========================

- Add the dependency to the appropriate meta-package list in the distro directory, e.g. genome-snapshot-deps-perl.depends.
    vim lucid/genome-snapshot-deps-perl.depends

- Test the meta-package before committing and pushing (mostly in case of typos):
    make all
    sudo dpkg -i build/*.deb

- Commit your changes.
    git commit -m 'added libfoo-bar-perl (Foo::Bar) to genome-snapshot-deps perl (depends)'

- Push and issue pull request.
    git push
    hub pull-request

- Jenkins will first build a new genome-snapshot-deps* (https://apipe-ci.gsc.wustl.edu/view/Genome%20Packaging/job/genome-snapshot-deps-lucid/).
- If that succeeds it will the queue those package for our private repo (https://apipe-ci.gsc.wustl.edu/view/Genome%20Packaging/job/6_Publish_Debs_to_Private_Apt/).

How to Build
============

The packages are automatically built and pushed by Jenkins.
If you want to build manually all you have to do is run `make all` this will generate the *N* debs and a changes file in the `build` subdirectory.

How to Add New Meta-packages
============================

- Make a new dependency list with the meta-package's name in the distro directory.
- Add a case in bin/build-control similar to the existing ones but change the Depends or Description as needed.
- Add that new meta-package as a dependency of genome-snapshot-deps in bin/build-control.

How to Add a New Distro
=======================

You should only need to make a new distro if the are dependency differences between them. We may want to re-evaluate how to do this in the case of multiple distros.

- Add a case in bin/build-control to use your distro's debhelper version.
- For convenience, setup a rule in the Makefile. See the lucid rule.