File: HACKING

package info (click to toggle)
libpdf-api2-perl 2.019-1%2Bdeb7u1
  • links: PTS, VCS
  • area: main
  • in suites: wheezy
  • size: 20,264 kB
  • sloc: perl: 42,313; sh: 23; makefile: 9
file content (44 lines) | stat: -rw-r--r-- 1,226 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
PDF::API2 is using Dist::Zilla to make development easier.
Unfortunately, this can make it a little bit harder to contribute
since the source isn't the same as the distribution.


GET THE SOURCE CODE
-------------------

You can get the source from the following master repository:

http://deefs.net/hg/pdfapi2

It can also be found in an easily-forked location at:

http://bitbucket.org/ssimms/pdfapi2


INSTALL Dist::Zilla
-------------------

Once you have the source, you'll also need the Dist::Zilla
distribution from CPAN.  It has a boatload of dependencies, but it
should install cleanly.  If not, help is usually easy to find on
irc.perl.org.


RUN dzil build|test|etc
-----------------------

PERL5LIB=lib dzil build|test|etc

or

export PERL5LIB=lib
dzil build|test|etc

If you leave out the PERL5LIB=lib part, you'll almost definitely get
an error saying that PDF::API2::Build::Version couldn't be located.
That's because it's only found here.

Basically, PDF::API2::Build::Version takes the version number from the
dist.ini file and adds it to all the .pm files just under the package
name.  As of this writing, I haven't found a plugin for Dist::Zilla
that does this in a way that doesn't look machine-generated.