Changes between Version 144 and Version 145 of Download


Ignore:
Timestamp:
Apr 1, 2010, 9:57:00 PM (4 years ago)
Author:
zenogantner
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Download

    v144 v145  
    1 We work hard to make the Padre installation simple but it is a large project with lots of dependencies. 
    2 Help and suggestions are always welcome. 
    3 See also the Distribution part of the [wiki:Development] page. 
    4  
    5  
    6 Installation instructions can be found on the website: http://padre.perlide.org/download.html 
    7  
    8 == Platform-specific Instructions == 
    9 You can find installation instruction for your platform by following one of the links below. 
    10 If you do not find your platform here, [http://padre.perlide.org/contact.html feel free to contact us], 
    11 we will see what we can do. 
    12  
    13  * [wiki:DownloadWindows Windows] 
    14  * [wiki:DownloadMacOSX Mac OS X] 
    15  * GNU/Linux distributions: 
    16   * [wiki:DownloadDebian Debian] 
    17   * [wiki:DownloadFedora Fedora] 
    18   * [wiki:DownloadGentoo Gentoo] 
    19   * [wiki:DownloadMandriva Mandriva] 
    20   * [wiki:DownloadOpenSUSE openSUSE] 
    21   * [wiki:DownloadUbuntu Ubuntu] 
    22  * BSD variants: 
    23   * [wiki:DownloadFreeBSD FreeBSD] 
    24   * [wiki:DownloadNetBSD NetBSD] 
    25  
    26 == Source Code == 
    27 If you want to install Padre's latest release from CPAN, you will find instructions here: [wiki:DownloadCPAN]. 
    28  
    29 If you want to participate in Padre's development, it is recommended to install the development branch (trunk) from our Subversion repository: [wiki:DownloadRepository]. 
     1[[PageOutline(1-2)]] 
     2 
     3We work hard to make the Padre installation simple but it is a large 
     4project with lots of dependencies. (See also the Distribution part of the [wiki:Development] page) 
     5 
     6 
     7= Windows = 
     8 
     9The most convenient way to get Padre at this time is via the Stand Alone Padre. See the http://padre.perlide.org/download.html 
     10page for details. 
     11 
     12= CPAN = 
     13 
     14Normally you should be able to just install it as any other Perl module using the CPAN or CPANPLUS shell. 
     15{{{ 
     16  $ cpan 
     17  cpan> install Padre 
     18}}} 
     19but '''read on!! ''' , many of the dependencies need manual attention and it can take several hours to install it the first time. 
     20See further details on this page. 
     21 
     22= Known issues = 
     23 
     24with Padre and its dependencies 
     25 
     26Alien::wxWdigets and Wx often need to be installed one-by-one manually 
     27 
     28On Windows IPC::Run (0.82) hangs sometimes - install it using 
     29{{{ 
     30  cpan> force install notest IPC::Run 
     31}}} 
     32 
     33 
     34There are some more issues, we should add them here. 
     35 
     36Current status information and issues with packaging Padre are shown on the [wiki:Distribution distribution page]. 
     37 
     38 
     39= Binary = 
     40 
     41While we would be happy to have many people install Padre from CPAN and then switch to use it 
     42from our SVN repository, we also would like to make it easy to start with Padre so we try to 
     43provide some binary packages. 
     44 
     45== Mandriva == 
     46 
     47Mandriva 2009.0 comes with pre-packaged Padre 0.10. 
     48Mandriva 2009.1 will ship Padre 0.29. 
     49Mandriva cooker (development version) is following upstream quite closely. 
     50 
     51Jerome Quelin (jq on [wiki:IRC], jquelin) who is both a Padre developer and a Mandriva maintainer keeps Padre up to date in Mandriva. 
     52 
     53To install padre: 
     54 
     55{{{ 
     56# urpmi perl-Padre 
     57}}} 
     58 
     59== Fedora == 
     60 
     61Fedora-11 includes Padre-0.32 with Wx Version: 0.91. 
     62Update your Wx: 
     63https://admin.fedoraproject.org/updates/perl-Wx-0.91-5.fc11 
     64 
     65[https://admin.fedoraproject.org/pkgdb/packages/name/perl-Padre] 
     66 
     67Marcela Maslanova (marcela) keeps Padre up to date in Fedora. 
     68 
     69To install padre: 
     70 
     71{{{ 
     72# yum install perl-Padre 
     73}}} 
     74 
     75Unofficial (s)rpms for 0.42 with requirements: 
     76http://mmaslano.fedorapeople.org/padre/ 
     77 
     78== Debian == 
     79 
     80Latest Debian package is available at http://packages.debian.org/sid/main/padre 
     81 
     82 
     83To install Padre on Debian:  
     84 
     85Add an "Unstable" source to  /etc/apt/sources.list as follows:  
     86{{{ 
     87deb http://mirror.isoc.org.il/pub/debian/ unstable main contrib non-free 
     88deb-src http://mirror.isoc.org.il/pub/debian/ unstable main contrib non-free 
     89}}} 
     90 
     91Then update:  
     92{{{ 
     93# apt-get update 
     94}}} 
     95 
     96And now - install:  
     97{{{ 
     98# apt-get install padre 
     99}}} 
     100 
     101Packages are done by Ryan52. 
     102 
     103 
     104== Ubuntu == 
     105 
     106Ubuntu 9.10 contains Padre 0.42 
     107 
     108{{{ 
     109# apt-get install padre 
     110}}} 
     111 
     112Packages are done by Ryan52. 
     113 
     114== FreeBSD == 
     115 
     116Because 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 [wiki:Download#FreeBSD1]). 
     117 
     118However there are __'''highly experimental'''__ packages available for FreeBSD 6-STABLE and 7-STABLE. Before reading further '''be warned that you're using them at your own responsibility! ''' Neither Padre developers nor package contributor can be held responsible for any damage done to your computer. 
     119 
     120First, make sure you have deinstalled 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. All packages depends on Perl 5.8.9 (that's the current Perl version for 6 and 7 branches). 
     121 
     122First 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: 
     123 
     124{{{ 
     125# setenv PACKAGESITE http://therek.net/freebsd/tb/6-STABLE-i386/All/Latest/ # for C Shell 
     126# export PACKAGESITE=http://therek.net/freebsd/tb/6-STABLE-i386/All/Latest/ # for Bourne Shell 
     127# pkg_add -r p5-Padre 
     128}}} 
     129 
     130Feedback is welcomed. 
     131 
     132== NetBSD == 
     133 
     134For binary packages installation take a look at {{{ http://www.netbsd.org/docs/software/packages.html#binarydist }}}. There're packages available for some platforms (including NetBSD and Darwin), 2010Q1 release of pkgsrc will provide binary packages for Padre, too. 
     135 
     136Packed by Sno|, contact pkgsrc-users@NetBSD.org in case of problems. 
     137 
     138= Source code = 
     139 
     140Padre is released as a CPAN package. You can download and install it using CPAN.pm or CPANPLUS. 
     141The released versions can be seen here [http://search.cpan.org/dist/Padre/] and here [http://kobesearch.cpan.org/dist/Padre]. 
     142 
     143As Padre has many dependencies probably the easiest is to install the binary distribution 
     144where available from the vendor (Mandriva, Fedora, Debian, FreeBSD) and then use CPAN.pm to upgrade. 
     145 
     146If this is not possible read on: 
     147 
     148The difficult part will be to install some of the prerequisites: 
     149 
     150 * Installing wxWidgets (that [http://search.cpan.org/dist/Alien-wxWidgets/ Alien::wxWidgets] tries to solved) 
     151 * Installing wxPerl (the [http://search.cpan.org/dist/Wx/ Wx] distro) from CPAN. 
     152 
     153Mattia Barbon did a great job with them but they are still difficult to install.  
     154Any help with this would be welcome. See the [http://wxperl.sourceforge.net/ wxPerl] web site 
     155and mailing list. 
     156 
     157Additional help can be provided by: 
     158 
     159 1. Describing the results you have on various operating systems 
     160 1. Asking the various downstream distributors to include Padre 
     161 1. Creating a stand-alone version using PAR 
     162 
     163Help in any of those is appreciated. Please post links to any conversation you might 
     164have with the distro maintainers so others can follow up. 
     165 
     166== MS Windows == 
     167 
     168=== Strawberry Perl === 
     169Download Strawberry Perl from here: [http://www.strawberryperl.com/] 
     170 
     171On Strawberry Perl 5.10, starting from version 5.10.0.3 you  
     172can install Padre by starting the CPAN shell and typing 
     173{{{ 
     174  cpan> install Padre 
     175}}} 
     176 
     177However, before you do that, you may wish to install Alien::wxWidgets and Wx as .par files - they build on Windows, but on slower systems, they're... slow. 
     178 
     179{{{ 
     180  C:\>perl -MPAR::Dist -e"install_par(q(http://www.strawberryperl.com/download/padre/Alien-wxWidgets-0.46-MSWin32-x86-multi-thread-5.10.1.par))" 
     181  C:\>perl -MPAR::Dist -e"install_par(q(http://www.strawberryperl.com/download/padre/Wx-0.94-MSWin32-x86-multi-thread-5.10.1.par))" 
     182}}} 
     183 
     184'''Note''': installing Padre in a fresh install of Strawberry Perl can lead to weird behaviour, like preferences not being saved on exit (due to Padre crashing on exit). See the comments for #258 for a workaround. 
     185 
     186On previous releases of Strawberry Perl 5.10 you can install it  
     187following these steps 
     188{{{ 
     189  cpan> look Alien::wxWidgets 
     190  $ perl Makefile.PL 
     191  $ dmake 
     192  $ dmake test 
     193  $ dmake install 
     194  $ exit 
     195  cpan> look Wx 
     196  $ perl Makefile.PL 
     197  $ dmake 
     198  $ dmake test 
     199  $ dmake install 
     200  $ exit 
     201  cpan> install Padre 
     202}}} 
     203 
     204Once it is installed you can start Padre either by 
     205{{{ 
     206Start/Run and type in padre 
     207}}} 
     208 
     209 
     210or by creating a shortcut and then clicking on it. 
     211 
     212When creating the shortcut use the following as command: 
     213{{{ 
     214C:\strawberry\perl\bin\wperl.exe C:\strawberry\perl\bin\padre.bat 
     215}}} 
     216note we are using wperl here instead of perl in order to avoid the extra  
     217command shell window. 
     218 
     219'''Note''': For updating Padre on Strawberry Perl you can use the CPAN shell client of Strawberry:  
     220{{{ 
     221C:\strawberry\perl\bin\perl -MCPAN -e shell 
     222}}} 
     223 
     224{{{ 
     225upgrade Padre 
     226}}} 
     227 
     228To find whether there's an update - you can do:  
     229{{{ 
     230i /Padre/ 
     231}}} 
     232(or simply follow the mailing list ;-) 
     233 
     234 
     235 
     236=== Active Perl === 
     237 
     238[http://www.activestate.com/] 
     239 
     240Once you have installed Active Perl you need to configure two additional PPM 
     241repositories and then you can install Padre using the ppm pacakging system. 
     242Let's see how to do it in the Command Shell: 
     243 
     244{{{ 
     245Start/Run/cmd ENTER 
     246ppm rep add wxperl http://www.wxperl.co.uk/repository   
     247ppm rep add padre  http://www.perlide.org/download/ppm/ 
     248 
     249ppm install Alien-wxWidgets 
     250ppm install Wx 
     251ppm install Padre 
     252}}} 
     253 
     254You might have to install Alien-wxWidgets-gcc. If this conflicts with Alien-wxWidgets - you can try use --force:  
     255{{{ 
     256ppm install  Alien-wxWidgets-gcc  --force 
     257}}} 
     258 
     259Once that's done you can start Padre by typing 
     260{{{ 
     261perl c:\perl\site\bin\padre 
     262}}} 
     263or 
     264{{{ 
     265wperl c:\perl\site\bin\padre 
     266}}} 
     267 
     268Replace "c:\perl" with the path, where Active Perl is installed. 
     269 
     270==== Older Active Perl details ==== 
     271 
     272The manual installation is still a bit rough but we are working on improving it. 
     273 
     274 1) (A) Most of the modules - can be taken from the main  ActiveState Package Repository.  
     275 
     276 (B) For Active Perl there are prebuilt PPM versions of Alien::wxWidgets and Wx (aka. wxPerl) 
     277 and can be installed from [http://wxperl.co.uk/].  
     278 
     279 So add the wxperl repository to the PPM: http://www.wxperl.co.uk/repository 
     280 (for detailed instructions see http://wxperl.co.uk/ppm.html ) 
     281 (and even more info here http://docs.activestate.com/activeperl/5.10/faq/ActivePerl-faq2.html ) 
     282 
     283 Adding the repository to your PPM repository list:   
     284 In PPM4 (ActivePerl 820+) this is most easily done via the GUI menu option:  Edit -> Preferences.  
     285    
     286 If you use PPM3 - or used to command line (==DOS , still usable for PPM4) - you can do:  
     287   {{{ 
     288ppm rep add wxperl http://www.wxperl.co.uk/repository  
     289   }}} 
     290 
     291 
     292 
     293 
     294 2) Install all the packages (except of course perl) listed as "requires" on 
     295    http://svn.perlide.org/padre/trunk/Padre/Makefile.PL  - by using ppm.  
     296  Don't worry about the order of installation and report us any problem you encounter. 
     297 
     298  You can do in by searching the "requires" packages listed in the above link -  
     299  either by using the PPM4 GUI, or searching PPM command line (==DOS): 
     300  {{{ 
     301ppm search App::Ack 
     302  }}} 
     303 The result may look like this: 
     304   {{{ 
     305C:\Documents and Settings\orenm>ppm search App::Ack 
     306Downloading ActiveState Package Repository packlist...not modified 
     3071: ack 
     308   A grep-like program specifically for large source trees 
     309   Version: 1.86 
     310   Released: 2008-07-09 
     311   Author: Andy Lester <andy@petdance.com> 
     312   Provide: App::Ack version 1.86 
     313   Require: File::Basename 
     314   Require: File::Next version 0.4 or better 
     315   Require: Getopt::Long 
     316   Require: Term::ANSIColor 
     317   Require: Test::Harness version 2.5 or better 
     318   Require: Test::More 
     319   Repo: ActiveState Package Repository 
     320   CPAN: http://search.cpan.org/dist/ack-1.86/ 
     321 
     322C:\Documents and Settings\orenm> 
     323    }}} 
     324  So now you shall do:  
     325    {{{ 
     326ppm install ack 
     327    }}} 
     328 
     329 
     330 3) then open the cpan client and install Padre: 
     331{{{ 
     332  c:> perl -MCPAN -eshell 
     333  cpan> install Padre 
     334}}} 
     335 
     336Oren Maurer reported that you might need to force it: 
     337{{{ 
     338  cpan> force install Padre 
     339}}} 
     340 
     341 
     342at some point you might encounter an error like this: 
     343 
     344{{{ 
     345 Running install for module 'Padre' 
     346 Running make for S/SZ/SZABGAB/Padre-0.06.tar.gz 
     347 CPAN: Digest::SHA loaded ok (v5.45) 
     348 Fetching with LWP: 
     349  http://ppm.activestate.com/CPAN/authors/id/S/SZ/SZABGAB/CHECKSUMS 
     350 Alert: While trying to 'parse' YAML file 
     351  'D:\ActiveState\Perl\cpan\FTPstats.yml' 
     352 with 'YAML::XS' the following error was encountered: 
     353  Usage: YAML::XS::LibYAML::Load(yaml_str) at 
     354 D:\ActiveState\Perl\lib/YAML/XS.pm 
     355  line 70. 
     356}}} 
     357 
     358 
     359The reported solution was this: 
     360{{{ 
     361  [reach the cpan shell:] 
     362  C:\>cpan 
     363  cpan> o conf yaml_module '' 
     364  cpan> o conf commit 
     365  commit: wrote 'C:\Perl\lib/CPAN/Config.pm' 
     366  cpan> q 
     367}}} 
     368(See: [http://groups.google.com/group/de.comp.lang.perl.misc/browse_thread/thread/3a347d02a1ebf464] and 
     369[http://perl.org.il/pipermail/perl/2008-September/009779.html] ) 
     370 
     371Other things that to do and can help: 
     372 
     373   1. upgrading last version of Encode - using ppm ,  
     374 
     375   Note:  
     376      For upgrading all PPM packages, do this (Windows command line, a.k.a Dos) 
     377{{{ 
     378    ppm upgrade --install  
     379}}} 
     380   2. upgrade of Wx - also by using ppm , 
     381   3. installing Alien-wxWidgets (the same way... ppm), 
     382   4. And now - do (again with ppm): 
     383{{{ 
     384    ppm install  --force Alien-wxWidgets-dev 
     385}}} 
     386(See: [http://meorero.wordpress.com/2009/02/02/padre-on-ms-windows-with-activeperl-5100-build-1004/]) 
     387 
     388For more info about "ppm - Perl Package Manager, version 4" - see the ActivePerl 5.10 Documentation:  
     389http://docs.activestate.com/activeperl/5.10/bin/ppm.html 
     390 
     391 
     392== Debian == 
     393 
     394Latest Debian package is available at http://packages.debian.org/sid/main/padre 
     395(see Binary above) 
     396 
     397Until it is released, the key is to uninstall all wxwidgets and wxperl related packages, and to install enough of the -dev packages to allow Alien::wxWidgets to build version 2.8.8. Once that works, cpan install Wx and from there Padre should install (see the Subversion quick install instructions above for more) 
     398 
     399== Ubuntu == 
     400 
     401First, open a Terminal and run the following command to install some prerequisite packages. Without these dependencies the Alien::wxWidgets CPAN module will most likely fail to install (complaining that "configure can't find gtk.h"). By the time you read this some of these packages may be no longer be dependencies, but if in doubt you'll probably have the most success if you install them all. 
     402 
     403{{{  
     404$ sudo apt-get install libwxgtk2.8-0 libwxgtk2.8-dev libwxbase2.8-dev libwxbase2.8-0 libmodule-build-perl libextutils-cbuilder-perl \ 
     405                       libmodule-pluggable-perl g++ libgtk2.0-dev libgl1-mesa-dev libglu1-mesa-dev  
     406}}} 
     407 
     408You can then use the CPAN client to install Padre and its dependencies: 
     409 
     410{{{  
     411$ sudo cpan ExtUtils::CBuilder Alien::wxWidgets Wx Padre  
     412}}} 
     413 
     414 
     415 
     416For Ubuntu < 8.10, be sure to answer "yes" to the following question during the installation of {{{ Alien::wxWidgets }}} 
     417{{{  
     418Do you want to fetch and build wxWidgets from sources? [no] yes 
     419}}} 
     420 
     421Also note that for Ubuntu < 8.10, although {{{ libextutils-cbuilder-perl }}} is available from the repository, it only contains version 0.18, whereas Padre requires version 0.24 so you need to install ExtUtils::CBuilder from CPAN. 
     422 
     423Ubuntu is synchronizing Padre from Debian. See the launchpad for details: 
     424 * https://launchpad.net/ubuntu/+source/padre 
     425 * Its page in Launchpad is https://launchpad.net/padre 
     426 * link to where they import our SVN repository https://code.launchpad.net/~vcs-imports/padre/trunk 
     427 * See also #ubuntu-motu on Freenode 
     428 * https://edge.launchpad.net/~perl seems to be the group dealing with perl stuff, I sent them a message on 2009.02.06 asking for help 
     429 * https://edge.launchpad.net/~perl-jam might also help but that is a one man group so I left it alone for now. 
     430 
     431Some more useful links 
     432 * https://wiki.ubuntu.com/UbuntuDevelopment/NewPackages 
     433 * https://wiki.ubuntu.com/MOTU 
     434 * https://wiki.ubuntu.com/FAQ 
     435 
     436 * The request: https://bugs.launchpad.net/ubuntu/+bug/326353 
     437 
     438== Ubuntu 9.10 == 
     439 
     440If you installed padre from the .deb package you will still need to upgrade several modules. 
     441You will also neet to install a new version of Wx as there is some incompability with the way it was built. 
     442 
     443== Fedora == 
     444 
     445Fedora has wxPerl since at least FC8 
     446 
     447 * [http://www.redhat.com/archives/fedora-perl-devel-list/2008-July/msg00311.html] 
     448 * [http://www.redhat.com/archives/fedora-perl-devel-list/2008-August/msg00000.html] 
     449 
     450Fedora 8 has 
     451 
     452 * wxGTK-2.8.7 
     453 * perl-Wx-0.74 
     454 * perl-Alien-wxWidgets-0.31 
     455 
     456This should be sufficient: 
     457{{{ 
     458# rpm -ivh  perl-Wx perl-Alien-wxWidgets 
     459}}} 
     460 
     461Fedora 9 has 
     462 * wxGTK-2.8.7 
     463 * perl-Wx-0.81 
     464 * perl-Alien-wxWidgets-0.32 
     465 
     466This should be sufficient: 
     467{{{ 
     468# rpm -ivh  perl-Wx perl-Alien-wxWidgets 
     469}}} 
     470 
     471== Mandriva/Mandrake == 
     472 
     473Recent versions of Mandriva have Padre packaged - see above. 
     474 
     475=== Mandriva 2008.1 === 
     476has these: 
     477 * perl-Alien-wxWidgets   Version: 0.33-2mdv2008.1 
     478 * perl-Wx Version: 0.81-1mdv2008.1 
     479To install Padre follow these: 
     480 
     481{{{ 
     482# urpmi perl-Alien-wxWidgets 
     483# urpmi perl-Wx 
     484$ cpan 
     485cpan> install Padre 
     486}}} 
     487 
     488== FreeBSD == 
     489 
     490To run Padre on FreeBSD you have to recompile Perl to support threads (by default Perl on FreeBSD have it disabled). To verify whether your Perl installation have thread support turned on run following command. 
     491{{{ 
     492$ perl -V:usethreads 
     493usethreads='define'; 
     494}}} 
     495 
     496If the result is `define` then you have already threaded Perl installed, otherwise execute: 
     497{{{ 
     498# cd /usr/ports/lang/perl5.8 && make WITH_THREADS=yes 
     499# make deinstall && make reinstall 
     500}}} 
     501Optionally you can substitute `make WITH_THREADS=yes` with following and choose `THREADS` in the menu, then deinstall and reinstall Perl as above. This have an advantage over the previous method, because prefered configuration options will be stored in your system's packing database. This way next time you'll be building Perl (i.e. updaing) all stored options will be applied without the need to manually specify them. 
     502{{{ 
     503# make config 
     504# make 
     505}}} 
     506 
     507To install Padre and it's dependencies just execute: 
     508{{{ 
     509# cd /usr/ports/editors/p5-Padre 
     510# make install clean 
     511}}} 
     512 
     513== NetBSD/pkgsrc == 
     514 
     515To install Padre on NetBSD or any other pkgsrc supported platform, simply 
     516{{{ 
     517$ cd /usr/pkgsrc/editors/p5-Padre 
     518$ make install clean clean-depends 
     519}}} 
     520 
     521If you want to add plugin's, too, check which ones are already available: 
     522{{{ 
     523$ cd /usr/pkgsrc 
     524$ echo */p5-Padre-Plugin-* 
     525}}} 
     526 
     527For each desired plugin, change the working directory to it's location and install as done above. 
     528 
     529If you have trouble installing Padre using pkgsrc (and read the pkgsrc guide, mailing list archives and open PR's carefully), feel free to send your question to {{{ pkgsrc-p5-people }}} or {{{ pkgsrc-users }}} mailing list as found on {{{ http://www.netbsd.org/mailinglists/#descriptions-of-mailing-lists }}}. Although the import and maintaining is mostly done by Jens Rehsack, your chance getting feedback is better asking the proper mailing list instead of the primary maintainer. You might get questions answered on {{{ irc://irc.freenode.net/ }}} in the channel {{{ #pkgsrc }}}. 
     530 
     531== openSUSE == 
     532 
     533 1. [http://opensuse-community.org/Repositories/11.1 Add the packman repository.] 
     534 2. Install the package »wxWidgets-devel« and the schema »C/C++ Development«. 
     535[[Image(yast.png)]] 
     536 3. Install Padre from CPAN. 
     537 
     538Configure [http://search.cpan.org/perldoc?CPAN#Config_Variables make_install_make_command and mbuild_install_build_command] to enable {{{sudo}}} support in CPAN. 
     539 
     540== Gentoo == 
     541 
     542Has Wx version 0.82 
     543 
     544[http://www.nntp.perl.org/group/perl.wxperl.users/2008/07/msg5993.html] 
     545 
     546{{{ 
     547   g-cpan -i Padre 
     548}}} 
     549 
     550should work but you need a threaded perl. If you have trouble 
     551installing please file a bug here or on [http://bugs.gentoo.org] 
     552depending where do you think the problem is. 
     553 
     554More detailed instructions: 
     555 
     556 1. Make sure your perl is compiled with USE="ithreads" ( generally in /etc/make.conf ) and `emerge perl` 
     557 2. If you don't have g-cpan installed, `emerge app-portage/g-cpan` 
     558 3. g-cpan -i Padre 
     559 
     560 
     561g-cpan often is [http://bugs.gentoo.org/show_bug.cgi?id=99569 incapable of properly detecting dependencies]. Installing from source often works better: 
     562 
     563{{{ 
     564   emerge dev-perl/Alien-wxWidgets dev-perl/wxperl 
     565   perl -MCPAN -e 'install Padre' 
     566}}} 
     567 
     568Note: this method is only recommended if g-cpan fails to recursively install dependencies that the CPAN shell would otherwise identify. 
     569 
     570Installing Padre from the CPAN shell may upgrade core modules provided by the core Gentoo perl install, so be prepared to downgrade those modules when emerging other packages or upgrading the system. A 'force install Padre' afterwards can help upgrade the conflicts again. 
     571 
     572Also, one or more of the modules may require perl 5.10. This is not a part of any portage tree as of yet and can only be found in the perl overlay. See [http://bugs.gentoo.org/show_bug.cgi?id=206455 Gentoo Bug#206455]. 
     573 
     574 
     575 
     576== OS X == 
     577 
     578On OS X, you cannot use the system's 'perl' executable, you have to use the 'wxPerl' executable (see this [http://www.nntp.perl.org/group/perl.wxperl.users/2008/07/msg5978.html thread regarding wxPerl invocation]). 
     579 
     580Installation using [http://padre.perlide.org/trac/wiki/Download#NetBSDpkgsrc pkgsrc] should also work. 
     581 
     582=== Install everything from source === 
     583 
     584The most straightforward method is to install everything from source. This will ignore any existing wxwidgets installation. 
     585 
     586 1. $ wxPerl -MCPAN -eshell 
     587 1. [cpan] $ install Alien::wxWidgets [choose install from source, which is NOT the default] 
     588 1. Go do something else while it compiles wxWidgets. 
     589 1. [cpan] $ install Wx 
     590 1. [cpan] $ install Padre 
     591 
     592Padre has a LOT of prerequisites. You're likely to run into some problems with tests failing. IPC::Run3 was a particular problem due to its prerequisites, but a later individual install worked fine. Just make your way through them all, and 'force notest install $module' as needed. Once you've got padre installed you start it by running /usr/local/bin/padre. 
     593 
     594=== Taking the lazy way === 
     595 
     596If you're lazy and enjoy taking risks... the easiest way to install on OSX may be (there will be some test failures - which you'll have to force install, including Padre itself, due to wxPerl issues):  
     597 
     598{{{ 
     599cpan Alien::wxWidgets 
     600wxPerl -MCPAN -eshell 
     601 $ install Padre 
     602}}} 
     603and then replace the /usr/local/bin/padre script with the updated version at http://padre.perlide.org/trac/browser/trunk/Padre/script/padre 
     604 
     605If you are risk averse and like playing in your own sandbox, then it is recommended that you download and compile the current release of Perl from source ([http://cpan.org/src/README.html]). Note: you'll need to run ./Configure with -Dusethreads. After which you won't need to use wxPerl, but can do the standard make, make test, make install of Padre via cpan. 
     606 
     607After installing Alien::wxWidget there are new versions of wx-config and wxrc somewhere in your Perl Library Path, (mine went under  site_perl/darwin-thread-multi-2level/Alien/wxWidgets/mac_2_8_10_uni/bin), which need to be first in your PATH, otherwise Wx might build against the wrong Library. As an alternative you can set an environment variable WX_CONFIG which has to point to the new wx-config executable. See the Wx docs for more info. 
     608 
     609Another caveat: don't build inside of a gnu-screen or ssh session, otherwise Wx's tests will fail with a strange errormessage, stating that it can't create the clipboard because of permission problems. 
     610 
     611 
     612---- 
     613 
     614OS X 10.4 has wxPerl 0.22, 10.5 has a more recent version (0.6x for some x) 
     615 
     616Aside from building from source, you can also install newer versions of Wx on OS X using a package manager: 
     617 
     618[http://www.finkproject.org/ Fink] 
     619{{{ 
     620fink install wxmac28 
     621}}} 
     622 
     623[http://www.macports.org/ Mac Ports] 
     624{{{ 
     625port install wxWidgets 
     626}}} 
     627 
     628== installing _and_ upgrading wxWidgets and wxPerl == 
     629 
     630If you have trouble you can check which version of wxWidgets you have: 
     631 
     632{{{ 
     633$ perl -MWx -le'print  "Wx Version: $Wx::VERSION " . Wx::wxVERSION_STRING()' 
     634}}} 
     635 
     636and on Mac:  
     637 
     638{{{ 
     639$ wxPerl -MWx -le'print  "Wx Version: $Wx::VERSION " . Wx::wxVERSION_STRING()' 
     640}}} 
     641 
     642We use Wx 0.87 and wxWidgets 2.8.8 so you probably should have those (or newer) too. 
     643 
     644When installing Alien::wxWidgets it will ask if you want to compile wxWidgets.  
     645'''Do you want to fetch and build wxWidgets from sources?''' 
     646If you don't have any installed or if you have an old version (< 2.8.8) then you should answer yes. 
     647It will try to download the source code of wxWidgets which is big and the download often fails. 
     648 
     649To get around that you can download the file manually and put it in the extracted directory of 
     650Alien::wxWidgets. 
     651 
     652Something like this: 
     653 
     654{{{ 
     655 $ cd /tmp 
     656 $ wget http://prdownloads.sourceforge.net/wxwindows/wxWidgets-2.8.8.tar.gz 
     657 $ cpan 
     658 cpan> look Alien::wxWidgets 
     659 $ cp /tmp/wxWidgets-2.8.8.tar.gz . 
     660 $ perl Makefile.PL 
     661 $ make 
     662 $ make test 
     663 $ make install 
     664 $ exit 
     665 cpan>quit 
     666 $ 
     667}}} 
     668[http://www.nntp.perl.org/group/perl.wxperl.users/2008/07/msg5992.html wxPerl on Linux distributions] 
     669 
     670 
     671= More detailed instruction for manual installation = 
     672(tested on Debian Lenny) 
     673 * make sure your cpan works - make, gcc, etc 
     674 * make sure you remove all traces of wxWidgets 2.6 from your system 
     675 * install wxwidgets (2.8 or later) - cpan Alien::wxWidgets will download and compile and install it for you 
     676 * install (or upgrade) Wx - cpan Wx 
     677 * install Module::Install (if its not already there) 
     678 * add the following settings to cpan 
     679{{{ 
     680  o conf build_requires_install_policy yes ;  o conf commit 
     681  o conf prerequisites_policy follow ; o conf commit 
     682}}} 
     683 * svn co http://svn.perlide.org/padre/trunk/Padre Padre 
     684 * cd Padre 
     685 * sudo cpan . 
     686 * perl dev.pl 
     687 
     688For a complete checkout including all Padre plugins, branches and supporting stuff, use http://svn.perlide.org/padre/trunk but be warned - this is a huge amount of source! If you're using git-svn , you can use the --revision argument to limit from where git-svn starts fetching revision