fix some inaccuracies in the documentation

[chaz/chatty] / README

diff --git a/README b/README
index c60cc4ff6b34dc8324d1fef6eb290149dc2a985a..2a30526070ba42979a16d8cc80696a829b73f388 100644 (file)
--- a/README
+++ b/README
@@ -1,34 +1,26 @@
 NAME
-    Chatty -- Real-time (comet) chat application using Catalyst
+    Chatty -- Real-time (comet) chat application written with Perl/Catalyst
 
 SYNOPSIS
-        # install perl dependencies; skip to the next set of instructions
-        # while the dependencies are installing
-        cpan Catalyst::Devel
+        cpan Catalyst::Devel                    # install Catalyst
+
         perl Makefile.PL
-        make installdeps
+        make installdeps                        # install other dependencies
 
-        # install nginx (or install and configure some other reverse proxy)
-        # configure nginx and run it
-        sudo cp extra/nginx.conf /etc/nginx/nginx.conf
-        sudo /etc/rc.d/nginx start
+        cp extra/nginx.conf /etc/nginx/nginx.conf
+        /etc/rc.d/nginx start                   # run nginx http server
 
-        # configure the comet server (see L<http://meteorserver.org/>)
-        sudo cp extra/cometd/meteord.conf.dist /etc/meteord.conf
-        # add the 'SubscriberDocumentRoot' option to meteord.conf;
+        cp extra/cometd/meteord.conf.dist /etc/meteord.conf
+        # also add the 'SubscriberDocumentRoot' option to meteord.conf;
         # it should be set to $REPOSITORY_ROOT/extra/cometd/public_html
-        # run meteord (in another terminal)
-        ./extra/cometd/meteord -d
 
-        # configure hostnames
-        sudo cat extra/hosts >>/etc/hosts
+        cd extra/cometd; ./meteord -d           # run meteord in a new shell
 
-        # create the user database
-        sqlite3 db/info.db <db/schema.sql
+        cat extra/hosts >>/etc/hosts            # configure hostnames
+        sqlite3 db/info.db <db/schema.sql       # create the user database
 
-        # finally, run the application and try it out
-        ./script/chatty_server.pl -f
-        firefox http://chatty.com/
+        ./script/chatty_server.pl -f            # run the app
+        firefox http://chatty.com/              # finally, see if it works
 
 DESCRIPTION
     This is a toy web application implementing real-time (comet) chat. I