metaform: improve and markdown INSTALL

diff --git a/metaform/INSTALL b/metaform/INSTALL
index 0ae06bb..bd038a4 100644 (file)
--- a/metaform/INSTALL
+++ b/metaform/INSTALL
@@ -1,34 +1,44 @@
-INSTALL INSTRUCTIONS FOR THE FILES IN THIS DIRECTORY:
+Install Instructions For The Files In This Directory
+====================================================
 
-If your directory is already set up for WFPL, then all you have to do is copy the files from this directory (except INSTALL and .htaccess) to that directory, and it should run as-is.
+If your directory is already set up for WFPL, then all you have to do is copy
+the files from this directory (except INSTALL and .htaccess) to that directory,
+and it should run as-is. If not, keep reading...
 
-INSTRUCTIONS FOR SETTING UP A DIRECTORY FOR WFPL:
+Instructions For Setting Up A Directory For WFPL
+------------------------------------------------
 
-1) "cd" to the directory that will contain all your content and code files.
+1.     "cd" to the directory that will contain all your content and code files.
 
-2) make a "code" directory:
+2.     make a "code" directory:
 
-mkdir code
+               mkdir code
 
-3) download wfpl:
+3.     download wfpl:
 
-cd code
-git clone git://gitorious.org/wfpl/wfpl.git
-cd ..
+               cd code
+               git clone git://gitorious.org/wfpl/wfpl.git
+               cd ..
 
-4) make the run.php link:
+4.     make the run.php link:
 
-ln -s code/wfpl/run.php
+               ln -s code/wfpl/run.php
 
-5) Install the .htaccess file from this directory (it's a hidden file, but you
-can see it with ls -a)
+5.     Copy the file named ".htaccess" from this directory to the hosting folder
+       (where you put the php file.)  This is included as a separate step,
+       because the "." at the beginning makes the file hidden. This means it does
+       not show up in directory listings (unless you pass -a) and does not match
+       "*" in shell commands. Here's how you could copy it:
 
-6) If you have a domain name pointing directly at the directory you're setting
-up (for example, it's accessible as http://example.com/) then you're done! But
-if this directory is acessed with a directory (or multiple directories) in the
-URL path (for example: http://example.com/foo/bar/) then you'll need to edit
-the RewriteRule in .htaccess (read the comments in that file for further
-explanation and examples.
+               cp directory-containing-this-INSTALL-file/.htaccess .
+
+6.     If you have a domain name pointing directly at the directory you're
+       setting up (for example, it's accessible as http://example.com/) then
+       you're done! But if this directory is acessed with a directory (or
+       multiple directories) in the URL path (for example:
+       http://example.com/foo/bar/) then you'll need to edit the RewriteRule in
+       .htaccess (read the comments in that file for further explanation and
+       examples.)
 
 
 That's it! Now that you've got the directory set up, just place your php files