<title>Debian Perl Policy</title>
<author>
<name>Raphaël Hertzog</name>
- <email>hertzog@debian.org</email>
</author>
<author>
<name>Brendan O'Dea</name>
- <email>bod@debian.org</email>
+ </author>
+ <author>
+ <name>The Debian Policy mailing list</name>
+ <email>debian-policy@lists.debian.org</email>
</author>
<version>version 1.20</version>
</p>
<p>
A copy of the GNU General Public License is available as
- <tt>/usr/share/common-licences/GPL</tt> in the Debian GNU/Linux
+ <tt>/usr/share/common-licenses/GPL</tt> in the Debian GNU/Linux
distribution or on the World Wide Web at
<url id="http://www.gnu.org/copyleft/gpl.html"
name="The GNU Public Licence">.
</p>
<p>
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.
</p>
</copyright>
</titlepag>
<toc detail="sect">
+ <chapt>
+ <heading>About this document</heading>
+ <p>
+ This document is distributed as the <tt>perl-policy</tt> files
+ in the Debian package
+ <package><url name="debian-policy" id="http://packages.debian.org/debian-policy"></package>.
+ It is also available from the Debian web mirrors at
+ <tt><url name="/doc/packaging-manuals/perl-policy/"
+ id="http://www.debian.org/doc/packaging-manuals/perl-policy/"></tt>.
+ </p>
+ </chapt>
+
<chapt id="perl">
<heading>Perl Packaging</heading>
<sect id="versions">
</example>
and this one to install the results into the temporary tree:
<example>
-$(MAKE) install PREFIX=$(CURDIR)/debian/tmp/usr
- </example>
- </p>
- <p>
- A <tt>Build-Depends</tt> on <tt>perl (>= 5.6.0-16)</tt> is
- required.
+$(MAKE) install PREFIX=$(CURDIR)/debian/<tmp>/usr
+ </example><footnote>
+ <p>Replace <tmp> with the appropriate directory
+ (nominally just tmp)</p>
+ </footnote>
</p>
</sect>
the minimum required version, or more simply the current
version.
</p>
- <p>
- In the absence of an explicit requirement,
- architecture-independent modules must depend on a minimum
- <package>perl</package> or <package>perl-base</package>
- version of <tt>5.6.0-16</tt> due to the changes in
- <tt>@INC</tt> introduced by that version.
- </p>
</sect1>
<sect1 id="binary_modules">
Rather than hard-coding the dependencies into the control
file, using a substitution such as <tt>${perl:Depends}</tt>
is suggested. This allows the dependencies to be determined
- as build time and written to the <file>substvars</file> file
- in the form <tt>perl:Depends=<var>deps</var></tt>.
+ at build time and written to the <file>substvars</file> file
+ in the form
+ <tt>perl:Depends=<var>deps</var></tt>.<footnote>
+ <p>Please note that dependencies caused by versioned
+ uses and on separately packaged modules are not included
+ in this variable and must be explicitly included.</p>
+ </footnote>
</p>
<p>
- Packages built with <prgn>debhelper</prgn> may use <manref
- name="dh_perl" section=1> to generate this substitution
- automatically. This additionally requires a versioned
- <tt>Build-Depends</tt> (or <tt>Build-Depends-Indep</tt>)
- on <tt>debhelper (>= 3.0.18)</tt>.
+ Packages built with <prgn>debhelper</prgn> may use
+
+ <manref name="dh_perl" section="1"> to generate this
+ substitution automatically. This additionally requires a
+ versioned <tt>Build-Depends</tt> (or
+ <tt>Build-Depends-Indep</tt>) on <tt>debhelper (>=
+ 3.0.18)</tt>.
</p>
</sect1>
</sect>
</p>
<p>
As with modules, packages using <prgn>debhelper</prgn> may use
- <manref name="dh_perl" section=1> to automatically generate
+ <manref name="dh_perl" section="1"> to automatically generate
dependences (see <ref id="dh_perl">).
</p>
</sect>
</appendix>
</book>
</debiandoc>
+<!-- Local variables: -->
+<!-- indent-tabs-mode: t -->
+<!-- End: -->