Le 19/10/2015 21:36, Benedikt Ritter a écrit :
> One thing I'd like to work on, is taking care that all Commons Components
> can be build with Maven at the Debian project. So some pointers on how that
> works would be really appreciated.
Benedikt, Sergio,
Thank you very much for offering your help. I've compiled a quick start
guide to work on the Debian packages. Let me know if you have any
question. You can also get some help on IRC (#debian-java on OFTC).
For switching to Maven I recommend using the commons-math3 package as a
reference (you can find more examples with "build-rdeps
maven-debian-helper").
Emmanuel Bourg
--------
Part I - Install your development environment
1. Download the minimal ISO (netinst) for installing Debian:
http://cdimage.debian.org/debian-cd/current/amd64/iso-cd/
2. Install it (on a spare box, or in a virtual machine)
3. Upgrade to the testing distribution
Edit /etc/apt/sources.list and replace stable with testing
Run:
apt-get update
apt-get dist-upgrade
4. Upgrade to the unstable distribution (same procedure)
5. Install the development tools:
apt-get install build-essential svn-buildpackage git-buildpackage
quilt default-jdk gnupg-agent topgit
6. Edit ~/.profile and add your name and your email:
export MAIL=johndoe@example.org
export DEBFULLNAME="John Doe"
7. Create or import a SSH key
8. Create the file ~/.quiltrc and add:
QUILT_PATCHES=debian/patches
QUILT_NO_DIFF_INDEX=1
QUILT_NO_DIFF_TIMESTAMPS=1
QUILT_REFRESH_ARGS="-p ab"
9. Create the file ~/.lintianrc and add:
color = always
pedantic = yes
display-experimental = yes
display-info = yes
10. Create the file ~/.devscripts and add:
DEBCHECKOUT_SOURCE=always
11. Create an account on http://alioth.debian.org, and upload your SSH
public key there.
12. Join the Java Team on alioth:
https://alioth.debian.org/project/request.php?group_id=30085
Part II - Update a package
1. Checkout the package:
debcheckout --auth <packagename>
2. Install the build dependencies
sudo apt-get build-deps <packagename>
3. Modify the package
4. Update the debian/changelog file with:
dch --team
5. Rebuild the package:
debuild
6. Commit your changes (with svn commit or git commit, git push), one
commit per modification preferably, instead of a one big commit.
7. When the package is ready, notify the debian-java list about the
changes you made. A Debian Developer will review them and upload the
package.
8. Celebrate your first package update! :)
Tips and tricks
- Finding a package containing a specific file:
apt-file find <filename>
- Finding a package containing a Maven artifact:
apt-file find <artifactId> | grep pom
- Inspecting the content of a .deb file:
dpkg -c foo.deb
- Inspecting the metadata of a .deb file:
dpkg -I foo.deb
- Displaying the reverse dependencies of a package:
build-rdeps <package>
apt-cache showpkg <package>
Ressources
Quilt for Debian Maintainers
http://pkg-perl.alioth.debian.org/howto/quilt.html
Using Quilt
http://wiki.debian.org/UsingQuilt
Maintainer Dashboard (pkg-java)
http://udd.debian.org/dmd.cgi?email1=pkg-java-maintainers%40lists.alioth.debian.org
Guidelines for Packages Maintained on git.debian.org:/git/pkg-java
http://wiki.debian.org/Java/JavaGit