[Git][java-team/maven-repo-helper][master] trim obsolete CDBS documentation
Alexandre Detiste (@detiste-guest)
gitlab at salsa.debian.org
Thu Sep 4 17:11:34 BST 2025
Alexandre Detiste pushed to branch master at Debian Java Maintainers / maven-repo-helper
Commits:
1f3a0cef by Alexandre Detiste at 2025-09-04T18:09:24+02:00
trim obsolete CDBS documentation
- - - - -
3 changed files:
- debian/changelog
- doc/tutorial.rst
- doc/tutorial.txt
Changes:
=====================================
debian/changelog
=====================================
@@ -1,3 +1,12 @@
+maven-repo-helper (1.12) unstable; urgency=medium
+
+ * Team upload.
+ * Remove CDBS from tutorial, /usr/share/cdbs/1/class/ant.mk is gone
+ (Closes: #1099949)
+ * Bump Standards-Version to 4.7.2
+
+ -- Alexandre Detiste <tchet at debian.org> Thu, 04 Sep 2025 18:07:30 +0200
+
maven-repo-helper (1.11) unstable; urgency=medium
* Provide dh-sequence-maven-repo-helper (Closes: #985651)
=====================================
doc/tutorial.rst
=====================================
@@ -42,9 +42,8 @@ library, including libraries used by Maven itself. It provides the
foundations for maven-debian-helper. Its goal is to manage the
/usr/share/maven-repo folder properly, and cannot be used alone to build
a Java library from source. You will normally use it either with Ant
-(started by a cdbs rule or dh 7 rule or anything you like), or with
-javahelper which will take care of building the binaries for your
-project.
+(started by a dh 7 rule or anything you like), or with javahelper
+which will take care of building the binaries for your project.
**Important:** If you want your build to use Maven itself, then run
mh\_make from the maven-debian-helper package on the upstream sources.
@@ -325,166 +324,6 @@ libhttpunit-java.poms:
Create a link for the jar /usr/share/java/httpunit.jar into the Maven
repository and use debian/pom.xml as its companion metadata file
-CDBS + maven-repo-helper using mh\_install
-------------------------------------------
-
-debian/control:
-
-::
-
- Source: maven-debian-helper
- Section: java
- Priority: optional
- Maintainer: Debian Java Maintainers <pkg-java-maintainers at lists.alioth.debian.org>
- Uploaders: Torsten Werner <twerner at debian.org>, Ludovic Claude <ludovic.claude at laposte.net>,
- Michael Koch <konqueror at gmx.de>, Damien Raude-Morvan <drazzib at debian.org>
- Build-Depends: cdbs, debhelper (>= 7), default-jdk, maven-ant-helper (>= 7), maven-repo-helper (>= 1.7), ant-optional, help2man
- Build-Depends-Indep: junit, libmaven-plugin-tools-java, libplexus-velocity-java
- Standards-Version: 3.9.2
- Vcs-Svn: svn://svn.debian.org/svn/pkg-java/trunk/maven-debian-helper
- Vcs-Browser: http://svn.debian.org/wsvn/pkg-java/trunk/maven-debian-helper/
- Homepage: http://wiki.debian.org/Java/MavenBuilder
-
- Package: maven-debian-helper
- Architecture: all
- Depends: ${misc:Depends}, default-jdk, maven-repo-helper (>= 1.5), maven2 (>= 2.2.1-5),
- libmaven-clean-plugin-java, libmaven-resources-plugin-java,
- libmaven-compiler-plugin-java, libmaven-jar-plugin-java, libmaven-site-plugin-java,
- libsurefire-java, velocity, libplexus-velocity-java
- Suggests: libmaven-javadoc-plugin-java, apt-file, devscripts, subversion
- Description: Helper tools for building Debian packages with Maven
- [...]
-
-Note the Build-Depends on cdbs and maven-repo-helper. maven-ant-helper
-and ant-optional are also needed for this package, as it's quite complex
-but this is not important for this tutorial.
-
-debian/rules:
-
-::
-
- #!/usr/bin/make -f
- include /usr/share/cdbs/1/rules/debhelper.mk
- include /usr/share/cdbs/1/class/ant.mk
-
- PACKAGE := $(DEB_SOURCE_PACKAGE)
- VERSION := $(shell echo ${DEB_UPSTREAM_VERSION} | sed -r 's/([0-9\.]+).*/\1/')
- JAVA_HOME := /usr/lib/jvm/default-java
- DEB_JARS := ant-nodeps classworlds maven-core maven-artifact maven-artifact-manager maven-model \
- maven-compat maven-plugin-api maven-project maven-scm-api velocity file-management plexus-utils \
- plexus-container-default-alpha maven-repo-helper
- DEB_ANT_BUILD_TARGET := package
- DEB_ANT_BUILDFILE := debian/build.xml
- DEB_ANT_ARGS := -Dpackage=$(PACKAGE) -Dbin.package=$(PACKAGE)
- API_DOCS := target/api
-
- install/$(PACKAGE)::
- mh_install -p$(PACKAGE)
-
- clean::
- mh_clean
-
-This is a simplified version of debian/rules, which shows how to use the
-mh\_install and mh\_clean scripts from maven-repo-helper with CDBS and
-Ant. mh\_install performs the installation of the built jars into
-/usr/share/maven-repo and /usr/share/java. It uses the configuration
-defined in maven-debian-helper.poms. mh\_clean does the clean up of
-files left behind during the execution of mh\_install.
-
-maven-debian-helper.poms:
-
-::
-
- pom.xml --no-parent --has-package-version
- maven-debian-helper/pom.xml --has-package-version --artifact=maven-debian-helper/target/maven-debian-helper-*.jar --java-lib
- maven-debian-plugin/pom.xml --has-package-version --artifact=maven-debian-plugin/target/maven-debian-plugin-*.jar --java-lib
- maven-build-nodocs/pom.xml --has-package-version --artifact=maven-build-nodocs/target/maven-build-nodocs-*.jar --java-lib
- maven-packager-utils/pom.xml --has-package-version --artifact=maven-packager-utils/target/maven-packager-utils-*.jar --java-lib
-
-Here we tell mh\_install to deploy the maven-debian-helper project and
-its sub projects into /usr/share/maven-repo, and to deploy all jars also
-into /usr/share/java (--java-lib option)
-
-CDBS + maven-repo-helper using mh\_installpoms and mh\_installjar
------------------------------------------------------------------
-
-debian/control:
-
-::
-
- Source: plexus-io
- Section: java
- Priority: optional
- Maintainer: Debian Java Maintainers <pkg-java-maintainers at lists.alioth.debian.org>
- Uploaders: Torsten Werner <twerner at debian.org>, Ludovic Claude <ludovic.claude at laposte.net>
- Build-Depends: debhelper (>= 5), cdbs (>= 0.4.5.3), default-jdk
- Build-Depends-Indep: maven-repo-helper (>= 1.7), maven-ant-helper (>= 7), ant, ant-optional,
- libplexus-utils-java, libplexus-containers-java
- Standards-Version: 3.8.1
- Vcs-Svn: svn://svn.debian.org/svn/pkg-java/trunk/plexus-io
- Vcs-Browser: http://svn.debian.org/wsvn/pkg-java/trunk/plexus-io/
- Homepage: http://plexus.codehaus.org/plexus-components/plexus-io/
-
- Package: libplexus-io-java
- Architecture: all
- Depends: ${misc:Depends}, libplexus-utils-java, libplexus-containers-java
- Description: Plexus IO Components
- [...]
-
-Note the Build-Depends on cdbs and maven-repo-helper.
-
-debian/rules:
-
-::
-
- #!/usr/bin/make -f
- include /usr/share/cdbs/1/rules/debhelper.mk
- include /usr/share/cdbs/1/class/ant.mk
-
- PACKAGE := $(DEB_SOURCE_PACKAGE)
- VERSION := $(DEB_UPSTREAM_VERSION)
- JAVA_HOME := /usr/lib/jvm/default-java
- DEB_JARS := ant-nodeps plexus-utils plexus-container-default
- DEB_ANT_BUILD_TARGET := package #javadoc
- DEB_ANT_BUILDFILE := /usr/share/maven-ant-helper/maven-build.xml
- DEB_ANT_ARGS := -Dbasedir=$(realpath .) -Dpackage=$(PACKAGE) -Dversion=$(VERSION)
- API_DOCS := build/api
-
- binary-post-install/lib$(PACKAGE)-java::
- mh_installpoms -plib$(PACKAGE)-java
- mh_installjar -plib$(PACKAGE)-java -l pom.xml build/$(PACKAGE)-$(VERSION).jar
-
- clean::
- mh_clean
-
-No patches for the POM files are needed, all is taken care of by the
-mh\_installpom script (which uses mh\_cleanpom)
-
-mh\_installpoms will install all POM files registered in
-debian/lib$package-java.pom into /usr/share/maven-repo,
-
-mh\_installjar will install the jar file associated with the POM into
-/usr/share/maven-repo and also add a link to the jar in /usr/share/java,
-with and without the version
-
-debian/libplexus-io-java.pom
-
-::
-
- pom.xml --no-parent
-
-It simply lists the pom files in the source tree which need to be
-installed in the repository, and indicates with the --no-parent option
-that if the POM inherits from a parent POM, then this inheritance
-relationship will be removed in the cleaned POM. Removing the parent
-inheritence can often simplify the packaging, as the parent POM mostly
-does not contain any useful information - we need only the list of
-dependencies in our repository, the other details for the build are
-irrelevant.
-
-There is less configuration here because we are using the low-level
-mh\_installpoms and mh\_installjar scripts which place the configuration
-on their command line options.
Typical workflow for packaging a project from source
----------------------------------------------------
=====================================
doc/tutorial.txt
=====================================
@@ -13,7 +13,7 @@ The Debian policy mandates that Java libraries are installed in /usr/share/java,
The Maven repository maintained by Debian has some special characteristics which make it difficult to use directly upstream POM files without any changes. To allow a smooth upgrade of Java libraries, we create both native and Debian versions of the artifacts, and replace all versions in the dependencies with Debian versions - see the [repository specification](repository.html) document for more informations about this process. In addition, entries in the POM file which are not needed anymore, such as build information, are removed. mh\_make provides the scripts mh\_patchpom and mh\_cleanpom which patch dependencies versions and clean up the POM file respectively. Other scripts often make use of those two scripts to provide more advanced functionality.
-maven-repo-helper has no dependency on Maven, so it can be used for any library, including libraries used by Maven itself. It provides the foundations for maven-debian-helper. Its goal is to manage the /usr/share/maven-repo folder properly, and cannot be used alone to build a Java library from source. You will normally use it either with Ant (started by a cdbs rule or dh 7 rule or anything you like), or with javahelper which will take care of building the binaries for your project.
+maven-repo-helper has no dependency on Maven, so it can be used for any library, including libraries used by Maven itself. It provides the foundations for maven-debian-helper. Its goal is to manage the /usr/share/maven-repo folder properly, and cannot be used alone to build a Java library from source. You will normally use it either with Ant (started by ar dh 7 rule or anything you like), or with javahelper which will take care of building the binaries for your project.
**Important:** If you want your build to use Maven itself, then run mh\_make from the maven-debian-helper package on the upstream sources. mh\_make will guide you for that process and generate all necessary debian files for you.
You can also use mh\_make --ant to speed up the packaging of a project which uses Ant as the build tool and needs to install its artifacts into the Maven repository.
@@ -219,140 +219,6 @@ libhttpunit-java.poms:
Create a link for the jar /usr/share/java/httpunit.jar into the Maven repository
and use debian/pom.xml as its companion metadata file
-CDBS + maven-repo-helper using mh\_install
------------------------------------------
-
-debian/control:
-
- Source: maven-debian-helper
- Section: java
- Priority: optional
- Maintainer: Debian Java Maintainers <pkg-java-maintainers at lists.alioth.debian.org>
- Uploaders: Torsten Werner <twerner at debian.org>, Ludovic Claude <ludovic.claude at laposte.net>,
- Michael Koch <konqueror at gmx.de>, Damien Raude-Morvan <drazzib at debian.org>
- Build-Depends: cdbs, debhelper (>= 7), default-jdk, maven-ant-helper (>= 7), maven-repo-helper (>= 1.7), ant-optional, help2man
- Build-Depends-Indep: junit, libmaven-plugin-tools-java, libplexus-velocity-java
- Standards-Version: 3.9.2
- Vcs-Svn: svn://svn.debian.org/svn/pkg-java/trunk/maven-debian-helper
- Vcs-Browser: http://svn.debian.org/wsvn/pkg-java/trunk/maven-debian-helper/
- Homepage: http://wiki.debian.org/Java/MavenBuilder
-
- Package: maven-debian-helper
- Architecture: all
- Depends: ${misc:Depends}, default-jdk, maven-repo-helper (>= 1.5), maven2 (>= 2.2.1-5),
- libmaven-clean-plugin-java, libmaven-resources-plugin-java,
- libmaven-compiler-plugin-java, libmaven-jar-plugin-java, libmaven-site-plugin-java,
- libsurefire-java, velocity, libplexus-velocity-java
- Suggests: libmaven-javadoc-plugin-java, apt-file, devscripts, subversion
- Description: Helper tools for building Debian packages with Maven
- [...]
-
-Note the Build-Depends on cdbs and maven-repo-helper. maven-ant-helper and ant-optional are also needed for this package, as it's quite complex
-but this is not important for this tutorial.
-
-debian/rules:
-
- #!/usr/bin/make -f
- include /usr/share/cdbs/1/rules/debhelper.mk
- include /usr/share/cdbs/1/class/ant.mk
-
- PACKAGE := $(DEB_SOURCE_PACKAGE)
- VERSION := $(shell echo ${DEB_UPSTREAM_VERSION} | sed -r 's/([0-9\.]+).*/\1/')
- JAVA_HOME := /usr/lib/jvm/default-java
- DEB_JARS := ant-nodeps classworlds maven-core maven-artifact maven-artifact-manager maven-model \
- maven-compat maven-plugin-api maven-project maven-scm-api velocity file-management plexus-utils \
- plexus-container-default-alpha maven-repo-helper
- DEB_ANT_BUILD_TARGET := package
- DEB_ANT_BUILDFILE := debian/build.xml
- DEB_ANT_ARGS := -Dpackage=$(PACKAGE) -Dbin.package=$(PACKAGE)
- API_DOCS := target/api
-
- install/$(PACKAGE)::
- mh_install -p$(PACKAGE)
-
- clean::
- mh_clean
-
-This is a simplified version of debian/rules, which shows how to use the mh\_install and mh\_clean scripts from maven-repo-helper
-with CDBS and Ant.
-mh\_install performs the installation of the built jars into /usr/share/maven-repo and /usr/share/java. It uses the configuration defined
-in maven-debian-helper.poms.
-mh\_clean does the clean up of files left behind during the execution of mh\_install.
-
-maven-debian-helper.poms:
-
- pom.xml --no-parent --has-package-version
- maven-debian-helper/pom.xml --has-package-version --artifact=maven-debian-helper/target/maven-debian-helper-*.jar --java-lib
- maven-debian-plugin/pom.xml --has-package-version --artifact=maven-debian-plugin/target/maven-debian-plugin-*.jar --java-lib
- maven-build-nodocs/pom.xml --has-package-version --artifact=maven-build-nodocs/target/maven-build-nodocs-*.jar --java-lib
- maven-packager-utils/pom.xml --has-package-version --artifact=maven-packager-utils/target/maven-packager-utils-*.jar --java-lib
-
-Here we tell mh\_install to deploy the maven-debian-helper project and its sub projects into /usr/share/maven-repo,
-and to deploy all jars also into /usr/share/java (--java-lib option)
-
-CDBS + maven-repo-helper using mh\_installpoms and mh\_installjar
------------------------------------------------------------------
-
-debian/control:
-
- Source: plexus-io
- Section: java
- Priority: optional
- Maintainer: Debian Java Maintainers <pkg-java-maintainers at lists.alioth.debian.org>
- Uploaders: Torsten Werner <twerner at debian.org>, Ludovic Claude <ludovic.claude at laposte.net>
- Build-Depends: debhelper (>= 5), cdbs (>= 0.4.5.3), default-jdk
- Build-Depends-Indep: maven-repo-helper (>= 1.7), maven-ant-helper (>= 7), ant, ant-optional,
- libplexus-utils-java, libplexus-containers-java
- Standards-Version: 3.8.1
- Vcs-Svn: svn://svn.debian.org/svn/pkg-java/trunk/plexus-io
- Vcs-Browser: http://svn.debian.org/wsvn/pkg-java/trunk/plexus-io/
- Homepage: http://plexus.codehaus.org/plexus-components/plexus-io/
-
- Package: libplexus-io-java
- Architecture: all
- Depends: ${misc:Depends}, libplexus-utils-java, libplexus-containers-java
- Description: Plexus IO Components
- [...]
-
-Note the Build-Depends on cdbs and maven-repo-helper.
-
-debian/rules:
-
- #!/usr/bin/make -f
- include /usr/share/cdbs/1/rules/debhelper.mk
- include /usr/share/cdbs/1/class/ant.mk
-
- PACKAGE := $(DEB_SOURCE_PACKAGE)
- VERSION := $(DEB_UPSTREAM_VERSION)
- JAVA_HOME := /usr/lib/jvm/default-java
- DEB_JARS := ant-nodeps plexus-utils plexus-container-default
- DEB_ANT_BUILD_TARGET := package #javadoc
- DEB_ANT_BUILDFILE := /usr/share/maven-ant-helper/maven-build.xml
- DEB_ANT_ARGS := -Dbasedir=$(realpath .) -Dpackage=$(PACKAGE) -Dversion=$(VERSION)
- API_DOCS := build/api
-
- binary-post-install/lib$(PACKAGE)-java::
- mh_installpoms -plib$(PACKAGE)-java
- mh_installjar -plib$(PACKAGE)-java -l pom.xml build/$(PACKAGE)-$(VERSION).jar
-
- clean::
- mh_clean
-
-No patches for the POM files are needed, all is taken care of by the mh\_installpom script (which uses mh\_cleanpom)
-
-mh\_installpoms will install all POM files registered in debian/lib$package-java.pom into /usr/share/maven-repo,
-
-mh\_installjar will install the jar file associated with the POM into /usr/share/maven-repo and also add a link to the jar in /usr/share/java, with and without the version
-
-debian/libplexus-io-java.pom
-
- pom.xml --no-parent
-
-It simply lists the pom files in the source tree which need to be installed in the repository, and indicates with the --no-parent option that if the POM inherits
-from a parent POM, then this inheritance relationship will be removed in the cleaned POM. Removing the parent inheritence can often simplify the packaging, as
-the parent POM mostly does not contain any useful information - we need only the list of dependencies in our repository, the other details for the build are irrelevant.
-
-There is less configuration here because we are using the low-level mh_installpoms and mh_installjar scripts which place the configuration on their command line options.
Typical workflow for packaging a project from source
----------------------------------------------------
View it on GitLab: https://salsa.debian.org/java-team/maven-repo-helper/-/commit/1f3a0cef46a8770d090d0b6042c4db1e1e55765a
--
View it on GitLab: https://salsa.debian.org/java-team/maven-repo-helper/-/commit/1f3a0cef46a8770d090d0b6042c4db1e1e55765a
You're receiving this email because of your account on salsa.debian.org.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://alioth-lists.debian.net/pipermail/pkg-java-commits/attachments/20250904/f7456c8c/attachment.htm>
More information about the pkg-java-commits
mailing list