From: Jay Hannah <jay@jays.net>
Date: Tue, 10 Mar 2009 20:51:43 +0000 (+0000)
Subject: debug() POD rewrite
X-Git-Tag: 5.80001~64
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?p=catagits%2FCatalyst-Runtime.git;a=commitdiff_plain;h=c74d3f0cc6e5912895ffae0d0f11f45cd64f6676

debug() POD rewrite
---

diff --git a/Changes b/Changes
index facae4e..426961e 100644
--- a/Changes
+++ b/Changes
@@ -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
diff --git a/lib/Catalyst.pm b/lib/Catalyst.pm
index 1fbccdd..39cbdea 100644
--- a/lib/Catalyst.pm
+++ b/lib/Catalyst.pm
@@ -846,10 +846,14 @@ L<Catalyst::Log>.
 
 =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