[home page clarifications, incorporate Florent Becker's feedback
Simon Michael <simon@joyful.com>**20120428163724
 Ignore-this: ae0b23ccc0c85adb2971c1f2eb8dc574
] hunk ./doc/darcs.css 32
-  color: #494a82;
-  margin: 1em 0 0 0;
+  color: black;
+  margin: 1em 0 .5em 0;
+  font-size: 1em;
hunk ./doc/darcs.css 117
+#leftcol pre {
+    margin-left: 1em;
+}
+
hunk ./doc/index.html 33
-          Darcs is a free and open source version control system, like <a
-          href="http://git-scm.com/">git</a>, <a
+          Darcs is a free and open source, cross-platform, version control
+          system like <a href="http://git-scm.com/">git</a>, <a
hunk ./doc/index.html 88
+        Here are the commands you need to get stuff done with Darcs.
+        Among other <a href="http://wiki.darcs.net/Features">features</a>, notice how:
hunk ./doc/index.html 91
-        Here are the commands you need to get stuff done with Darcs.  To
-        learn more, run <code>darcs help</code> or see the <a href="manual/bigpage.html">manual</a>.
+      <ul>
+        <li>commands are interactive by default
+        <li>you can select just the edits you want to commit
+        <li>you can select just the changes you want, and move them between repos in any order (Darcs automatically groups changes which depend on each other.)
+      </ul>
hunk ./doc/index.html 97
-        Among other <a href="http://wiki.darcs.net/Features">features</a>,
-        notice how you can always select individual edits or changes, and move
-        changes between repos in any order. Darcs automatically detects changes
-        which depend on others and groups those together. The simplicity of this
-        "cherry-picking" is unique to Darcs (and <a
-        href="http://projects.haskell.org/camp">camp</a>) - watch this <a href="#"
-        onclick="javascript:$('#video').slideToggle(); return false;" style="white-space:nowrap;">5-minute
-        video</a> to see it in action.
+        The simplicity of this "cherry-picking" is unique to Darcs (and
+        <a href="http://projects.haskell.org/camp">camp</a>). Watch this
+        <a href="#" onclick="javascript:$('#video').slideToggle(); return false;" style="white-space:nowrap;">5-minute video</a>
+        to see it in action.
hunk ./doc/index.html 105
-      <p>
-        <b>Working in a local repository:</b>
-      <p>
+
+      <h3>Working in a local repository:</h3>
+
hunk ./doc/index.html 112
-$ <b>darcs add file1</b>      # begin tracking file1, ready to commit</pre>
+$ <b>darcs add file1</b>    # begin tracking file1, ready to commit</pre>
hunk ./doc/index.html 116
-$ <b>darcs whatsnew</b>      # show unrecorded edits in files Darcs is tracking
-$ <b>darcs whatsnew -s</b>   # just list the files
-$ <b>darcs whatsnew -sl</b>  # also list untracked files (or: darcs status)</pre>
+$ <b>darcs whatsnew</b>     # show uncommitted changes to files Darcs is tracking
+$ <b>darcs whatsnew -s</b>  # list just the files
+$ <b>darcs whatsnew -sl</b> # list untracked files too (or: darcs status)</pre>
hunk ./doc/index.html 120
-        Commit edits to the repo:
+        Commit edits and file changes to the repo, then list the latest commits:
hunk ./doc/index.html 122
-$ <b>darcs record</b>        # select edits and commit them to the local repo</pre>
+$ <b>darcs record</b>       # select edits and commit them to the local repo
+$ <b>darcs changes</b>      # (or: darcs log)</pre>
hunk ./doc/index.html 125
-        List the latest commits:
+        Various kinds of undo:
hunk ./doc/index.html 127
-$ <b>darcs changes --last 5</b>   # just show five (or: darcs log)</pre>
+$ <b>darcs revert</b>       # discard uncommitted edits, resetting the working copy
+$ <b>darcs rollback</b>     # reverse a committed change in this and remote repos
+                     # history-rewriting:
+$ <b>darcs unrecord</b>     # un-commit a change in this repo, preserving working copy
+$ <b>darcs obliterate</b>   # reverse and forget a committed change in this repo</pre>
hunk ./doc/index.html 133
-        Undo a commit or erase a change from the local repo:
-        <pre>
-$ <b>darcs unrecord</b>      # un-commit a change, keeping the working copy as it is
-$ <b>darcs obliterate</b>    # forget a change and undo its effect on the working copy</pre>
+      <h3>Working with remote repositories:</h3>
hunk ./doc/index.html 135
-      <p>
-        <b>Working with remote repositories:</b>
-      <p>
hunk ./doc/index.html 139
-$ <b>echo > darcs.cabal</b>  # (oops, hopefully upstream will catch this...)
-$ <b>darcs record</b>        # select edits and commit them to the local repo
-$ <b>darcs send</b>          # submit patches upstream if your system speaks email
+$ <b>echo > darcs.cabal</b> # oops, hope upstream will catch this...
+$ <b>darcs record</b>       # select edits and commit them to the local repo
+$ <b>darcs send</b>         # submit patches upstream if your system speaks email
hunk ./doc/index.html 143
-$ <b>darcs send -O</b>       # save a patch file you can email to patches@darcs.net</pre>
+$ <b>darcs send -O</b>      # save a patch file you can email to patches@darcs.net</pre>
hunk ./doc/index.html 145
-        Other:
+        Moving changes between repos, and more:
hunk ./doc/index.html 148
-$ <b>darcs pull</b>        # merge new changes from upstream, updating the working copy
-$ <b>darcs push</b>        # apply our new changes to the upstream repo via SSH
-$ <b>darcs help</b>        # list all commands and how to get more help</pre>
+$ <b>darcs pull</b>      # merge new changes from upstream, updating the working copy
+$ <b>darcs push</b>      # add our new changes to the upstream repo via SSH
+$ <b>darcs help</b>      # list all commands and how to get more help</pre>