File: //usr/share/doc/debian-policy/perl-policy.html/ch-programs.html
<?xml version="1.0" encoding="utf-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Chapter 5. Perl Programs</title>
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot" />
<link rel="home" href="index.html" title="Debian Perl Policy" />
<link rel="up" href="index.html" title="Debian Perl Policy" />
<link rel="prev" href="ch-module_packages.html" title="Chapter 4. Packaged Modules" />
<link rel="next" href="ch-embed.html" title="Chapter 6. Programs Embedding Perl" />
</head>
<body>
<div class="navheader">
<table width="100%" summary="Navigation header">
<tr>
<th colspan="3" align="center">Chapter 5. Perl Programs</th>
</tr>
<tr>
<td width="20%" align="left"><a accesskey="p" href="ch-module_packages.html">Prev</a> </td>
<th width="60%" align="center"> </th>
<td width="20%" align="right"> <a accesskey="n" href="ch-embed.html">Next</a></td>
</tr>
</table>
<hr />
</div>
<div class="chapter">
<div class="titlepage">
<div>
<div>
<h1 class="title"><a id="ch-programs"></a>Chapter 5. Perl Programs</h1>
</div>
</div>
</div>
<div class="toc">
<p>
<strong>Table of Contents</strong>
</p>
<dl class="toc">
<dt>
<span class="section">
<a href="ch-programs.html#s-hash-bang">5.1. Script Magic</a>
</span>
</dt>
<dt>
<span class="section">
<a href="ch-programs.html#s-program-deps">5.2. Program Dependencies</a>
</span>
</dt>
</dl>
</div>
<div class="section">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a id="s-hash-bang"></a>5.1. Script Magic</h2>
</div>
</div>
</div>
<p>
All packaged perl programs should start with
<code class="literal">#!/usr/bin/perl</code> and may append such flags as
are required.
</p>
</div>
<div class="section">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a id="s-program-deps"></a>5.2. Program Dependencies</h2>
</div>
</div>
</div>
<p>
Programs which require <em class="replaceable"><code>core</code></em> modules
from the <code class="systemitem">perl</code> package must
specify a dependency on that package.
</p>
<p>
Programs which contain explicit <code class="literal">require
<em class="replaceable"><code>version</code></em></code> or <code class="literal">use
<em class="replaceable"><code>version</code></em></code> statements must
specify a dependency on <code class="systemitem">perl</code> or <code class="systemitem">perl-base</code> with the minimum required
version, or more simply the current version.
</p>
<p>
As with modules, packages using <span class="command"><strong>debhelper</strong></span> may
use
<span class="citerefentry"><span class="refentrytitle">dh_perl</span>(1)</span>
to automatically generate dependencies (see <a class="xref" href="ch-module_packages.html#s-dh-perl" title="4.4.3. Automating Perl Dependencies">Section 4.4.3, “Automating Perl Dependencies”</a>).
</p>
</div>
</div>
<div class="navfooter">
<hr />
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left"><a accesskey="p" href="ch-module_packages.html">Prev</a> </td>
<td width="20%" align="center"> </td>
<td width="40%" align="right"> <a accesskey="n" href="ch-embed.html">Next</a></td>
</tr>
<tr>
<td width="40%" align="left" valign="top">Chapter 4. Packaged Modules </td>
<td width="20%" align="center">
<a accesskey="h" href="index.html">Home</a>
</td>
<td width="40%" align="right" valign="top"> Chapter 6. Programs Embedding Perl</td>
</tr>
</table>
</div>
</body>
</html>