wiki:Development

Version 17 (modified by szabgab, 5 years ago) (diff)

--

Development

We are using Subversion for version control. The main development is in the trunk http://svn.perlide.org/padre/trunk/Padre. There is a separate directory for plug-ins and spin-off projects: http://svn.perlide.org/padre/trunk

  • see Download for installation information

see the http://search.cpan.org/~szabgab/Padre/lib/Padre/Manual/Hacking.pod file for Core Padre development and http://search.cpan.org/~szabgab/Padre/lib/Padre/Plugin.pm for Plugin development.

Translation

See TranslationIntro

Release and Distribution

Release of Padre

As of release 0.21 we started a rotation of release managers for Padre. See Release_History

  • Obtain co-maintenance permissions for all of the namespaces in the Padre distribution. Talk to Gábor Szabó (szabgab), Adam Kennedy (Alias), or Steffen Müller (tsee) about this.
  • cd to trunk/Padre
  • Make sure the Changes file is up to date and manually update if necessary, add the vX.XX Date string at the top (commit)
  • run perl ../tools/tidy_pm_files.pl that will apply blessed padre style in every module. (commit)
  • run perl ../tools/update_version_number.pl VERSION that will update the version number in every module and report if there was no VERSION entry in a module. Those need to be fixed. (commit)
  • run perl ../tools/release.pl REV VERSION [--tag] will try to create a distribution using a temporary directory and copy the resulting Padre-X.XX.tar.gz in the current directory. The optional --tag flag will also create a tag in SVN. So the release manager first can run it dry and when she is sure it creates a good release can run it again to also tag it in SVN.
  • Upload to http://perlide.org/download/source/ (needs to be done by Gabor)
  • try installing it using pip, tell people on IRC #padre about it
  • Upload to PAUSE
  • Send announcement to padre-dev mailing list
  • Send announcement to padre-news mailing list (Gabor needs to approve the message)
  • Submit announcement to http://use.perl.org/
  • Update the Release History
  • Add the version number to the list of versions in Trac (Gabor needs to do this)
  • Important: Assign primary maintainer status to Gabor (PAUSE ID 'SZABGAB') for all namespaces that are new in the current release.
    • Log into your PAUSE account
    • Click "View Permissions" in the menu
    • Note all Padre::* classes for which you are listed as "first-come" (as opposed to "co-maint").
    • Click "Change Permissions" in the menu
    • Under "2. You are primary maintainer:" select any one or all of the Padre::* namespaces that appear in the list view.
    • Click Select for "2.1 Pass primary maintainership status to somebody else (giving it up at the same time)"
    • Make sure all Padre::* namespaces are selected in the new listbox.
    • Enter "SZABGAB" in the text field.
    • Click "Pass Maintainership Status".
    • You will automatically become co-maintainer instead of primary maintainer of the classes in question.
  • ppm creation:
  • Create executable for Linux:

Distribution of Padre

The primary distribution channel of Padre is CPAN. Hence for every release first we create a CPAN distribution of Padre. (See above).

Based on the CPAN package Gabor release Padre on Portable Strawberry.

Later, based on the CPAN package the downstream distributors create their .deb and .rpm etc.

Plans:

  • Stand-alone executable for
  • * Linux.
  • * Windows
  • * Mac
  • Packaging Padre in the various distributions such as Debian, Fedora, Mandriva, Ubuntu or FreeBSD
  • Chocolate Perl should include Padre with various plug-ins

See also the Download page

Distribution of Plugins and other packages

TBD.

The use of the release.pl script as above

No need to keep MANIFEST and META.yml in version control!

Add to MANIFEST.SKIP

# avoid po and pot files (gettext)
\.pot$
\.po$

If you are using Module::Build

Don't add a Makefile.PL to the version control as it will be created during packaging

Add the following to Build.PL to include the generated .mo files

$builder->add_build_element('mo');