-
Notifications
You must be signed in to change notification settings - Fork 3
/
CONTRIBUTING
50 lines (38 loc) · 1.75 KB
/
CONTRIBUTING
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
45
46
47
48
49
50
If you HATE Dist::Zilla, fear not, you can pretty easily hack at make
pull requests for FFI::TinyCC without installing dzil and pulling down
half of CPAN!
If you Love Dist::Zilla, or if you work with it anyway, then you know
what to do and can skip reading this.
You will need to install these CPAN dists to work on this dist:
. perl 5.8.1 or better (required for FFI::Platypus)
. autodie
. Alien::TinyCC
. Archive::Ar 2.02 or better
. File::chdir
. Path::Tiny
. FFI::Platypus
. FFI::Platypus::Type::StringArray
. Test2::API
. Test2::Suite
(sorry there is no cpanfile)
You will also need a shared or dll version of libtcc for your platform.
Unfortunately, Alien::TinyCC comes with a static library only on most
(all?) Unix platforms. This normally gets built and put in the share
directory by Module::Build when you install, but of course since you
don't want to run dzil that isn't an option. It is okay, you can build
it from the checked out git repository like this:
% perl -Iinc -MMy::DLL -e tcc_build
Take a look at the share directory you should have a libtcc.so or
libtcc.dll now. If you have to switch architectures with the same
repository, you can clean up with this incantation:
% perl -Iinc -MMy::DLL -e tcc_clean
Now that you have the dynamic library that FFI::TinyCC needs, you can
run the test suite by using prove and its -l option:
% prove -l
If you need to run a one-liner or whole program with your checked out
git version of FFI::TinyCC, you can set PERL5LIB to the lib directory in
this repository and it should just work. If it doesn't, then please let
me know. I like to use Dist::Zilla because it saves me time, but I am
happy to make an effort to make it easier for you to contribute.
Thanks!
Graham <plicease@cpan.org>