link fixes
[catagits/Catalyst-Manual.git] / lib / Catalyst / Manual / Tutorial / 10_Appendices.pod
index 8c4b513..e78a562 100644 (file)
@@ -2,7 +2,6 @@
 
 Catalyst::Manual::Tutorial::10_Appendices - Catalyst Tutorial - Chapter 10: Appendices
 
-
 =head1 OVERVIEW
 
 This is B<Chapter 10 of 10> for the Catalyst tutorial.
@@ -77,28 +76,28 @@ regex patterns).  I<Note that all 3 of the regexs end in 4 spaces>:
 
 =item *
 
-":0,$s/^    "
+C<":0,$s/^    ">
 
 Removes four leading spaces from the entire file (from the first line,
 C<0>, to the last line, C<$>).
 
 =item *
 
-"%s/^    "
+C<"%s/^    ">
 
 A shortcut for the previous item (C<%> specifies the entire file; so
 this removes four leading spaces from every line).
 
 =item *
 
-":.,$s/^    "
+C<":.,$s/^    ">
 
 Removes the first four spaces from the line the cursor is on at the time
 the regex command is executed (".") to the last line of the file.
 
 =item *
 
-":.,44s/^    "
+C<":.,44s/^    ">
 
 Removes four leading space from the current line through line 44
 (obviously adjust the C<44> to the appropriate value in your example).
@@ -123,7 +122,7 @@ 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
+C<< C-< >> and C<< C-> >> to set the mark at the beginning and end of the
 file respectively.
 
 Also, Stefan Kangas sent in the following tip about an alternate
@@ -133,16 +132,16 @@ current major mode). You can run the command by typing M-x
 indent-region or pressing the default keybinding C-M-\ in cperl-mode.
 Additional details can be found here:
 
-L<http://www.gnu.org/software/emacs/manual/html_node/emacs/Indentation-Commands.html>
+L<https://www.gnu.org/software/emacs/manual/html_node/emacs/Indentation-Commands.html>
 
 
 =head1 APPENDIX 2: USING POSTGRESQL AND MYSQL
 
 The main database used in this tutorial is the very simple yet powerful
-L<SQLite|http://www.sqlite.org>.  This section provides information
+L<SQLite|https://www.sqlite.org>.  This section provides information
 that can be used to "convert" the tutorial to use
-L<PostgreSQL|http://www.postgresql.org> and
-L<MySQL|http://dev.mysql.com>.  However, note that part of
+L<PostgreSQL|https://www.postgresql.org> and
+L<MySQL|https://dev.mysql.com>.  However, note that part of
 the beauty of the MVC architecture is that very little database-specific
 code is spread throughout the system (at least when MVC is "done
 right").  Consequently, converting from one database to another is
@@ -181,7 +180,7 @@ items via this command:
     sudo aptitude install postgresql libdbd-pg-perl libdatetime-format-pg-perl
 
 To configure the permissions, you can open
-C</etc/postgresql/8.3/main/pg_hba.conf> and change this line (near the
+F</etc/postgresql/8.3/main/pg_hba.conf> and change this line (near the
 bottom):
 
     # "local" is for Unix domain socket connections only
@@ -200,7 +199,7 @@ And then restart PostgreSQL:
 =item *
 
 Create the database and a user for the database (note that we are
-using "E<lt>catalystE<gt>" to represent the hidden password of
+using "<catalyst>" to represent the hidden password of
 "catalyst"):
 
     $ sudo -u postgres createuser -P catappuser
@@ -221,7 +220,7 @@ Create the C<.sql> file and load the data:
 
 =item *
 
-Open the C<myapp01_psql.sql> in your editor and enter:
+Open the F<myapp01_psql.sql> in your editor and enter:
 
     --
     -- Drops just in case you are reloading
@@ -396,7 +395,7 @@ Chapter 5: Authentication
 
 Create the C<.sql> file for the user/roles data:
 
-Open C<myapp02_psql.sql> in your editor and enter:
+Open F<myapp02_psql.sql> in your editor and enter:
 
     --
     -- Add users and roles tables, along with a many-to-many join table
@@ -477,7 +476,7 @@ Confirm with:
 
 =item *
 
-Modify C<set_hashed_passwords.pl> to match the following (the only difference
+Modify F<set_hashed_passwords.pl> to match the following (the only difference
 is the C<connect> line):
 
     #!/usr/bin/perl
@@ -496,7 +495,7 @@ is the C<connect> line):
         $user->update;
     }
 
-Run the C<set_hashed_passwords.pl> as per the "normal" flow of the
+Run the F<set_hashed_passwords.pl> as per the "normal" flow of the
 tutorial:
 
     $ perl -Ilib set_hashed_passwords.pl
@@ -536,7 +535,7 @@ The MySQL database server and client utility.
 
 =item *
 
-The Perl C<DBD::MySQL> module
+The Perl L<DBD::MySQL> module
 
 =back
 
@@ -610,29 +609,29 @@ Create the C<.sql> file and load the data:
 
 =item *
 
-Open the C<myapp01_mysql.sql> in your editor and enter:
+Open the F<myapp01_mysql.sql> in your editor and enter:
 
     --
     -- Create a very simple database to hold book and author information
     --
     CREATE TABLE IF NOT EXISTS `books` (
-      `id` int(11) NOT NULL AUTO_INCREMENT,
-      `title` text CHARACTER SET utf8,
-      `rating` int(11) DEFAULT NULL,
-      PRIMARY KEY (`id`)
+        `id` int(11) NOT NULL AUTO_INCREMENT,
+        `title` text CHARACTER SET utf8,
+        `rating` int(11) DEFAULT NULL,
+        PRIMARY KEY (`id`)
     ) ENGINE=InnoDB  DEFAULT CHARSET=utf8;
     -- 'book_authors' is a many-to-many join table between books & authors
     CREATE TABLE IF NOT EXISTS `book_authors` (
-      `book_id` int(11) NOT NULL DEFAULT '0',
-      `author_id` int(11) NOT NULL DEFAULT '0',
-      PRIMARY KEY (`book_id`,`author_id`),
-      KEY `author_id` (`author_id`)
+        `book_id` int(11) NOT NULL DEFAULT '0',
+        `author_id` int(11) NOT NULL DEFAULT '0',
+        PRIMARY KEY (`book_id`,`author_id`),
+        KEY `author_id` (`author_id`)
     ) ENGINE=InnoDB DEFAULT CHARSET=utf8;
     CREATE TABLE IF NOT EXISTS `authors` (
-      `id` int(11) NOT NULL AUTO_INCREMENT,
-      `first_name` text CHARACTER SET utf8,
-      `last_name` text CHARACTER SET utf8,
-      PRIMARY KEY (`id`)
+        `id` int(11) NOT NULL AUTO_INCREMENT,
+        `first_name` text CHARACTER SET utf8,
+        `last_name` text CHARACTER SET utf8,
+        PRIMARY KEY (`id`)
     ) ENGINE=InnoDB  DEFAULT CHARSET=utf8;
     ---
     --- Load some sample data
@@ -729,7 +728,7 @@ Delete the existing model:
 Regenerate the model using the Catalyst "_create.pl" script:
 
     script/myapp_create.pl model DB DBIC::Schema MyApp::Schema create=static \
-       dbi:mysql:myapp 'tutorial' 'yourpassword' '{ AutoCommit => 1 }'
+        dbi:mysql:myapp 'tutorial' 'yourpassword' '{ AutoCommit => 1 }'
 
 =back
 
@@ -745,31 +744,31 @@ Chapter 5: Authentication
 
 Create the C<.sql> file for the user/roles data:
 
-Open C<myapp02_mysql.sql> in your editor and enter:
+Open F<myapp02_mysql.sql> in your editor and enter:
 
     --
     -- Add users and roles tables, along with a many-to-many join table
     --
     CREATE TABLE IF NOT EXISTS `roles` (
-      `id` int(11) NOT NULL,
-      `role` text CHARACTER SET utf8,
-      PRIMARY KEY (`id`)
+        `id` int(11) NOT NULL,
+        `role` text CHARACTER SET utf8,
+        PRIMARY KEY (`id`)
     ) ENGINE=InnoDB DEFAULT CHARSET=utf8;
     CREATE TABLE IF NOT EXISTS `users` (
-      `id` int(11) NOT NULL,
-      `username` text CHARACTER SET utf8,
-      `password` text CHARACTER SET utf8,
-      `email_address` text CHARACTER SET utf8,
-      `first_name` text CHARACTER SET utf8,
-      `last_name` text CHARACTER SET utf8,
-      `active` int(11) DEFAULT NULL,
-      PRIMARY KEY (`id`)
+        `id` int(11) NOT NULL,
+        `username` text CHARACTER SET utf8,
+        `password` text CHARACTER SET utf8,
+        `email_address` text CHARACTER SET utf8,
+        `first_name` text CHARACTER SET utf8,
+        `last_name` text CHARACTER SET utf8,
+        `active` int(11) DEFAULT NULL,
+        PRIMARY KEY (`id`)
     ) ENGINE=InnoDB DEFAULT CHARSET=utf8;
     CREATE TABLE IF NOT EXISTS `user_roles` (
-      `user_id` int(11) NOT NULL DEFAULT '0',
-      `role_id` int(11) NOT NULL DEFAULT '0',
-      PRIMARY KEY (`user_id`,`role_id`),
-      KEY `role_id` (`role_id`)
+        `user_id` int(11) NOT NULL DEFAULT '0',
+        `role_id` int(11) NOT NULL DEFAULT '0',
+        PRIMARY KEY (`user_id`,`role_id`),
+        KEY `role_id` (`role_id`)
     ) ENGINE=InnoDB DEFAULT CHARSET=utf8;
     --
     -- Load up some initial test data
@@ -810,7 +809,7 @@ Update the model:
 Regenerate the model using the Catalyst "_create.pl" script:
 
     script/myapp_create.pl model DB DBIC::Schema MyApp::Schema create=static \
-       components=TimeStamp,PassphraseColumn dbi:mysql:myapp 'tutorial' 'yourpassword' '{ AutoCommit => 1 }'
+        components=TimeStamp,PassphraseColumn dbi:mysql:myapp 'tutorial' 'yourpassword' '{ AutoCommit => 1 }'
 
 =back
 
@@ -818,7 +817,7 @@ Regenerate the model using the Catalyst "_create.pl" script:
 
 Create the C<.sql> file for the hashed password data:
 
-Open C<myapp03_mysql.sql> in your editor and enter:
+Open F<myapp03_mysql.sql> in your editor and enter:
 
     --
     -- Convert passwords to SHA-1 hashes
@@ -848,4 +847,4 @@ L<https://rt.cpan.org/Public/Dist/Display.html?Name=Catalyst-Manual>.
 
 Copyright 2006-2011, Kennedy Clark, under the
 Creative Commons Attribution Share-Alike License Version 3.0
-(L<http://creativecommons.org/licenses/by-sa/3.0/us/>).
+(L<https://creativecommons.org/licenses/by-sa/3.0/us/>).