Fix missing accent character regression
[spray] / Readme.org
index 069f8e59f7662bd37f7017e7f17c1938167576b4..9485f1b8a0fc0b75528176e12f0b3652a8e17f58 100644 (file)
@@ -4,6 +4,14 @@ A speed reading mode for Emacs.
 
 The algorithm is inspired from [[https://github.com/Miserlou/OpenSpritz][OpenSpritz]].
 
+
+** Screencast
+
+[[screencast.gif]]
+
+The story continues at [[https://www.gnu.org/philosophy/right-to-read.html][gnu.org]]
+
+
 ** Deficiencies in similar projects which spray.el solves:
 
 Mostly as of June 28, 2014.
@@ -44,11 +52,6 @@ Downsides compared to similar projects:
 - The emacs learning curve.
 - Would be hard to get running on a phone.
 
-
-** Screencast
-
-[[screencast.gif]]
-
 ** Installation
 
 Put spray.el into a "load-path"ed directory, and load it in your init
@@ -92,6 +95,7 @@ You may customize spray by modifying following items:
 - [Variable] spray-height
 - [Variable] spray-margin-top
 - [Variable] spray-margin-left
+- [Variable] spray-ramp
 - [Keymap] spray-mode-map
 - [Face] spray-base-face
 - [Face] spray-accent-face
@@ -103,9 +107,11 @@ In =./spray.el=, the functions =spray--word-at-point=, =spray--update= and =spra
 
 *** Algorithm translated from code to english
 
-Words are split at space, tab and newline characters, and if any of the characters =.!?;= appear in a word, a blank word is appended to the current word.
+Words are split at space, tab, newline, and emdash characters. If any of the characters =.!?;= appear at the end of the word, a blank word is appended to the current word. 
+
+Each word is displayed for (60 / the choosen wpm) seconds, except if the word ends with ,:— or is greater than 9 characters long, in which case it is displayed for twice as long.
 
-Each word is displayed for (60 / the choosen wpm) seconds, except if the word contains : or , or is greater than 9 characters long, in which case it is displayed for twice as long.
+When started, an added delay is optionally added, based on the spray-ramp variable. See it's documentation for details.
 
 The accent location is chosen as the nth character in a word, depending on its length, based on the following table
 | length | accent position |