X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=perl-policy.sgml;h=58c33328fb8eec1aea378294862c3df1cc79cc5c;hb=cc34dcc0;hp=edf8e4f609b584220126be7a1fa1b43e4e4c9fcf;hpb=2ae3e536615ebb3615f395d39a615b1d84e0b90a;p=debian%2Fdebian-policy.git diff --git a/perl-policy.sgml b/perl-policy.sgml index edf8e4f..58c3332 100644 --- a/perl-policy.sgml +++ b/perl-policy.sgml @@ -6,13 +6,15 @@ Debian Perl Policy Raphaël Hertzog - hertzog@debian.org Brendan O'Dea - bod@debian.org - version 1.19 + + The Debian Policy mailing list + debian-policy@lists.debian.org + + version 1.20 This document describes the packaging of Perl within the Debian @@ -38,21 +40,33 @@

A copy of the GNU General Public License is available as - /usr/share/common-licences/GPL in the Debian GNU/Linux + /usr/share/common-licenses/GPL in the Debian GNU/Linux distribution or on the World Wide Web at .

You can also obtain it by writing to the - Free Software Foundation, Inc., 59 Temple Place - Suite 330, - Boston, MA 02111-1307, USA. + Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, + Boston, MA 02110-1301, USA.

+ + About this document +

+ This document is distributed as the perl-policy files + in the Debian package + . + It is also available from the Debian web mirrors at + . +

+
+ Perl Packaging @@ -75,8 +89,11 @@

The perl-base package must provide - perlapi-version for all released - versions it is compatible with. + perlapi-abiname for all released + package versions it is compatible with. The choice of + abiname is arbitrary, but if it differs from + $Config{version}, it must be specified in + $Config{debian_abi}.

@@ -89,18 +106,18 @@ the binary and a basic set of modules.

- As Perl is currently used by such things as - update-alternatives and some package maintainer - scripts, it must be priority required and marked as - essential. + As Perl has been part of the essential set for some time and is + used without dependencies by such things as package maintainer + scripts, perl-base must be + priority required and marked as essential.

Note that the perl-base package is intended only to provide for exceptional circumstances and the contents - may change. In general only packages which form part of the - base system should declare a dependency on - perl-base rather than - perl. + may change. In general, only packages which form part of the + base system should use only the facilities + of perl-base rather than declaring a + dependency on perl.

@@ -299,12 +316,11 @@ $(MAKE) OPTIMIZE="-O2 -g -Wall" and this one to install the results into the temporary tree: -$(MAKE) install PREFIX=$(CURDIR)/debian/tmp/usr - -

-

- A Build-Depends on perl (>= 5.6.0-16) is - required. +$(MAKE) install PREFIX=$(CURDIR)/debian/<tmp>/usr + +

Replace <tmp> with the appropriate directory + (nominally just tmp)

+

@@ -325,13 +341,6 @@ $(MAKE) install PREFIX=$(CURDIR)/debian/tmp/usr the minimum required version, or more simply the current version.

-

- In the absence of an explicit requirement, - architecture-independent modules must depend on a minimum - perl or perl-base - version of 5.6.0-16 due to the changes in - @INC introduced by that version. -

@@ -342,7 +351,9 @@ $(MAKE) install PREFIX=$(CURDIR)/debian/tmp/usr a minimum version of the perl package used to build the module, and must additionally depend on the expansion of - perlapi-$Config{version}. + perlapi-$Config{debian_abi} using + the Config module. If $Config{debian_abi} + is empty or not set, $Config{version} must be used.

@@ -352,15 +363,22 @@ $(MAKE) install PREFIX=$(CURDIR)/debian/tmp/usr Rather than hard-coding the dependencies into the control file, using a substitution such as ${perl:Depends} is suggested. This allows the dependencies to be determined - as build time and written to the substvars file - in the form perl:Depends=deps. + at build time and written to the substvars file + in the form + perl:Depends=deps. +

Please note that dependencies caused by versioned + uses and on separately packaged modules are not included + in this variable and must be explicitly included.

+

- Packages built with debhelper may use to generate this substitution - automatically. This additionally requires a versioned - Build-Depends (or Build-Depends-Indep) - on debhelper (>= 3.0.18). + Packages built with debhelper may use + + to generate this + substitution automatically. This additionally requires a + versioned Build-Depends (or + Build-Depends-Indep) on debhelper (>= + 3.0.18).

@@ -394,7 +412,7 @@ $(MAKE) install PREFIX=$(CURDIR)/debian/tmp/usr

As with modules, packages using debhelper may use - to automatically generate + to automatically generate dependences (see ).

@@ -463,3 +481,6 @@ perl -MExtUtils::Embed -e ldopts + + +