Apply patch with a gotcha from the mailing list

diff --git a/Changes b/Changes
index a8cce68..c99f0b7 100644 (file)
--- a/Changes
+++ b/Changes
@@ -5,6 +5,8 @@ Revision history for Perl extension Catalyst::View::TT.
           + Expand ::V:: to ::View:: (RT #45792)
           + Expand ::C:: to ::Controller:: and use $c->view('TT')
             where appropriate (bricas)
+          + Add note about use CGI in a template making Catalyst hang
+            (Gunnar Strand)
         - "use warnings" in Catalyst::View::TT and output from the TT helper
         - Expand TTSite documentation (RT #33838)
 

diff --git a/lib/Catalyst/View/TT.pm b/lib/Catalyst/View/TT.pm
index 7b6699f..f60af73 100644 (file)
--- a/lib/Catalyst/View/TT.pm
+++ b/lib/Catalyst/View/TT.pm
@@ -625,6 +625,17 @@ further.  It also creates a default set of templates to get you
 started.  It also configures the view module to locate the templates
 automatically.
 
+=head1 NOTES
+
+If you are using the L<CGI> module inside your templates, you will
+experience that the Catalyst server appears to hang while rendering
+the web page. This is due to the debug mode of L<CGI> (which is
+waiting for input in the terminal window). Turning off the
+debug mode using the "-no_debug" option solves the
+problem, eg.:
+
+    [% USE CGI('-no_debug') %]
+
 =head1 SEE ALSO
 
 L<Catalyst>, L<Catalyst::Helper::View::TT>,