From 1f225e7cb28c42ea9e03e31fa0b4c22c40a9aad3 Mon Sep 17 00:00:00 2001
From: Valdis Vitolins <valdis.vitolins@odo.lv>
Date: Mon, 4 Jan 2016 21:55:44 +0200
Subject: [PATCH] Fixes for intonation.md file and new paragraph for
 add_language.md

---
 docs/add_language.md | 32 ++++++++++++++++++++++++++++++++
 docs/intonation.md   |  4 ++--
 2 files changed, 34 insertions(+), 2 deletions(-)

diff --git a/docs/add_language.md b/docs/add_language.md
index 880c386f..f58eb9aa 100644
--- a/docs/add_language.md
+++ b/docs/add_language.md
@@ -1,11 +1,14 @@
 # Adding or Improving a Language
 
+# Table of contents
+
 - [Language Code](#language-code)
 - [Language Files](#language-files)
 - [Voice File](#voice-file)
 - [Phoneme Definition File](#phoneme-definition-file)
 - [Dictionary Files](#dictionary-files)
 - [Program Code](#program-code)
+- [Compiling rules file for debugging](#compiling-rules-file-for-debugging)
 - [Improving a Language](#improving-a-language)
 
 ----------
@@ -163,6 +166,35 @@ required options in `SetTranslator()`. However, this may not be necessary
 during testing because most of the options can also be set in the voice
 file in espeak-data/voices (see [Voice Files](voices.md)).
 
+## Compiling rules file for debugging
+
+When `espeak-ng` is invoked with `-X` parameter, it shows more detailed trace of 
+chosen language rules for pronunciation. This trace can show line numbers also, 
+if language is compiled with `--compile-debug` option.
+
+To do this, go to `espeak-ng` project root folder, then:
+
+    cd dictsource/
+    ../src/espeak-ng --compile-debug=en
+
+When invoked in following way:
+
+    es -ven -X "Test."
+
+It will show:
+
+    --------------
+    Translate 'test'
+      1  5965:  t [t]
+    
+      1  2104:  e [E]
+    
+      1  5725:  s [s]
+    
+      1  5965:  t [t]
+    
+     t'Est
+
 ## Improving a Language
 
 Listen carefully to the eSpeak voice. Try to identify what sounds wrong
diff --git a/docs/intonation.md b/docs/intonation.md
index 2df3b0b2..ae329f14 100644
--- a/docs/intonation.md
+++ b/docs/intonation.md
@@ -108,7 +108,7 @@ are specified.
 
 `start pitch` give a pitch path for the stressed syllables of the head.
 
-steps` is the maximum number of stressed syllables for which this applies. If
+`steps` is the maximum number of stressed syllables for which this applies. If
 there are additional stressed syllables, then the `headextend` statement is used
 for them.
 
@@ -122,7 +122,7 @@ than the previous stressed syllable.
 	headextend <percentage list>
 
 If the head contains more stressed syllables than is specified by `steps` is used.
-Itmcontains up to 8 numbers which are used repeatedly for the additional stressed
+It contains up to 8 numbers which are used repeatedly for the additional stressed
 syllables. A value of 0 corresponds to the lower the `start pitch` values of the
 `head` statement. 100 corresponds to the higher value.