[I think templates work now, even cabalized
thomashartman1@gmail.com**20080625033104] hunk ./templates/run-tutorial-locally.st 5
-<p>Assuming the basics are in place, you can install and run this tutorial locally as follows</p>
+<p>This tutorial is cabalized. You can install and run it simply by doing: sudo cabal install happs-tutorial.  You should then be able to run the resulting binary and view the tutorial offline at http://localhost:5001.</p>
hunk ./templates/run-tutorial-locally.st 7
+<p>The cabal installation may take up to an hour, mainly because the HAppS-Server installation is slow, but it should succeed in one shot. Incidentally, the fact that installing HAppS takes this long is arguably a <a href="http://code.google.com/p/happs/issues/detail?id=29">bug</a>. Hopefully this situation will be remedied as HAppS matures and, eventually, has an official release</p>
hunk ./templates/run-tutorial-locally.st 9
-<ul>
-    <li>Install <a href="http://www.darcs.net">Darcs</a>: a version control tool you need to check out this source. I installed this with sudo apt-get install darcs</li>
-    <li>Haskell: You need at least ghc 6.8.2 to install HAppS. I installed this with with apt-get install haskell, and then <a href="http://www.haskell.org/ghc/download.html">upgraded to ghc 6.8.3</a> as this is supposed to have fixed some bugs.</li> 
-    <li>Dependency chasing haskell package installers: you should have the latest versions of cabal and cabal install from <a href="http://hackage.haskell.org/packages/archive/pkg-list.html">hackage</a>. These are already included in the latest version of ghc, or they will be soon.. another reason to upgrade to the latest ghc.</li>
-    <li>HAppS: Once you have cabal install working, you should be able to install the HAppS packages in one shot, with all dependencies getting chased down automatically, without any babysitting. On ubuntu, I did this with <br>&nbsp time sudo cabal-install HAppS-Server <br> This takes a while, which is why I like to install with the time command as above -- when it's done it tells me how long the whole process has taken. Lately, running this command has been taking up to an hour, so I recommend brewing some tea or going for a walk or something. By the way, the fact that installing HAppS takes this long is arguably a <a href="http://code.google.com/p/happs/issues/detail?id=29">bug</a>. Hopefully this situation will be remedied as HAppS matures and, eventually, has an official release.</li>
+<p>If you've never used cabal install or need more detailed info....</p>
hunk ./templates/run-tutorial-locally.st 11
-  <li>Get the source for this tutorial: darcs get http://code.haskell.org/happs-examples</li>
-  <li>Run the tutorial server locally<br>&nbsp cd happs-examples; ./runServer.sh </li>
-  <li>You should now be able to brows this tutorial locally by opening a browser and going to http://localhost:5001/tutorial/home</li>
+<ul>
+    <li>Haskell: You need at least ghc 6.8.2 to install HAppS. I installed this with with apt-get install haskell (works for ubuntu hardy heron), and then <a href="http://www.haskell.org/ghc/download.html">upgraded to ghc 6.8.3</a> as this is supposed to have fixed some bugs.</li> 
+    <li>Dependency chasing haskell package installers: you should have the latest versions of cabal and cabal install from <a href="http://hackage.haskell.org/packages/archive/pkg-list.html">hackage</a>. These are already included in the latest version of ghc, or they will be soon. Another reason to upgrade to ghc 6.8.3.</li>
+    <li>If you want to check out the latest version of this tutorial, install <a href="http://www.darcs.net">Darcs</a> and check out the repo with darcs get http://code.haskell.org/happs-examples</li>
+    <li>cabal installs the tutorial at /home/yourdir/.cabal/bin/happs-tutorial. In practice, I usually recompile and run changed code by executing ./runServer.sh, in the top project directory.</li>
+  <li>You should now be able to browse this tutorial offline by running the executable, and opening http://localhost:5001 in your browser.</li>