Standardize on 5.70 and 5.7X for version numbers.
Add emacs cut & paste tip.
Add link under PostgreSQL to latest copy in svn.
Add link to CentOS4.pod for latest copy in svn.
comparable Linux OS, you should be able to skip this first section and
go straight to the C<INSTALL CATALYST> section.
+B<NOTE:> You might want to consult the latest version of this document. It
+is available at:
+L<http://dev.catalyst.perl.org/repos/Catalyst/trunk/Catalyst-Runtime/lib/Catalyst/Manual/Installation/CentOS4.pod>
+
+
=head1 INSTALL CENTOS
Kennedy Clark, C<hkclark@gmail.com>
-Please report any errors, issues or suggestions to the author.
+Please report any errors, issues or suggestions to the author. The
+most recent version of the Catlayst Tutorial can be found at
+L<http://dev.catalyst.perl.org/repos/Catalyst/trunk/Catalyst-Runtime/lib/Catalyst/Manual/Tutorial/>.
Copyright 2006, Kennedy Clark, under Creative Commons License
(L<http://creativecommons.org/licenses/by-nc-sa/2.5/>).
=back
+
=head1 DESCRIPTION
This part of the tutorial provides supporting information relevant to
the Catalyst tutorial.
+
=head1 APPENDIX 1: CUT AND PASTE FOR POD-BASED EXAMPLES
You may notice that Pod indents example code with four spaces. This
=head2 "Un-indenting" with Emacs
-B<TODO>
+Although there author has not used emacs for many years (appologies to
+the emacs fans out there), here is a quick hint to get you started. To
+replace the leading spaces of every line in a file, use:
+
+ M-x replace-regexp<RET>
+ Replace regexp: ^ <RET>
+ with: <RET>
+
+All of that will occur on the single line at the bottom of your screen.
+Note that "<RET>" represents the return key/enter. Also, there are
+four spaces after the "^" on the "Replace regexp:" line and no spaces
+entered on the last line.
+
+You can limit the replacement operation by selecting text first (depending
+on your version of emacs, you can either use the mouse or experiment with
+commands such as C<C-SPC> to set the mark at the cursor location and
+C<C-E<lt>> and C<C-E<gt>> to set the mark at the beginning and end of the
+file respectively.
+
=head1 APPENDIX 2: USING MYSQL AND POSTGRESQL
=head2 PostgreSQL
-B<TODO>
+B<TODO> -- Please see the latest version of this document for possible updates:
+L<http://dev.catalyst.perl.org/repos/Catalyst/trunk/Catalyst-Runtime/lib/Catalyst/Manual/Tutorial/Appendices.pod>
=head1 APPENDIX 3: IMPROVED HASHING SCRIPT
}
-
=head1 AUTHOR
Kennedy Clark, C<hkclark@gmail.com>
pulled from the Catalyst Subversion repository in one step with the
following command:
- svn checkout http://dev.catalyst.perl.org/repos/Catalyst/trunk/examples/Tutorial@###
+ svn checkout http://dev.catalyst.perl.org/repos/Catalyst/trunk/examples/Tutorial@4612 .
IMPORTANT: Does not work yet. Will be completed for final version.
pulled from the Catalyst Subversion repository in one step with the
following command:
- svn checkout http://dev.catalyst.perl.org/repos/Catalyst/trunk/examples/Tutorial@###
+ svn checkout http://dev.catalyst.perl.org/repos/Catalyst/trunk/examples/Tutorial@4613 .
IMPORTANT: Does not work yet. Will be completed for final version.
pulled from the Catalyst Subversion repository in one step with the
following command:
- svn checkout http://dev.catalyst.perl.org/repos/Catalyst/trunk/examples/Tutorial@###
+ svn checkout http://dev.catalyst.perl.org/repos/Catalyst/trunk/examples/Tutorial@4611 .
IMPORTANT: Does not work yet. Will be completed for final version.
pulled from the Catalyst Subversion repository in one step with the
following command:
- svn checkout http://dev.catalyst.perl.org/repos/Catalyst/trunk/examples/Tutorial@###
+ svn checkout http://dev.catalyst.perl.org/repos/Catalyst/trunk/examples/Tutorial@4609 .
IMPORTANT: Does not work yet. Will be completed for final version.
| /end | MyApp::Controller::Root | end |
'----------------------+--------------------------------------+--------------'
- [info] MyApp powered by Catalyst 5.70_03
+ [info] MyApp powered by Catalyst 5.70
You can connect to your server at http://localhost.localdomain:3000
Point your web browser to L<http://localhost:3000> (substituting a
B<TIP:> You may see examples that include the
L<Catalyst::Plugin::DefaultEnd|Catalyst::Plugin::DefaultEnd>
-plugins. As of Catalyst 5.7000, C<DefaultEnd> has been
+plugins. As of Catalyst 5.70, C<DefaultEnd> has been
deprecated in favor of
L<Catalyst::Action::RenderView|Catalyst::Action::RenderView>
(as the name of the package suggests, C<RenderView> is not
a plugin, but an action). The purpose of both is essentially the same:
forward processing to the view to be rendered. Applications generated
-under 5.7000 should automatically use C<RenderView> and "just work"
+under 5.70 should automatically use C<RenderView> and "just work"
for most applications. For more information on C<RenderView> and
the various options for forwarding to your view logic, please refer
to the "Using RenderView for the Default View" section under
Once your controller logic has processed the request from a user, it
forwards processing to your view in order to generate the appropriate
-response output. Catalyst v5.7000 ships with a new mechanism,
+response output. Catalyst v5.70 ships with a new mechanism,
L<Catalyst::Action::RenderView|Catalyst::Action::RenderView>, that
automatically performs this operation. If you look in
C<lib/MyApp/Controller/Root.pm>, you should see the this empty
| /books/list | /books/list |
'-------------------------------------+--------------------------------------'
- [info] MyApp powered by Catalyst 5.7000
+ [info] MyApp powered by Catalyst 5.70
You can connect to your server at http://localhost.localdomain:3000
Some things you should note in the output above:
=item *
-Attempts to provide an example showing current (5.7000) Catalyst
+Attempts to provide an example showing current (5.7X) Catalyst
practices. For example, the use of
L<Catalyst::Action::RenderView|Catalyst::Action::RenderView>,
DBIC, L<Catalyst::Plugin::ConfigLoader|Catalyst::Plugin::ConfigLoader>
pulled from the Catalyst Subversion repository in one step with the
following command:
- svn checkout http://dev.catalyst.perl.org/repos/Catalyst/trunk/examples/Tutorial@###
+ svn checkout http://dev.catalyst.perl.org/repos/Catalyst/trunk/examples/Tutorial@4614 .
IMPORTANT: Does not work yet. Will be completed for final version.