[Catalyst-commits] r14545 - trunk/examples/CatalystAdvent/root/2014

[jnapiorkowski at dev.catalyst.perl.org]

Author: jnapiorkowski
Date: 2014-12-11 02:59:50 +0000 (Thu, 11 Dec 2014)
New Revision: 14545

Added:
   trunk/examples/CatalystAdvent/root/2014/9.pod
Log:
9

Added: trunk/examples/CatalystAdvent/root/2014/9.pod
===================================================================
--- trunk/examples/CatalystAdvent/root/2014/9.pod	                        (rev 0)
+++ trunk/examples/CatalystAdvent/root/2014/9.pod	2014-12-11 02:59:50 UTC (rev 14545)
@@ -0,0 +1,36 @@
+=head1 Taking better advantage of your full terminal width for debugging 
+
+=head1 Discussion
+
+When you start L<Catalyst in debug mode, you get the running debug information
+to your terminal.  Useful stuff!  However by default the terminal output is set
+to 80 columns.  If you use a differnt terminal width you can do the following
+to get Catalyst to take advantage:
+
+Set COLUMNS in your shell to the correct width.  For bash users you can do this:
+
+    export COLUMNS=$COLUMNS
+
+Install L<Term::Size::Any>, which will detect the current window width and just
+use that.  I often add this as a developer requirement.
+
+What if you like to resize your terminal?  We added a feature that lets you
+instruct Catalyst to reset the debugging columns!  You can add something
+like this if in development:
+
+    $SIG{WINCH} = sub { Catalyst::Utils::term_width(1) };
+
+See L<https://metacpan.org/pod/Catalyst::Utils#term_width> for more.
+
+If this turns out to be broadly stable we might add it to core at some
+point.
+
+=head1 Conclusion
+
+Thanks to frew for the new reset term width feature!
+
+=head1 Author
+
+John Napiorkowski L<jjnapiork at cpan.org|email:jjnapiork at cpan.org>
+
+=cut