Fixes for intonation.md file and new paragraph for add_language.md

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

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.