FUEL: README reformatted.

misc/fuel/README

@@ -1,15 +1,15 @@
-FUEL, Factor's Ultimate Emacs Library
+FUEL, Factor's Ultimate Emacs Library                              -*- org -*-
 -------------------------------------
 
 FUEL provides a complete environment for your Factor coding pleasure
 inside Emacs, including source code edition and interaction with a
 Factor listener instance running within Emacs.
 
-FUEL was started by Jose A Ortega as an extension to Ed Cavazos'
-original factor.el code.
+FUEL was started by Jose A Ortega as an extension to Eduardo Cavazos'
+original factor.el code. Eduardo is also responsible of naming the
+beast.
 
-Installation
-------------
+* Installation
 
   FUEL comes bundled with Factor's distribution. The folder misc/fuel
   contains Elisp code, and there's a fuel vocabulary in extras/fuel.
@@ -31,8 +31,7 @@ inside Emacs, you can use instead:
   (setq factor-mode-use-fuel nil)
   (require 'factor-mode)
 
-Basic usage
------------
+* Basic usage
 
   If you're using the default factor binary and images locations inside
   the Factor's source tree, that should be enough to start using FUEL.
@@ -44,13 +43,12 @@ To start the listener, try M-x run-factor.
   Many aspects of the environment can be customized:
   M-x customize-group fuel will show you how many.
 
-Quick key reference
--------------------
+* Quick key reference
 
   (Triple chords ending in a single letter <x> accept also C-<x> (e.g.
   C-cC-eC-r is the same as C-cC-er)).
 
-* In factor source files:
+*** In factor source files:
 
     - C-cz : switch to listener
     - C-co : cycle between code, tests and docs factor files
@@ -76,7 +74,7 @@ C-cC-eC-r is the same as C-cC-er)).
     - C-cM-<, C-cC-d< : show callers of word at point
     - C-cM->, C-cC-d> : show callees of word at point
 
-* In the listener:
+*** In the listener:
 
     - TAB : complete word at point
     - M-. : edit word at point in Emacs
@@ -87,14 +85,14 @@ C-cC-eC-r is the same as C-cC-er)).
     - C-ch : help for word at point
     - C-ck : run file
 
-* In the debugger (it pops up upon eval/compilation errors):
+*** In the debugger (it pops up upon eval/compilation errors):
 
     - g : go to error
     - <digit> : invoke nth restart
     - w/e/l : invoke :warnings, :errors, :linkage
     - q : bury buffer
 
-* In the Help browser:
+*** In the Help browser:
 
     - h : help for word at point
     - a : find words containing given substring (M-x fuel-apropos)
@@ -109,7 +107,7 @@ C-cC-eC-r is the same as C-cC-er)).
     - C-cz : switch to listener
     - q : bury buffer
 
-* In crossref buffers
+*** In crossref buffers
 
     - TAB/BACKTAB : navigate links
     - RET/mouse click : follow link