various formatting cleanups
[catagits/Catalyst-Manual.git] / lib / Catalyst / Manual / Tutorial / 10_Appendices.pod
index 0d0b3ae..406ff63 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).
@@ -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
@@ -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