make note to use default_view
[catagits/Catalyst-Manual.git] / lib / Catalyst / Manual / Tutorial / 02_CatalystBasics.pod
index 4c44d1d..6bd418c 100644 (file)
@@ -190,11 +190,11 @@ previous step):
 
 B<Note>: The "-r" argument enables reloading on code changes so you 
 don't have to stop and start the server when you update code. See 
-C<perldoc script/hello_server.pl> for additional options you might find 
-helpful. Most of the rest of the tutorial will assume that you are using 
-"-r" when you start the development server, but feel free to manually 
-start and stop it (use C<Ctrl-C> to break out of the dev server) if you 
-prefer. 
+C<perldoc script/hello_server.pl> or C<script/hello_server.pl --help>
+for additional options you might find helpful. Most of the rest of the
+tutorial will assume that you are using "-r" when you start the development
+server, but feel free to manually start and stop it (use C<Ctrl-C> to
+breakout of the dev server) if you prefer. 
 
     $ script/hello_server.pl -r
     [debug] Debug messages enabled
@@ -381,8 +381,10 @@ The "view" keyword tells the create script that you are creating a view.
 =item *
 
 The first "TT" tells the script to name the View module "TT.pm", which is a
-commonly used name for TT views.  (You can name it anything you want, such as
-"HTML.pm".)
+commonly used name for TT views.  You can name it anything you want, such as
+"HTML.pm". If you name it something other than TT.pm be sure to set the
+default_view in Hello.pm (See L<Catalyst::View::TT|Catalyst::View::TT> for
+more details on setting this).
 
 =item *
 
@@ -407,7 +409,7 @@ chapters of the tutorial).
 Create a C<root/hello.tt> template file (put it in the C<root> under 
 the C<Hello> directory that is the base of your application). Here is 
 a simple sample:
-  
+
     <p>
         This is a TT view template, called '[% template.name %]'.
     </p>
@@ -442,6 +444,11 @@ using the "-r" option -- manually restart it if you aren't),
 and look at L<http://localhost:3000/hello> in your again. You 
 should see the template that you just made.
 
+B<TIP:> If you keep the server running with "-r" in a "background 
+window," don't let that window get totally hidden... if you have an 
+syntax error in your code, the debug server output will contain the 
+error information.
+
 B<Note:> You will probably run into a variation of the "stash"
 statement above that looks like: