diff --git a/README b/README
index 3183199..b8a514f 100644
--- a/README
+++ b/README
@@ -1,75 +1,88 @@
-INFO
-====
+fugitive README file
-fugitive is a blog engine running on top of git using hooks to generate static
-html pages and thus having only git as dependency.
+
Info
+
+ fugitive is a blog engine running on top of git using hooks to generate
+ static html pages and thus having only git as dependency.
+
+Install
-INSTALL
-=======
+Build
+
+ If you want to build fugitive from the source, clone the git repository:
+
+ git clone git://gitorious.org/fugitive/fugitive.git fugitive
+
+ Then simply go in the newly created directory: cd fugitive
, and
+ run the build script: ./build.sh
.
+
+ This will generate an executable file "fugitive".
+
+Create a blog
+
+ If you have the "fugitive" executable file and want to start a new
+ blog: Run fugitive --install <dir>
.
+
+ This will create the git repos with appropriate hooks and files in
+ <dir>.
+
+ If <dir> isn't specified then the current working directory is used.
+
+
+ NOTE: You need to use the same process to install any remote
+ repository where you'd like to push your blog.
+
+Update
+
+ Simply run fugitive --install-hooks <dir>
.
+ This will only (re)install fugitive hooks scripts.
+ If <dir> isn't specified then the current working directory is used.
+
-Build
------
-If you want to build fugitive from the source, clone the git repository:
-`git clone git://gitorious.org/fugitive/fugitive.git fugitive`
-Then simply go in the newly created directory: `cd fugitive`, and run the build
-script: `./build.sh`.
-This will generate an executable file "fugitive".
+Configuration
-Create a blog
--------------
-If you have the "fugitive" executable file and want to start a new blog:
-Run `fugitive --install `.
-This will create the git repos with appropriate hooks and files in .
-If isn't specified then the current working directory is used.
+
+ There are three item in the "fugitive" section of the git config:
+
+
+ -
+ "public-dir" is the path to the directory that will contain the generated
+ html files. Defautlt value is ".", the root of the git repository. You
+ could set it to "blog" for instance if you already have a static website
+ under your git repos.
+
+ -
+ "articles-dir" is the path where fugitive will look for published articles.
+ Default value is "_articles". This path is relative to the root of the git
+ repository, must be in it and must not start with ".".
+
+ -
+ "templates-dir" is the path where fugitive will look for templates files.
+ Default value is "_templates". This path is relative to the root of the git
+ repository, must be in it and must not start with ".".
+
+
+
+ NOTE: You must NOT put a trailing '/' at the end of any of
+ those paths.
+
-NOTE: You need to use the same process to install any remote repository where
-you'd like to push your blog.
-
-Update
-------
-Simply run `fugitive --install-hooks `.
-This will only (re)install fugitive hooks scripts.
-If isn't specified then the current working directory is used.
-
-
-CONFIGURATION
-=============
-
-There are three item in the "fugitive" section of the git config:
-
- - "public-dir" is the path to the directory that will contain the generated
- html files. Defautlt value is ".", the root of the git repository. You
- could set it to "blog" for instance if you already have a static website
- under your git repos.
-
- - "articles-dir" is the path where fugitive will look for published articles.
- Default value is "_articles". This path is relative to the root of
- the git repository, must be in it and must not start with ".".
-
- - "templates-dir" is the path where fugitive will look for templates files.
- Default value is "_templates". This path is relative to the root of
- the git repository, must be in it and must not start with ".".
-
-NOTE: You must NOT put a trailing '/' at the end of any of those paths.
-
-
-USAGE
-=====
-
-General use
------------
-
-Article you want to publish should be file without the .html extension in the
-"articles-dir" directory (see CONFIGURATION).
-
-The first line of the file will be used as title and the rest of the file as
-the content.
-
-/!\ WARNING: DO NOT CREATE AN ARTICLE FILE NAMED "archives"
-/!\ WARNING: DO NOT CREATE AN ARTICLE FILE NAMED "index"
-
-Template system
----------------
-*TODO*
+Usage
+General use
+
+ Article you want to publish should be file without the .html extension in the
+ "articles-dir" directory (see CONFIGURATION).
+
+
+ The first line of the file will be used as title and the rest of the file as
+ the content.
+
+
+ /!\ WARNINGS:
+ DO NOT CREATE AN ARTICLE FILE NAMED "archives".
+ DO NOT CREATE AN ARTICLE FILE NAMED "index".
+
+Template system
+*TODO*