perl.req(1)

1PERL.REQ(1)           User Contributed Perl Documentation          PERL.REQ(1)
2
3
4

NAME

6       perl.req - list requirements for Perl scripts and libraries
7

SYNOPSIS

9       perl.req [-h|--help] [-v|--verbose] [-m|--method=strict|normal|relaxed]
10       [FILE...]
11

DESCRIPTION

13       perl.req calculates prerequisites for each Perl source file specified
14       on a command line; alternatively, a list of files is obtained from
15       standard input, one file per line.  "use", "require" and "do"
16       statements are processed.  The output of perl.req is suitable for
17       automatic dependency tracking (e.g. for RPM packaging).
18
19       For example, /usr/lib/perl5/File/Temp.pm requires, in particular,
20       "perl(Fcntl.pm) >= 1.030" (as of perl-5.8.6).
21
22       perl.req is basically a wrapper for B::PerlReq Perl compiler backend.
23

OPTIONS

25       -m, --method=method
26           Use particular method for dependency tracking.  Alternatively,
27           RPM_PERL_REQ_METHOD environement variable can be used to set the
28           method.
29
30           The following methods are available:
31
32           strict
33               Search thoroughly and list all requirements.  In particular,
34               list platform-specific (non-UNIX) requirements and requirements
35               found inside "eval" blocks.
36
37           normal (default)
38               Enable moderate search most acceptable for RPM packaging.  That
39               is, skip files known to be platform-specific; skip platform-
40               specific requirements and those found inside "eval" blocks;
41               skip most common requirements (e.g. "strict.pm").
42
43           relaxed
44               Enable relaxed mode.  That is, tolerate B::PerlReq failures; in
45               addition to normal method, skip conditional requirements (e.g.
46               "require" statements inside subroutines); skip "do FILE"
47               statements; list only essential dependencies.
48
49       -v, --verbose
50           Increase verbosity.
51

AUTHOR

53       Written by Alexey Tourbin <at@altlinux.org>, based on an earlier
54       version by Ken Estes <kestes@staff.mail.com>, with contributions from
55       Mikhail Zabaluev <mhz@altlinux.org>.
56

HISTORY

58       Initial version of perl.req (part of RPM 3.0) done by Ken Estes in
59       1999.  Regular expressions were used to extract dependencies.  (Later a
60       part of ALT Linux Master 2.0, with modifications from Mikhail
61       Zabaluev.)
62
63       Reworked in November 2002: complicated regular expressions were added
64       to enhance search; methods added.  (Later a part of ALT Linux Master
65       2.2.)
66
67       Reworked in September 2003: B::Deparse was utilized to re-format Perl
68       code before dependency extraction; hence more simple and accurate.
69       Decoupled from rpm-build package into rpm-build-perl.  (Later a part of
70       ALT Linux Master 2.4.)
71
72       Reworked in December 2004: B::PerlReq was developed.  Released on CPAN,
73       see <http://search.cpan.org/dist/rpm-build-perl/>.
74

COPYING

76       Copyright (c) 2003, 2004 Alexey Tourbin, ALT Linux Team.
77
78       This is free software; you can redistribute it and/or modify it under
79       the terms of the GNU Library General Public License as published by the
80       Free Software Foundation; either version 2 of the License, or (at your
81       option) any later version.
82