[Bps-public-commit] r15980 - Module-Install-RTx/lib/Module/Install

ruz at bestpractical.com ruz at bestpractical.com
Mon Sep 15 15:30:08 EDT 2008

Author: ruz
Date: Mon Sep 15 15:30:08 2008
New Revision: 15980


* update docs: synopsis and add CAVEATS section

Modified: Module-Install-RTx/lib/Module/Install/RTx.pm
--- Module-Install-RTx/lib/Module/Install/RTx.pm	(original)
+++ Module-Install-RTx/lib/Module/Install/RTx.pm	Mon Sep 15 15:30:08 2008
@@ -193,11 +193,11 @@
 =head1 SYNOPSIS
-In the F<Makefile.PL> of the C<RTx-Foo> module:
+In the F<Makefile.PL> of the C<RT-Extension-Foo> module:
     use inc::Module::Install;
-    RTx 'Foo';
-    WriteAll;
+    RTx 'RT-Extension-Foo';
+    WriteAll();
@@ -235,6 +235,24 @@
     perl Makefile.PL WITH_SUBDIRS=sbin
+=head1 CAVEATS
+=over 4
+=item * Use full name when call RTx method in Makefile.PL, some magic has been
+implemented in this installer to support RTx('Foo') for 'RTx-Foo' extension, but
+life proved that it's bad idea. Code still there for backwards compatibility.
+It will be deleted eventually.
+=item * installer want work with RT 3.8.0, as it has some bugs new plugins
+=item * layout of files has been changed between RT 3.6 and RT 3.8, old files
+may influence behaviour of your extension. Recommend people use clean dir on
+upgrade or guide how to remove old versions of your extension.
 =over 4

More information about the Bps-public-commit mailing list