From: Matt S Trout <mst@shadowcat.co.uk>
Date: Thu, 8 Jun 2006 14:38:26 +0000 (+0000)
Subject: Tut docs work
X-Git-Tag: 5.7099_04~529
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?p=catagits%2FCatalyst-Runtime.git;a=commitdiff_plain;h=c19d127ebfc41407188cbb614c47635b312aad7e

Tut docs work
r9736@cain (orig r4285):  jester | 2006-06-05 03:03:00 +0000
---

diff --git a/lib/Catalyst/Manual/Tutorial/Authentication.pod b/lib/Catalyst/Manual/Tutorial/Authentication.pod
index 4531517..1626b1c 100644
--- a/lib/Catalyst/Manual/Tutorial/Authentication.pod
+++ b/lib/Catalyst/Manual/Tutorial/Authentication.pod
@@ -339,7 +339,6 @@ Edit C<lib/MyApp.pm> and update it as follows (everything below C<DefaultEnd> is
             ConfigLoader
             Static::Simple
             
-            Dumper
             StackTrace
             DefaultEnd
             
diff --git a/lib/Catalyst/Manual/Tutorial/Authorization.pod b/lib/Catalyst/Manual/Tutorial/Authorization.pod
index 0babb83..d194e5e 100644
--- a/lib/Catalyst/Manual/Tutorial/Authorization.pod
+++ b/lib/Catalyst/Manual/Tutorial/Authorization.pod
@@ -80,7 +80,6 @@ Edit C<lib/MyApp.pm> and add C<Authorization::Roles> to the list:
             ConfigLoader
             Static::Simple
             
-            Dumper
             StackTrace
             DefaultEnd
             
diff --git a/lib/Catalyst/Manual/Tutorial/CatalystBasics.pod b/lib/Catalyst/Manual/Tutorial/CatalystBasics.pod
index c7c752f..fb62a9d 100644
--- a/lib/Catalyst/Manual/Tutorial/CatalystBasics.pod
+++ b/lib/Catalyst/Manual/Tutorial/CatalystBasics.pod
@@ -292,7 +292,6 @@ Replace it with:
             ConfigLoader
             Static::Simple
             
-            Dumper
             StackTrace
             DefaultEnd
             /;
@@ -303,28 +302,14 @@ This tells Catalyst to start using three new plugins:
 
 =item * 
 
-L<Catalyst::Plugin::Dumper>
-
-Allows you to easily use L<Data::Dumper> to dump variables
-to the logs, for example:
-
-    $c->log->dumper($myvar);
-
-When running your application under the development server, the logs
-will be printed to your screen along with the other debug information
-generated by the C<-Debug> flag.
-
-=item * 
-
 L<Catalyst::Plugin::StackTrace|Catalyst::Plugin::StackTrace>
 
 Adds a stack trace to the standard Catalyst "debug screen" (this is the
 screen Catalyst sends to your browser when an error occurs).
 
-Note: L<Dumper|Catalyst::Plugin::Dumper> output appears on the console
-window where you issue the C<script/myapp_server.pl> command.
-L<StackTrace|Catalyst::Plugin::StackTrace> output appears in your
-browser.
+Note: L<StackTrace|Catalyst::Plugin::StackTrace> output appears in your
+browser, not in the console window from which you're running your
+application, which is where logging output usually goes.
 
 =item * 
 
@@ -862,7 +847,6 @@ You should get something like this:
     .------------------------------------------------------------------------------.
     | Catalyst::Plugin::ConfigLoader 0.07                                          |
     | Catalyst::Plugin::Static::Simple 0.14                                        |
-    | Catalyst::Plugin::Dumper 0.000002                                            |
     | Catalyst::Plugin::StackTrace 0.04                                            |
     | Catalyst::Plugin::DefaultEnd 0.06                                            |
     '------------------------------------------------------------------------------'
diff --git a/lib/Catalyst/Manual/Tutorial/Debugging.pod b/lib/Catalyst/Manual/Tutorial/Debugging.pod
index d65f842..adc4d62 100644
--- a/lib/Catalyst/Manual/Tutorial/Debugging.pod
+++ b/lib/Catalyst/Manual/Tutorial/Debugging.pod
@@ -2,8 +2,6 @@
 
 Catalyst::Manual::Tutorial::Debugging - Catalyst Tutorial - Part 6: Debugging
 
-
-
 =head1 OVERVIEW
 
 This is B<Part 6 of 9> for the Catalyst tutorial.
@@ -46,18 +44,18 @@ L<AdvancedCRUD|Catalyst::Manual::Tutorial::AdvancedCRUD>
 
 =item 9
 
-L<Appendicies|Catalyst::Manual::Tutorial::Appendicies>
+L<Appendices|Catalyst::Manual::Tutorial::Appendices>
 
 =back
 
 
-
 =head1 DESCRIPTION
 
 This part of the tutorial takes a brief look at the primary options
 available for troubleshooting Catalyst applications.
 
-Note that when it comes to debugging and troubleshooting, there are two camps:
+Note that when it comes to debugging and troubleshooting, there are two
+camps:
 
 =over 4
 
@@ -73,31 +71,29 @@ Fans of interactive debuggers.
 
 Catalyst is able to easily accommodate both styles of debugging.
 
-
-
 =head1 LOG STATEMENTS
 
 Folks in the former group can use Catalyst's C<$c-E<gt>log> facility.
-For example, if you add the following code to a controller action
-method:
+(See L<Catalyst::Log> for more detail.) For example, if you add the
+following code to a controller action method:
 
-    $c->log->debug("This is a test log message");
+    $c->log->info("Starting the foreach loop here");
+
+    $c->log->debug("Value of $id is: ".$id);
 
 Then the Catalyst development server will display your message along
-with the other debug output.  To accomplish the same thing in a TTSite
+with the other debug output. To accomplish the same thing in a TTSite
 view use:
 
     [% Catalyst.log.debug("This is a test log message") %]
 
-You can also use L<Data::Dumper|Data::Dumper> in both Catalyst code
-(C<$c-E<gt>log-E<gt>dumper($myvar)>) and TT templates (C<[%
-Dumper.dump(book) %]> as discussed in earlier parts of the tutorial.
-
-
+You can also use L<Data::Dumper> in both Catalyst code (C<use
+Data::Dumper; $c-E<gt>log-E<gt>debug("$var is: ".Dumper($var));)>) and
+TT templates (C<[% Dumper.dump(book) %]>.
 
 =head1 RUNNING CATALYST UNDER THE PERL DEBUGGER
 
-Members of the interactive debuggers fan club will also be at home with
+Members of the interactive-debugger fan club will also be at home with
 Catalyst applications.  One approach to this style of Perl debugging is
 to embed breakpoints in your code.  For example, open
 C<lib/MyApp/Controller/Books.pm> in your editor and add the
@@ -233,15 +229,14 @@ For more information on using the Perl debugger, please see C<perldebug>
 and C<perldebtut>.  You can also type C<h> or C<h h> at the debugger
 prompt to view the built-in help screens.
 
-
-
 =head1 AUTHOR
 
 Kennedy Clark, C<hkclark@gmail.com>
 
 Please report any errors, issues or suggestions to the author.
 
-Copyright 2006, Kennedy Clark, under Creative Commons License (L<http://creativecommons.org/licenses/by-nc-sa/2.5/>).
+Copyright 2006, Kennedy Clark, under Creative Commons License
+(L<http://creativecommons.org/licenses/by-nc-sa/2.5/>).
 
 Version: .94
 
diff --git a/lib/Catalyst/Manual/Tutorial/Intro.pod b/lib/Catalyst/Manual/Tutorial/Intro.pod
index da1a8e6..8be29a7 100644
--- a/lib/Catalyst/Manual/Tutorial/Intro.pod
+++ b/lib/Catalyst/Manual/Tutorial/Intro.pod
@@ -197,10 +197,6 @@ Catalyst::Plugin::DefaultEnd -- 0.06
 
 =item *
 
-Catalyst::Plugin::Dumper -- 0.000002
-
-=item *
-
 Catalyst::Plugin::HTML::Widget -- 1.1
 
 =item *