[Catalyst-commits] r9486 - in Catalyst-Runtime/5.80/trunk: . lib

[jhannah at dev.catalyst.perl.org]

Author: jhannah
Date: 2009-03-10 20:51:43 +0000 (Tue, 10 Mar 2009)
New Revision: 9486

Modified:
   Catalyst-Runtime/5.80/trunk/Changes
   Catalyst-Runtime/5.80/trunk/lib/Catalyst.pm
Log:
debug() POD rewrite


Modified: Catalyst-Runtime/5.80/trunk/Changes
===================================================================
--- Catalyst-Runtime/5.80/trunk/Changes	2009-03-10 17:11:33 UTC (rev 9485)
+++ Catalyst-Runtime/5.80/trunk/Changes	2009-03-10 20:51:43 UTC (rev 9486)
@@ -1,5 +1,6 @@
 # This file documents the revision history for Perl extension Catalyst.
 
+        - debug() POD rewrite (jhannah)
         - Change the warning when you have conflicting components to
           present a list (t0m)
         - Move NEXT use and testing deprecated features out to its own

Modified: Catalyst-Runtime/5.80/trunk/lib/Catalyst.pm
===================================================================
--- Catalyst-Runtime/5.80/trunk/lib/Catalyst.pm	2009-03-10 17:11:33 UTC (rev 9485)
+++ Catalyst-Runtime/5.80/trunk/lib/Catalyst.pm	2009-03-10 20:51:43 UTC (rev 9486)
@@ -846,11 +846,15 @@
 
 =head2 $c->debug
 
-Overload to enable debug messages (same as -Debug option).
+Returns 1 if debug mode is enabled, 0 otherwise.
 
-Note that this is a static method, not an accessor and should be overloaded
-by declaring "sub debug { 1 }" in your MyApp.pm, not by calling $c->debug(1).
+You can enable debug mode in several ways: 
+(1) with the environment variables MYAPP_DEBUG, or CATALYST_DEBUG
+(2) the -Debug option in your MyApp.pm 
+(3) by declaring "sub debug { 1 }" in your MyApp.pm. 
 
+Calling $c->debug(1) has no effect.
+
 =cut
 
 sub debug { 0 }