X-Git-Url: https://iankelling.org/git/?p=spray;a=blobdiff_plain;f=Readme.org;h=2c1363a8edce4a5aae428d652c69fe4d5357a632;hp=abdeff15b070ff352e440078bb3a442aaff77ae2;hb=56e5f215f349620f23022947e00676d29bd38794;hpb=7d12eb735a08d4b389a9f0c4a59061e93b3bca6e

diff --git a/Readme.org b/Readme.org
index abdeff1..2c1363a 100644
--- a/Readme.org
+++ b/Readme.org
@@ -1,16 +1,58 @@
 * spray.el
 
-A speed reading mode for Emacs (an elisp implementation of
-[[https://github.com/Miserlou/OpenSpritz][OpenSpritz]]).
+A speed reading mode for Emacs.
+
+The algorithm is taken from [[https://github.com/Miserlou/OpenSpritz][OpenSpritz]] (with a few modifications).
+
+NOTE: This is a WIP project and thus APIs may change.
+
+** Screencast
+
+[[screencast.gif]]
 
 ** Installation
 
-Put this script into a "load-path"ed directory, and load it in your
-init file.
+Put cedit.el into a "load-path"ed directory, and load it in your init
+file.
 
 : (require 'spray)
 
-Then you may run spray with "M-x spray-mode". Binding some keys may
-also be useful.
+Then you can start spraying from the cursor position with =M-x
+spray-mode=. Binding some keys may also be useful.
 
 : (global-set-key (kbd "<f6>") 'spray-mode)
+
+** Commands
+
+In spray-mode buffers, following commands are available.
+
+- =spray-start/stop= (SPC) ::
+     pause or resume spraying
+
+- =spray-backward-word= (h, <left>) ::
+     pause and back to the last word
+
+- =spray-forward-word= (l, <right>) ::
+     inverse of =spray-backward-word=
+
+- =spray-faster= (f) ::
+     increases speed
+
+- =spray-slower= (s) ::
+     decreases speed
+
+- =spray-quit= (q, <return>) ::
+     quit =spray-mode=
+
+
+** Customization
+
+You may customize spray by modifying following items:
+
+- [Variable] spray-wpm
+- [Variable] spray-height
+- [Variable] spray-margin-top
+- [Variable] spray-margin-left
+- [Keymap] spray-mode-map
+- [Face] spray-base-face
+- [Face] spray-accent-face