From: Oliver Charles Date: Mon, 25 Jan 2010 01:03:52 +0000 (+0000) Subject: Improve the documentation about -Home and how Catalyst finds the home path for apps X-Git-Tag: 5.80019~10 X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?p=catagits%2FCatalyst-Runtime.git;a=commitdiff_plain;h=d7a8260570036621e91cd9b1bfc5d559ed2efabb Improve the documentation about -Home and how Catalyst finds the home path for apps --- diff --git a/lib/Catalyst.pm b/lib/Catalyst.pm index b243772..a0bb135 100644 --- a/lib/Catalyst.pm +++ b/lib/Catalyst.pm @@ -262,6 +262,14 @@ is replaced with the uppercased name of your application, any "::" in 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), 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';