1= FreeBSD Installation Instructions =
2== Installation using pkg_add ==
3Because the FreeBSD Perl package comes without threads support no official Padre packages are available. The prefered method is to manually recompile Perl port to support threads and then build Padre and all it's dependencies from Ports (see below).
4
5However there are __'''highly experimental'''__ packages available for FreeBSD 6-STABLE and 7-STABLE.
6
7First, make sure you have uninstalled the non-threaded Perl package or that you have threaded Perl already compiled. Please note, that after installing threaded Perl all Perl modules already installed have to be recompiled.
8All packages depend on Perl 5.8.9 (that's the current Perl version for 6 and 7 branches).
9
10First set `PACKAGESITE` environment variable to point to {{{ http://therek.net/freebsd/tb/6-STABLE-i386/All/Latest/ }}} for 6-STABLE or {{{ http://therek.net/freebsd/tb/7-STABLE-i386/All/Latest/ }}} for 7-STABLE. Then install packages as usual:
11
12{{{
13# setenv PACKAGESITE http://therek.net/freebsd/tb/6-STABLE-i386/All/Latest/ # for C Shell
14# export PACKAGESITE=http://therek.net/freebsd/tb/6-STABLE-i386/All/Latest/ # for Bourne Shell
15# pkg_add -r p5-Padre
16}}}
17
18Feedback is welcome.
19
20== Installation from Source ==
21
22To run Padre on FreeBSD you have to recompile Perl to support threads.
23To verify whether your Perl installation has thread support turned on run following command.
24{{{
25$ perl -V:usethreads
26usethreads='define';
27}}}
28
29If the result is `define` then you have already threaded Perl installed, otherwise execute:
30{{{
31# cd /usr/ports/lang/perl5.8 && make WITH_THREADS=yes
32# make deinstall && make reinstall
33}}}
34Optionally you can substitute `make WITH_THREADS=yes` with the following and choose `THREADS` in the menu.
35Then uninstall and reinstall Perl as above.
36This has an advantage over the previous method, because the preferred configuration options will be stored in your system's packing database.
37This way next time you'll be building Perl (i.e. updating) all stored options will be applied without the need to manually specify them.
38{{{
39# make config
40# make
41}}}
42
43To install Padre and its dependencies just execute:
44{{{
45# cd /usr/ports/editors/p5-Padre
46# make install clean
47}}}
48
49
50== Installation from CPAN ==
51
52Currently, there are no Padre CPAN installation instructions specific to FreeBSD.
53Feel free to add comments and hints.
54
55== Still Not Working? ==
56Following the instructions on this page did not lead to a successful installation?
57
58[http://padre.perlide.org/contact.html Contact us].
59
60We will do our best to help you.
61By letting us know that something does not work you will help us, too.
62When we know about it, we can improve this documentation and Padre itself.
63