Runtime/Devel changes

[catagits/Catalyst-Manual.git] / lib / Catalyst / Manual / Tutorial / MoreCatalystBasics.pod

diff --git a/lib/Catalyst/Manual/Tutorial/MoreCatalystBasics.pod b/lib/Catalyst/Manual/Tutorial/MoreCatalystBasics.pod
index afb0a7b..e15c9c1 100644 (file)
--- a/lib/Catalyst/Manual/Tutorial/MoreCatalystBasics.pod
+++ b/lib/Catalyst/Manual/Tutorial/MoreCatalystBasics.pod
@@ -140,22 +140,23 @@ very similar to Apache configuration files.  We will see how to use
 this feature of Catalyst during the authentication and authorization
 sections (Part 5 and Part 6).
 
-B<IMPORTANT NOTE>: If you are following along in Ubuntu 8.04 or 
-otherwise using a version of Catalyst prior to v5.7014, you need to be 
-aware that Catalyst changed from a default format of YAML to the more 
-straightforward C<Config::General> format.  Because Catalyst has long 
-supported both formats, this tutorial will simply use a configuration 
-file called C<myapp.conf> instead of C<myapp.yml> and Catatlyst will 
-automcatically use the new format.  Just be aware that earlier versions 
-of Catalyst will still create the C<myapp.yml> file and that you will 
-need to B<remove C<myapp.yml>> and create a new C<myapp.conf> file by 
-hand, but otherwise this transition is very painless.  The default 
-contents of C<myapp.conf> should only consist of one line: C<name 
-MyApp>.  Also be aware that you can continue to use any format
-supported by 
-L<Catalyst::Plugin::ConfigLoader|Catalyst::Plugin::ConfigLoader> and 
-L<Config::Any|Config::Any>, including YAML -- Catalyst will 
-automatically look for any of the supported configuration file formats.
+B<IMPORTANT NOTE>: If you are following along in Ubuntu 8.04 or
+otherwise using a version of L<Catalyst::Devel|Catalyst::Devel> prior
+to version 1.06, you need to be aware that Catalyst changed from a
+default format of YAML to the more straightforward C<Config::General>
+format.  Because Catalyst has long supported both formats, this
+tutorial will simply use a configuration file called C<myapp.conf>
+instead of C<myapp.yml> and Catatlyst will automcatically use the new
+format.  Just be aware that earlier versions of Catalyst will still
+create the C<myapp.yml> file and that you will need to B<remove
+C<myapp.yml>> and create a new C<myapp.conf> file by hand, but
+otherwise this transition is very painless.  The default contents of
+C<myapp.conf> should only consist of one line: C<name MyApp>.  Also be
+aware that you can continue to use any format supported by
+L<Catalyst::Plugin::ConfigLoader|Catalyst::Plugin::ConfigLoader> and
+L<Config::Any|Config::Any>, including YAML -- Catalyst will
+automatically look for any of the supported configuration file
+formats.
 
 C<TIP>: This script can be useful for converting between configuration 
 formats:
@@ -621,6 +622,12 @@ the schema information from the database every time the application
 starts.  And finally, C<dbi:SQLite:myapp.db> is the standard DBI connect 
 string for use with SQLite.
 
+B<NOTE>: Although the C<create=dynamic> option to the DBIC helper
+makes for a nifty demonstration, is only really suitable for very
+small applications. After this demonstration, you should almost always
+use the C<create=static> option that we switch to below.
+
+
 =head1 RUN THE APPLICATION
 
 First, let's enable an environment variable option that causes
@@ -657,7 +664,7 @@ Your development server log output should display something like:
     [debug] Loaded dispatcher "Catalyst::Dispatcher"
     [debug] Loaded engine "Catalyst::Engine::HTTP"
     [debug] Found home "/home/me/MyApp"
-    [debug] Loaded Config "/home/me/MyApp/myapp.yml"
+    [debug] Loaded Config "/home/me/MyApp/myapp.conf"
     [debug] Loaded components:
     .-----------------------------------------------------------------+----------.
     | Class                                                           | Type     |