Expand README

Author: rev22

README.markdown

@@ -1,27 +1,49 @@
-git-uncommit: uncommit and recommit commands for Git, save your commits to patch files
+git-uncommit: uncommit and recommit commands for Git, undo commit to patch file
 
 Git uncommit does exactly what it says: it uncommits the last Git commit, saving the patch.
 
 Git recommit applies back the last uncommitted patch; after the patch is applied, the patch file is deleted.
 
-Usage:
+## Usage:
 
 Let's suppose after much work you have just committed experimental changes to your branch.
 
-````shell
+````sh
 $ git-commit -m "Experimental changes"
 ````
 
 You are unsatisfied with the result, but do not want to discard the work, so you run ```git-uncommit```
 
 
-````shell
+````sh
 $ git-uncommit
 Uncommit: 2edf199-experimental-changes.patch
 ````
-The patch created by ```git-uncommit``` using ```git format-patch``` and is saved to a file: 2edf199-experimental-changes.patch
 
-Comparison with related git commands:
+This undoes your experimental commit and creates ```2edf199-experimental-changes.patch```.
+
+You can undo in this way any number of commits; ```git-recommit``` can be used to apply the patches
+
+To apply the last uncommitted patch:
+
+
+````sh
+$ git-recommit
+````
+
+To run ```git-recommit``` with any saved patch file to reapply it in the order you want:
+
+````sh
+$ git-recommit <patch-file>.patch
+````
+
+## Patches
+
+Patches can be readily edited, shared with others and applied in a new order.
+
+Patches are created using ```git format-patch```
+
+## Comparison with related git commands:
 
 ```git stash``` can sometimes be used for similar purposes as ```git-uncommit```, the differences are:
 * git stash operates on changes to the work tree or index, not already committed changes
@@ -32,3 +54,27 @@ Comparison with related git commands:
 ```stg``` or ```STGit```: a tool that can also be used to reorder or edit commits, the main differences are:
 * ```STGit``` has a much more complex set of command
 * it does not save patch files automatically
+
+## Installation
+
+```git-uncommit``` and ```git-recommit``` are stand-alone shell scripts, simply requiring Git to be installed.
+
+In a Unix or Linux system, you can quickly install ```git-recommit``` and ```git-uncommit``` by copying the files to /usr/local/bin.
+
+## Author and licensing terms
+
+````
+Copyright (c) 2012, 2013 Michele Bini <michele.bini@gmail.com>
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the version 3 of the GNU General Public License
+as published by the Free Software Foundation.
+
+This program is distributed in the hope that it will be useful, but
+WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program.  If not, see <http://www.gnu.org/licenses/>.
+````