From d7dd8f4ee9ae14eb07db56e7af9613ffa1b320b6 Mon Sep 17 00:00:00 2001
From: Valdis Vitolins <valdis.vitolins@odo.lv>
Date: Wed, 20 Jan 2016 00:55:31 +0200
Subject: [PATCH] Documentation: words parameter documented for voice files.

---
 docs/voices.md | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/docs/voices.md b/docs/voices.md
index b68271ac..213b28bf 100644
--- a/docs/voices.md
+++ b/docs/voices.md
@@ -1,5 +1,7 @@
 # Voice Files
 
+# Table of contents
+
 - [Contents of Voice Files](#contents-of-voice-files)
   - [Identification Attributes](#identification-attributes)
     - [name](#name)
@@ -18,6 +20,7 @@
     - [breath](#breath)
     - [breathw](#breathw)
     - [speed](#speed)
+    - [words](#words)
   - [Language Attributes](#language-attributes)
     - [phonemes](#phonemes)
     - [dictionary](#dictionary)
@@ -253,6 +256,27 @@ Adjusts the speaking speed by a percentage of the default rate. This
 can be used if a language voice seems faster or slower compared to other
 voices.
 
+#### words
+
+    words <integer value> <integer value>
+
+The first parameter  puts a pause between all words, the value can be **0** to **4**.
+
+The second parameter adds a short pause if a word ends with a vowel and 
+the next words starts with a vowel. Values may be:
+
+* **0**  no pause   
+**1**  no pause, but the two vowels are kept separate.  
+**2**  short pause.
+
+For example:
+
+    words 0 1
+
+Will put a short pause between two words where the first word end with a 
+vowel and the next start with a vowel. 
+
+
 ### Language Attributes
 
 #### phonemes