[Catalyst-commits] r12726 - Catalyst-Runtime/5.80/trunk/lib

[aCiD2 at dev.catalyst.perl.org]

Author: aCiD2
Date: 2010-01-25 01:03:52 +0000 (Mon, 25 Jan 2010)
New Revision: 12726

Modified:
   Catalyst-Runtime/5.80/trunk/lib/Catalyst.pm
Log:
Improve the documentation about -Home and how Catalyst finds the home path for apps

Modified: Catalyst-Runtime/5.80/trunk/lib/Catalyst.pm
===================================================================
--- Catalyst-Runtime/5.80/trunk/lib/Catalyst.pm	2010-01-24 19:41:17 UTC (rev 12725)
+++ Catalyst-Runtime/5.80/trunk/lib/Catalyst.pm	2010-01-25 01:03:52 UTC (rev 12726)
@@ -262,6 +262,14 @@
 the name will be replaced with underscores, e.g. MyApp::Web should use
 MYAPP_WEB_HOME. If both variables are set, the MYAPP_HOME one will be used.
 
+If none of these are set, Catalyst will attempt to automatically detect the
+home directory. If you are working in a development envirnoment, Catalyst
+will try and find the directory containing either Makefile.PL, Build.PL or
+dist.ini. If the application has been installed into the system (i.e.
+you have done C<make install>), then Catalyst will use the path to your
+application module, without the .pm extension (ie, /foo/MyApp if your
+application was installed at /foo/MyApp.pm)
+
 =head2 -Log
 
     use Catalyst '-Log=warn,fatal,error';