The following commit has been merged in the master branch:
commit 7fd5e980f780c43e757432c7f0438e23c1e4d4cd
Author: Raphaël Hertzog <[email protected]>
Date: Fri Feb 26 13:50:42 2010 +0100
Introduce the libdpkg-perl package
Clarify the status of the API in README.api.
diff --git a/debian/.gitignore b/debian/.gitignore
index 205fb23..5bf5d56 100644
--- a/debian/.gitignore
+++ b/debian/.gitignore
@@ -1,4 +1,5 @@
libdpkg-dev
+libdpkg-perl
dpkg
dpkg-dev
dselect
diff --git a/debian/changelog b/debian/changelog
index bc5798f..1b58d40 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -59,6 +59,7 @@ dpkg (1.15.6) UNRELEASED; urgency=low
-i and -I. A new option --extend-diff-ignore is introduced. Those options
can thus now be used in debian/source/options.
* Generate manual pages for perl modules.
+ * Introduce the libdpkg-perl package and clarify its status in README.api.
[ Guillem Jover ]
* Handle argument parsing in dpkg-checkbuilddeps and dpkg-scanpackages
diff --git a/debian/control b/debian/control
index 6a24035..7a1b998 100644
--- a/debian/control
+++ b/debian/control
@@ -52,9 +52,8 @@ Package: dpkg-dev
Section: utils
Priority: optional
Architecture: all
-Depends: dpkg (>= 1.15.4), perl, bzip2, xz-utils,
- patch (>= 2.2-1), make, binutils, libtimedate-perl,
- base-files (>= 5.0.0), ${misc:Depends}
+Depends: libdpkg-perl (= ${source:Version}), bzip2, xz-utils,
+ patch, make, binutils, base-files (>= 5.0.0), ${misc:Depends}
Recommends: gcc | c-compiler, build-essential, fakeroot, gnupg, gpgv
Suggests: debian-keyring
Conflicts: dpkg-cross (<< 2.0.0), devscripts (<< 2.10.26)
@@ -66,6 +65,40 @@ Description: Debian package development tools
Most Debian source packages will require additional tools to build;
for example, most packages need make and the C compiler gcc.
+Package: libdpkg-perl
+Section: perl
+Priority: optional
+Architecture: all
+Depends: dpkg (>= 1.15.4), perl, libtimedate-perl, ${misc:Depends}
+Recommends: bzip2, xz-utils
+Suggests: debian-keyring, gnupg, gpgv, binutils, patch
+Conflicts: dpkg-dev (<< 1.15.6)
+Replaces: dpkg-dev (<< 1.15.6)
+Description: Dpkg perl modules
+ This package provides the perl modules used by the scripts
+ in dpkg-dev. They cover a wide range of functionalities. Among them
+ there are the following modules:
+ .
+ - Dpkg::Arch: manipulate Debian architecture information
+ - Dpkg::BuildOptions: parse and manipulate DEB_BUILD_OPTIONS
+ - Dpkg::Changelog: parse Debian changelogs
+ - Dpkg::Checksums: generate and parse checksums
+ - Dpkg::Compression::Process: wrapper around compression tools
+ - Dpkg::Compression::FileHandle: transparently (de)compress files
+ - Dpkg::Control: parse and manipulate Debian control information
+ (.dsc, .changes, Packages/Sources entries, etc.)
+ - Dpkg::Deps: parse and manipulate dependencies
+ - Dpkg::ErrorHandling: common error functions
+ - Dpkg::Index: collections of Dpkg::Control (Packages/Sources files for
+ example)
+ - Dpkg::IPC: spawn sub-processes and feed/retrieve data
+ - Dpkg::Substvars: substitute variables in strings
+ - Dpkg::Vendor: identify current distribution vendor
+ - Dpkg::Version: parse and manipulate Debian package versions
+ .
+ All the packages listed in Suggests or Recommends are used by some of the
+ modules.
+
Package: dselect
Priority: optional
Architecture: any
diff --git a/debian/dpkg-dev.install b/debian/dpkg-dev.install
index e8d74ba..9d911db 100644
--- a/debian/dpkg-dev.install
+++ b/debian/dpkg-dev.install
@@ -15,8 +15,6 @@ usr/bin/dpkg-scansources
usr/bin/dpkg-shlibdeps
usr/bin/dpkg-source
usr/bin/dpkg-vendor
-usr/lib/dpkg/parsechangelog
-usr/share/locale/*/LC_MESSAGES/dpkg-dev.mo
usr/share/man/{*/*,*}/deb-control.5
usr/share/man/{*/*,*}/deb-version.5
usr/share/man/{*/*,*}/deb-substvars.5
@@ -42,5 +40,3 @@ usr/share/man/{*/*,*}/dpkg-scansources.1
usr/share/man/{*/*,*}/dpkg-shlibdeps.1
usr/share/man/{*/*,*}/dpkg-source.1
usr/share/man/{*/*,*}/dpkg-vendor.1
-usr/share/man/man3/Dpkg*.3
-usr/share/perl5/Dpkg
diff --git a/debian/libdpkg-dev.docs b/debian/libdpkg-perl.docs
similarity index 80%
copy from debian/libdpkg-dev.docs
copy to debian/libdpkg-perl.docs
index 7eeafe8..efd34de 100644
--- a/debian/libdpkg-dev.docs
+++ b/debian/libdpkg-perl.docs
@@ -1,5 +1,4 @@
AUTHORS
THANKS
-debian/usertags
doc/README.api
doc/README.feature-removal-schedule
diff --git a/debian/libdpkg-perl.install b/debian/libdpkg-perl.install
new file mode 100644
index 0000000..72438e4
--- /dev/null
+++ b/debian/libdpkg-perl.install
@@ -0,0 +1,4 @@
+usr/lib/dpkg/parsechangelog
+usr/share/locale/*/LC_MESSAGES/dpkg-dev.mo
+usr/share/man/man3/Dpkg*.3
+usr/share/perl5/Dpkg
diff --git a/debian/libdpkg-perl.lintian-overrides
b/debian/libdpkg-perl.lintian-overrides
new file mode 100644
index 0000000..d7cd8a0
--- /dev/null
+++ b/debian/libdpkg-perl.lintian-overrides
@@ -0,0 +1,2 @@
+libdpkg-perl: redundant-origin-field
+libdpkg-perl: redundant-bugs-field
diff --git a/doc/README.api b/doc/README.api
index 49c7cac..fe575ad 100644
--- a/doc/README.api
+++ b/doc/README.api
@@ -13,17 +13,25 @@ Description:
then define the C preprocessor macro LIBDPKG_VOLATILE_API in your build
to acknowledge that fact.
-What: Dpkg (perl modules)
-Status: testing
+What: libdpkg-perl (perl modules)
+Status: stable
Description:
- The API provided by these modules is not yet stable, it's only supposed to
- be used internally by dpkg for now.
+ Among the perl modules provided by libdpkg-perl, you can safely rely on
+ those that have $VERSION set to 1.00 (or higher). Note however that the
+ API is defined by what's documented in the corresponding manual pages and
+ nothing more. You can't assume anything else based on what you read in
+ the source code. If you feel the need for further refinements in the
+ documented API, don't hesitate to file a wishlist bug against
+ libdpkg-perl.
+ .
+ In case of API-breaking changes, the major number in $VERSION will be
+ increased. For API extensions, the minor number will be increased.
What: custom changelog parsers in /usr/lib/dpkg/parsechangelog
Status: stable
Version: 2.0
Description:
- Since dpkg 1.14.16, the set of command-line options that custome
+ Since dpkg 1.14.16, the set of command-line options that custom
changelog parsers must support has been expanded (see
dpkg-parsechangelog(1)). For compatibility, changelog parsers supporting
only the old options are supported in lenny. In lenny+1, that support
--
dpkg's main repository
--
To UNSUBSCRIBE, email to [email protected]
with a subject of "unsubscribe". Trouble? Contact [email protected]
