Grammar nazi'ing

1 files changed, 125 insertions, 366 deletions

diff --git a/doc/Home.mdpp b/doc/Home.mdpp
index b647579d..eb59852b 100644
--- a/doc/Home.mdpp
+++ b/doc/Home.mdpp
@@ -31,37 +31,34 @@ welcomed by submitting a Pull Request for [Home.mdpp][1].
    See the [Readme][2] for more details.
 6. Merge the resulting file `Home.md` with the one on the helm wiki repo you checked out in 1.
 
-
 # Install
 
-First get the files from git repo:
+First get the files from the git repo:
 
-Helm git repo is at:
+The Helm git repo is at:
  <https://github.com/emacs-helm/helm>
- You will find there tarballs of differents versions.
+ There, you will find tarballs of differents versions.
 
 To get it with git:
 
     git clone https://github.com/emacs-helm/helm
 
-Once you have the helm directory, `cd` to it and run `make`.
-Edit your `~/.emacs.el` file and add:
+Once you have the helm directory, `cd` into it and run `make`.
+Edit your `init.el` file and add:
   
     (add-to-list 'load-path "/path/to/helm/directory")
     (require 'helm-config)
 
-
-
 # General helm commands
 
- Helm allow you to have few binding to remember
-unlike all others Emacs applications.
- Thus, all bindings are auto documented.
+ Helm needs you to remember only a few binding unlike all others Emacs
+applications. Thus, all bindings are auto documented.
 
-Helm show you by default in mode-line the most useful bindings, you will
-see in headers of helm buffer some more specific commands.
+By default, Helm shows you the most useful bindings in the mode-line.
+You will see some more specific commands in the header of the helm
+buffer.
 
-So when helm start what you have to remember:
+So when helm starts, you have to remember:
 
 -   Access to action menu with
 
@@ -75,15 +72,14 @@ So when helm start what you have to remember:
 
         M-<SPACE>
 
-So three bindings to remember and they are anyway documented in
-mode-line. For more, hitting
+So there are three bindings to remember and they are also documented
+in mode-line. For more, hitting
 
         C-h m
 
 while in helm session will show you all other bindings.
  NOTE: Some helm commands have a special keymap, you can access infos on
-these keymap with `C-c ?`, it should be documented in mode-line.
-
+these keymap with `C-c ?`, it should be documented in the mode-line.
 
 ## Yanking text
 
@@ -98,49 +94,41 @@ Alternatively, customize `helm-yank-symbol-first` to enable
 
 to always yank the whole symbol on first invocation.
 
-
 # Overview of preconfigured helm commands
 
- For starting with helm, a set of commands have
-been set for you in helm menu. The bindings of all these commands are
+ To start with helm, a set of commands have
+been set for you in the helm menu. The bindings of all these commands are
 prefixed with `helm-command-prefix-key` (default to `C-x c`).
 
-To discover more helm commands run from menu helm all commands
-(helm-execute-helm-command). Or run helm-M-x (`helm-command-prefix-key` `M-x`) and type helm.
+To discover more helm commands run `helm all commands`
+(helm-execute-helm-command) from the menu. Or run helm-M-x (`helm-command-prefix-key` `M-x`) and type helm.
 
 When you like a command, e.g `helm-command-prefix-key` `M-x` you should bind it to something
 more convenient like M-x to replace the Emacs original keybinding.
 
-
-
-
-
 # Helm Find Files
 
- `helm-find-files` provide you a way to navigate in
-your system file easily. All the actions you can do on files from here
-are described in this section.
-
-It is binded in menu, and in `helm-command-map` to `helm-command-prefix-key` `C-x C-f`. 
- We will assume you have binded `helm-find-files` to `C-x C-f`. To do that
-put in your `.emacs.el`:
-
-    (global-set-key (kbd "C-x C-f") 'helm-find-files)
-
-It is well integrated with tramp, you can enter any tramp filename and
-it will complete. (e.g /su::, /sudo::, /ssh:host:, ... etc)
+ `helm-find-files` provides you with a way to navigate in your file
+hierarchy easily. All the actions you can apply to files from here are
+described in this section.
 
-Called with a prefix arg, (C-u) helm-find-files will show you also
-history of last visited directories.
+You can find it in the menu under `helm-command-prefix-key` or
+ as the keychain `C-x C-f`. 
 
+If you like it, you can safely bind it to C-x C-f to replace the
+standard find-file:
 
+    (global-set-key (kbd "C-x C-f") 'helm-find-files)
 
+It also works well with tramp. Try it!
 
+NOTE: Starting helm-find-files with C-u will show you a little history
+of the last visited directories.
 
 ## Navigation
 
  Helm-find-files is not by default on / but on
-default-directory or thing-at-point as it use ffap.If you are on a url,
+default-directory or thing-at-point as it uses ffap. If you are on a url,
 a mail adress etc.. it will do the right thing.
 
 So helm-find-files work like find-file (C-x C-f), but if you use it with
@@ -177,17 +165,6 @@ with DEL. On non graphic display, it is bound to C-l.
  If `helm-ff-lynx-style-map` is non–nil, you will be able to use `left`
 instead of C-l and `right` instead of C-z.
 
-If you like it, you can safely bind it to C-x C-f to replace the
-standard find-file:
-
-    (global-set-key (kbd "C-x C-f") 'helm-find-files)
-
-NOTE: Starting helm-find-files with C-u will show you a little history
-of the last visited directories.
-
-
-
-
 ## Jump with nth commands
 
  Take advantage of the second, third and 4th actions
@@ -200,20 +177,12 @@ You can bind 4th action to some key like this:
 
     (define-key helm-map (kbd "<C-tab>") 'helm-select-4th-action)
 
-
-
-
-
 ## Helm find files action shortcuts
 
  Instead of having to open action pannel with
 TAB, you have some convenients shortcuts to quickly run actions. Use C-c
 ? from an helm-find-files session to have a description.
 
-
-
-
-
 ## Turn in image viewer
 
  You can turn helm-find-files in a nice
@@ -239,33 +208,29 @@ NOTE: It use image-dired in background, so if image-dired doesn't work for
 some reason, this will not work too. Be sure to have Imagemagick package
 installed.
 
-
-
-
-
 ## Serial rename
 
  You can rename files with a new prefix name and by
 incremental number. The marked files will be renamed with a new prefix
-name and starting at the start-number you have choosen.
+name and starting at the start-number you have chosen.
  Note that the marked files are in the order of the selection you did,
-this allow to reorder files.
+this allows you to reorder files.
  If you mark files in other directories than the current one, these
 files will be moved or symlinked to current one.
 
 TIP: If you have more than 100 files to serial rename, start at 100
-instead of one to have your directory sorted correctly.
+instead of 1 to have your directory sorted correctly.
 
 You have three ways to serial rename:
 
--   By renaming: All the file of others directories are moved in
-    directory where renaming happen.
+-   By renaming: All the file of others directories are moved to the target
+    directory.
 
--   By symlinking: All the files that are not files of the directory
-    where you want to rename will be symlinked, others will be renamed.
+-   By symlinking: All the files that are not files of the target
+    directory will be symlinked, others will be renamed.
 
--   By copying: All the file of others directories are copied in
-    directory where renaming happen.
+-   By copying: All the file of others directories are copied to
+    target directory.
 
 Example of Use:
  I want to create a directory with many symlinked images coming from
@@ -291,40 +256,28 @@ various directories.
 
 8) Start viewing your pictures.
 
-
-
-
 ## Open Files Externally
 
- You will find in action menu from
-helm-find-files an action to open file with external program. If you
-have no entry in .mailcap or /etc/mailcap, you will enter an helm
-session to choose a program to use with this kind of file. It will offer
-to you to save setting to always open this kind of files with this
-program. Once configured, you can however open the files of same
-extension with some other program by forcing helm to choose program with
-C-u.
+ In action menu of helm-find-files, you will find an action to open
+a file with an external program. If you have no entry in .mailcap or
+/etc/mailcap, you will enter an helm session to choose a program to
+use with this kind of file. It will offer to you to save settings to
+always open this kind of files with this program. Once configured, you
+can however open the files of same extension with some other program
+by forcing helm to choose program with C-u.
 
-NOTE: You can now open files externally with `C-c C-x` from
+NOTE: You can open files externally with `C-c C-x` from
 helm-find-files.
 
-
-
-
 ## Eshell command on files
 
- You can run eshell-command on files or marked
-files, the command you use have to accept one file as argument. The
-completion is make on your eshell aliases. This allow you creating
-personal actions for `helm-find-files`.
-
-
-
+ You can run eshell-command on files or marked files, the command you
+use has to accept one file as argument. The completion is made on
+your eshell aliases. This allow you creating personal actions for
+`helm-find-files`.
 
 ## Why Eshell
 
-
-
 -   Because eshell allow you to create aliases.
 
 -   Because eshell accept shell commands but also elisp functions.
@@ -333,9 +286,6 @@ All these command should end with https://github.com/emacs-helm/helm/blob/master
 all these aliases once eshell is loaded. (start it once before using
 helm-find-files).
 
-
-
-
 ## Setup Aliases
 
  Go in eshell, an enter at prompt:
@@ -346,32 +296,23 @@ NOTE: don`t forget to escape the $.
 
 See the documentation of Eshell for more info.
 
-
-
-
-
 ## Problem starting Eshell
 
- Eshell code is available (autoloaded) only when
-you have started once eshell. That`s annoying like many autoloaded stuff
-in Emacs.
+ Eshell code is available (autoloaded) only when you have started once
+eshell. That`s annoying like many autoloaded stuff in Emacs.
 
-Here how to start Eshell at emacs startup:
+Here how to start Eshell at Emacs startup:
 
-Add this to your .emacs:
+Add this to your `init.el`:
 
     (add-hook 'emacs-startup-hook #'(lambda ()
                                       (let ((default-directory (getenv "HOME")))
                                         (command-execute 'eshell)
                                         (bury-buffer))))
 
-
-
-
 ## Dired Commands
 
- To enable some of the usual commands of dired, put
-in .emacs.el
+To enable some of the usual commands of dired, put in `init.el`:
 
     (helm-dired-bindings 1)
 
@@ -384,8 +325,6 @@ rename, symlink, hardlink. When creating a symlink, you will find
 relsymlink in actions menu.(TAB).
 NOTE: This is deprecated for Emacs24 users, use instead `helm-mode`.
 
-
-
 ## Copy Files
 
  It is a powerful feature of helm-find-files as you can
@@ -417,9 +356,6 @@ Just mark some files,
 and hit hardlink files in the action menu. That will open a new
 helm-find-files where you can choose destination.
 
-
-
-
 ## Follow file after action
 
  A prefix arg on any of the action above, copy,
@@ -429,14 +365,10 @@ compile it in this place, hitting C-u RET will bring you in this place
 with the file already marked, you have just to go in action menu to
 compile it.
 
-
-
-
-
 ## In Buffer File Completion
 
  In any buffer and even in minibuffer if you have
-enable recursive-minibuffer
+enabled recursive-minibuffer
 
     (setq enable-recursive-minibuffers t)
 
@@ -449,42 +381,26 @@ your new file, then
  NOTE: If your filename ends with a / you will be prompt to create a new
 directory.
 
-
-
-
-
 ## Create Directory
 
  Navigate to the directory where you want to
 create your new directory, 
- then continue typing the name of new directory - Parents accepted - 
+ then continue typing the name of new directory - parents accepted - 
  and end it with / type enter, you will be prompt to create your new
 directory (possibly with parents).
 
-
-
-
-
 ## Ediff files
 
  Well, that is easy to use, move cursor to a file, hit
 ediff in action menu, you will jump in another helm-find-files to choose
 second file. 
 
-
-
 ## Ediff merge files
 move cursor to a file, hit ediff merge in action menu, you will jump in another
 helm-find-files to choose second file.
 
-
-
-
-
 ## Browse archive with avfs
 
-
-
 If you have installed avfs (See: http://sourceforge.net/projects/avf)
 you can browse archives in your directory .avfs once it is mounted with
 `mountavfs`.
@@ -493,41 +409,31 @@ Just move on the archive filename and press C-z (persistent action) and
 you will see in helm buffer the subdirectories of archive, just navigate
 inside as usual.
 
-
-
-
-
 ## Helm write buffer
 
  That is a replacement of standard `write-buffer`
 Emacs command with helm completion.
 
-
-
-
-
 ## Helm insert file
 
  That is a replacement of standard `insert-file`
 Emacs command with helm completion.
 
-
-
 # Grep
 
  We describe here helm-do-grep, an incremental grep. It is
-really convenient as you can start a search just after finding the place
-or file(s) you want to search in. By the nature of incremental stuff, it
+really convenient as you can start a search just after finding the directories
+or files you want to search in. By the nature of incremental stuff, it
 is faster than original Emacs grep for searching.
 
-As you type the display change (like in all other helm commands). This
-grep is also recursive unlike the emacs implementation that use
+As you type the display changes (like in all other helm commands). This
+grep is also recursive unlike the Emacs implementation that use
 find/xargs.
 
-It support wildcard and (re)use the variables `grep-find-ignored-files`
+It supports wildcards and respects the variables `grep-find-ignored-files`
 and `grep-find-ignored-directories`.
 
-It have full tramp integration. (you can grep file on a remote host or
+It has full tramp integration. (you can grep file on a remote host or
 in su/sudo methods).
 
 -   NOTE: When using it recursively, `grep-find-ignored-files` is not
@@ -542,19 +448,14 @@ This version should accept the `--exclude-dir` option.
 
 -   NOTE: Apple OS X users also need a version of grep that accepts `--exclude-dir`
 
-    This is installable from homebrew with:
-
-         brew install https://raw.github.com/Homebrew/homebrew-dupes/master/grep.rb
-
+    Install it from homebrew with:
 
+         brew install grep
 
 ## Helm do grep
 
  Start with M-x helm-do-grep bound to `helm-command-prefix-key` `M-g s` (A prefix arg will launch recursive grep).
 
-
-
-
 ## Grep from helm-find-files
 
  From helm-find-files (`helm-command-prefix-key` `C-x C-f`) Open the action
@@ -563,9 +464,6 @@ menu with tab and choose grep. A prefix arg will launch recursive grep.
 -   NOTE:You can now launch grep with (C-u) M-g s without switching to
     the action pannel.
 
-
-
-
 ## Grep One file
 
  Just launch grep, it will search in file at point.
@@ -574,10 +472,6 @@ like:
 
     grep -nH -e pattern *
 
-
-
-
-
 ## Grep Marked files
 
  Just mark some files with
@@ -588,7 +482,7 @@ and launch grep.
 
 ## Grep marked files from differents directories
 
-This is a very nice feature of helm grep implementation that allow to search 
+This is a very nice feature of helm grep implementation that allows to search 
 in specific files located not only in current directory but anywhere in your file system.
 
 To use navigate in your file system and mark files with
@@ -601,13 +495,9 @@ NOTE: Using prefix-arg (C-u) will start a recursive search with the
 extensions of the marked files except if those are one of
 `grep-find-ignored-files`.
 
-
-
-
-
 ## Grep Directory recursively
 
- From `helm-find-files`, reach the root of the
+ From `helm-find-files`, go to the root of the
 directory where you want to search in, then hit TAB to open the action
 menu and choose grep with a prefix arg (i.e C-u RET).
 
@@ -621,23 +511,15 @@ You will be prompted for selecting in which category of files to search:
 Use the wilcard syntax like \*.el for example (search in only `.el`
 files).
 
-By default, the extension of the file at point is used when cursor is on a filename.
-If cursor is at root of directory, all the filename extensions found in directory and not
-matching `grep-find-ignored-files` are inserted in prompt.
-
-
-
-
+By default, the extension of the file at point is used when the cursor
+is on a filename. If the cursor is at root of a directory, all the
+filename extensions found in the directory and not matching
+`grep-find-ignored-files` are inserted into the prompt.
 
 ## Grep Using Wildcard
 
- You can use wildcard: From the root of your
-directory, if you want for example to search files with .el extension:
-add \*.el to prompt.
-
-
-
-
++ You can use wildcards: If you want for example to search files with
++.el extension: add \*.el to prompt.
 
 ## Grep thing at point
 
@@ -646,19 +528,17 @@ of symbol or sexp you will want to grep. Then launch helm-do-grep or
 helm-find-files, and when in the grep prompt hit C-w as many time as
 needed.
 
-
-
 ## Grep persistent action
 
- As always, C-z will bring you in the buffer
-corresponding to the file you are grepping. 
- Well nothing new, but using C-u C-z will record this place in the
-mark-ring. So if you want to come back later to these places no need to
-grep again, you will find all these places in the mark-ring.
- Accessing the mark-ring in Emacs is really inconvenient, fortunately,
-you will find in helm-config `helm-all-mark-ring` which is a mark-ring
-browser (helm-command-prefix-key  C-c SPACE). `helm-all-mark-ring` is in helm menu also, in
-the tool section.
+ As always, C-z will bring you in the buffer corresponding to the file
+you are grepping. Well nothing new, but using C-u C-z will record this
+place in the mark-ring. So if you want to come back later to these
+places, there is no need to grep again, you will find all these places
+in the mark-ring. Accessing the mark-ring in Emacs is really
+inconvenient, fortunately, you will find in helm-config
+`helm-all-mark-ring` which is a mark-ring browser
+(helm-command-prefix-key C-c SPACE). `helm-all-mark-ring` is in helm
+menu also, in the tool section.
 
 -   TIP: Bind `helm-all-mark-ring` to C-c SPACE.
 
@@ -666,8 +546,6 @@ the tool section.
 
 -   NOTE: `helm-all-mark-ring` handle global-mark-ring also.
 
-
-
 ## Save grep session
 
  If you want to save the results of your grep
@@ -677,12 +555,9 @@ NOTE: You can save differents named helm grep buffers.
       If you haven't saved your grep session in a named buffer, you can anyway retrieve
       the last session with `helm-resume`.
 
-
-
-
 # Helm M-x
 
- It is binded to `helm-command-prefix-key` `M-x`, you should bind it to `M-x`.
+ It is bound to `helm-command-prefix-key` `M-x`, you should bind it to `M-x`.
 
 Features:
 
@@ -692,18 +567,11 @@ Features:
 
 -   The key binding of command are shown.
 
-
-
-
-
 # Helm regexp
 
  This is a replacement of regexp-builder. The groups
 are shown in a convenient way.
 
-
-
-
 # Query replace regexp
 
  Write your regexp in helm-regexp, when it
@@ -713,71 +581,48 @@ will narrow this region automatically. {Save regexp as sexp}
  When you use this, it will save your regexp for
 further use in lisp code, with backslash duplicated.
 
-
-
-
 ## Save regexp as string
 
- Save the regexp as you wrote it.
-
-
-
-
+ Save the regexp as you write it.
 
 ## Helm locate
 
- First be sure you have a locate program installed on
-your system. Most GNU/Linux distro come with locate included, you update
-or create the data base with `updatedb` command.
-
-
-
+ First be sure you have `locate` installed on
+your system. Most GNU/Linux distros come with locate included, you update
+or create the database with `updatedb` command.
 
 ## Search files
 
-
-
 To use, just launch
 
     M-x helm-locate
 
-Then enter filename at prompt. It will search this pattern entered also
-in directory and subdirectory names, to limit your search to basename,
-add `-b` after pattern. The search is performed on all files known in
-database, they maybe not exists anymore, so to limit to really existing
-files add after pattern `-e`. To limit you search to specific number of
-results, use `-n` after your pattern with the number of results you
-want.
+Then enter filename at prompt. It will search this pattern entered
+also in directory and subdirectory names. To limit your search to
+basename, add `-b` after the pattern. The search is performed on all
+files known to the database. They maybe not exist anymore, so to
+limit to really existing files add `-e` after the pattern. To limit your
+search to specific number of results, use `-n` after your pattern with
+the number of results you want.
 
 Example:
 
     Pattern: emacs -b -e -n 12
 
-
 You can also launch `helm-locate` from `helm-find-files`, just do `C-x C-f`.
 (With a prefix arg it will let you choose a local DB file)
 
-
-
 ## Launch grep
 
-
-
-When search is done, you can search in a specific file or directory with
+When the search is done, you can search in a specific file or directory with
 grep that you will find in action menu (TAB).
 
 -   NOTE:You can now launch grep with (C-u) M-g s without switching to
     the action pannel.
 
-
-
-
-
 ## Use a local locate DB
 
-
-
-You can specify a specific database with prefix argument ARG (C-u). Many
+You can specify a `locate` database with prefix argument ARG (C-u). Many
 databases can be used: navigate and mark them. See also
 `helm-locate-with-db`.
 
@@ -787,33 +632,18 @@ To create a user specific db, use:
 
 Where `dbpath` is a filename matched by `helm-locate-db-file-regexp`
 
-
-
-
-
 # Windows specificity
 
-
-
-On Windows you should use Everything program that mimic locate, is very
-fast and don't need to update database manually. To use with
+On Windows you should use Everything program that mimics locate, it is very
+fast and you don't need to update database manually. To use with
 helm-locate, you will need his command line named `es`. Be sure to
 modify the PATH environment variable, to include path to the directory
 that contain `es`.
 
-
-
-
-
 # Helm Etags
 
-
-
-
 ## Create the tag file
 
-
-
 To use etags in Emacs you have first to create a TAGS file for your
 project with the etags shell command. If your directory contains
 subdirectories use someting like:(e.g .el files)
@@ -824,21 +654,16 @@ Otherwise
 
     etags *.el
 
-is enough
+is enough.
 
 For more infos see the man page of etags.
 
-
-
-
-
 ## Start helm etags
 
-
-
-Now just using `helm-command-prefix-key` `e` will show you all entries. If the project is big
-it take some time to load tag file but when it is done, next search will
-be very fast. If you modify the TAGS file, use
+Now just using `helm-command-prefix-key` `e` will show you all
+entries. If the project is big, It take some time to load tag file.
+But when it is done, the next search will be very fast. If you modify
+the TAGS file, use
 
     C-u C-u helm-command-prefix-key e
 
@@ -848,14 +673,8 @@ To search the definition at point use just
 
     C-u helm-command-prefix-key e
 
-
-
-
-
 # Firefox bookmarks
 
-
-
 You will have to set firefox to import bookmarks in his html file
 book-marks.html.
 
@@ -874,7 +693,7 @@ Now you can use
 
     M-x helm-firefox-bookmarks
 
-To see your firefox bookmarks from Emacs. When you are in firefox things
+To see your firefox bookmarks from Emacs. When you are in firefox, things
 are a little more complicated. You will need wmctrl program and a script
 named ffbookmarks :
 
@@ -893,47 +712,34 @@ Firefox is not aware about this new protocol, you will have to instruct
 it. See Firefox documentation or use firefox-protocol.el package you can
 get here: 
  <https://github.com/thierryvolpiatto/emacs-bmk-ext> 
- Install new protocol: 
+ Install ffbookmarks: 
 
     M-x firefox-protocol-installer-install
 
-to install new protocol ffbookmarks Then install a bookmarklet in
-firefox : Right click on the bookmark toolbar in firefox and add a new
-bookmark called ffbookmarks. Add this instead of url: 
+Then install a bookmarklet in firefox: Right click on the bookmark
+toolbar in firefox and add a new bookmark called ffbookmarks. Add this
+instead of url:
 
     javascript:location.href='ffbookmarks://localhost'
 
 Now when you click on ffbookmarks it will bring you in Emacs and allow
 you to browse your bookmarks with helm. 
- NOTE : emacs server need to be started in the running Emacs, see Emacs
+ NOTE : Emacs server needs to be started in the running Emacs, see Emacs
 documentation.
 
-
-
-
-
 # Helm for buffers
 
     M-x helm-buffers-list
 
+## Boring buffers
 
-
-
-## Borring buffers
-
-Will show you your buffers list without borring buffers defined by
-regexp in `helm-c-boring-buffer-regexp`. Just use customize to set that
-for your need.
-
-
-
-
+This will show you your buffer list without boring buffers, which are
+defined in `helm-c-boring-buffer-regexp`. Use customize as usual.
 
 ## Search buffers by major-mode
 
-
-
-Once in this helm session, you can narrow your buffer list by `major-mode`, regexp as usual or the both:
+Once in the helm session, you can narrow your buffer list by
+`major-mode`, regexp as usual or both:
 
 Example:
 
@@ -943,11 +749,11 @@ I want to show all my buffer that are in emacs-lisp mode:
 
 will show all emacs-lisp and lisp related buffers.
 
-Now i want to limit these buffers to the one that match `any`
+Now I want to limit these buffers to the one that match `any`
 
     Pattern: lisp any 
 
-Now i want to limit these buffers to the one that match `any` but end with `foo`:
+Now I want to limit these buffers to the one that match `any` but end with `foo`:
 
     Pattern: lisp any foo
 
@@ -958,49 +764,35 @@ buffers:
 
     Pattern: any 
 
-
-
-
-
 ## Different colors for buffers
 
-
-
--   If a buffer is modified, it will showup in orange.
+-   If a buffer is modified, it will show up in orange.
 
 -   If a buffer have been modified by some external program (e.g sed) in
-    the back of emacs, it will showup in red.
+    the back of Emacs, it will show up in red.
 
 -   Non–buffer file, Directory and files have differents face.
 
-
-
-
-
 # Special commands
 
  Not complete.
 
 `C-c ?` will show you all commands available.
 
-
-
 # Helm Resume
 
 You can resume an helm session at any moment.
 
 When called with a prefix arg allow choosing among different sessions.
 
-
 # Other tools
 
-In addition of what is described above, you will find a bunch of
-powerfull tools that come with helm-config.el. Just browse the helm
-commands availables with helm-M-x.
+In addition to the above, you will find a bunch of powerful tools that
+come with helm-config.el. Just browse the available helm commands with
+`M-x` `helm-`.
 
 Not complete.
 
-
 # Helm mode
 
  `helm-mode` will enable
@@ -1010,7 +802,7 @@ helm completion in all Emacs commands using `completing-read` or `read-file-name
 
     M-x helm-mode
 
-Turn it on in .emacs with:
+Turn it on in `init.el` with:
 
     (helm-mode 1)
 
@@ -1021,23 +813,13 @@ See C-h v `helm-completing-read-handlers-alist` for more infos.
 
 Not complete.
 
-
-
-
-
 # Helm Eshell completion
 
-
-
-
-
 ## Enable helm pcomplete
 
-
-
 Of course pcomplete is already enabled in Eshell, but what we want here
 is to enable it with helm support. 
- To enable it's easy, just add to `.emacs.el`:
+ Enabling is easy, just add to `init.el`:
 
 >     (add-hook 'eshell-mode-hook
 >               #'(lambda ()
@@ -1046,15 +828,9 @@ is to enable it with helm support.
 >                     'helm-esh-pcomplete)))
 
 Now when hitting `TAB`, you should have helm pcompletion.
- 
-
-
-
 
 ## Write your own pcomplete functions
 
-
-
 You can enhance Emacs pcomplete by writing your own pcomplete
 functions.
  
@@ -1093,15 +869,9 @@ functions.
                                        (pcomplete-arg 'last) t))))
         (while (pcomplete-here (pcomplete-entries) nil 'identity))))
 
-
-
-
-
 ## Enable helm Eshell history
 
-
-
-Add this to `.emacs.el`
+Add this to `init.el`
 
 >     (add-hook 'eshell-mode-hook
 >               #'(lambda ()
@@ -1109,22 +879,12 @@ Add this to `.emacs.el`
 >                     (kbd "M-p")
 >                     'helm-eshell-history)))
 
-
-
-
-
 # Usefuls extensions
 
  Not complete.
 
-
-
-
-
 # Usefuls links
 
-
-
 You can have infos about helm on Github.
  <https://github.com/emacs-helm/helm>
 
@@ -1135,6 +895,5 @@ Or at gmane: [gmane.emacs.helm.user](http://dir.gmane.org/gmane.emacs.helm.user)
 
 !REF
 
-
 [1]: https://github.com/emacs-helm/helm/blob/master/doc/Home.mdpp
 [2]: https://github.com/thierryvolpiatto/markdown-pp#readme