Path: csiph.com!goblin2!goblin.stu.neva.ru!aioe.org!bofh.it!news.nic.it!robomod
From: Emmanuel Bourg <ebourg@apache.org>
Newsgroups: linux.debian.maint.java
Subject: Re: libcommons-lang-java packaging?
Date: Tue, 27 Oct 2015 14:10:02 +0100
Message-ID: <qocaK-5BN-11@gated-at.bofh.it>
References: <qliZ4-613-15@gated-at.bofh.it> <qljBN-70Q-27@gated-at.bofh.it> <qlnYJ-56E-3@gated-at.bofh.it> <qloL8-64d-27@gated-at.bofh.it>
Old-Return-Path: <emmanuel.bourg@gmail.com>
Sender: robomod@news.nic.it
User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:38.0) Gecko/20100101 Thunderbird/38.3.0
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 8bit
Approved: robomod@news.nic.it
Lines: 143
Organization: linux.* mail to news gateway
Xref: csiph.com linux.debian.maint.java:8515

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