1 files changed, 27 insertions, 2 deletions
diff --git a/src/translator_en.h b/src/translator_en.h
index e327541..4fba718 100644
--- a/src/translator_en.h
+++ b/src/translator_en.h
@@ -1560,16 +1560,41 @@ class TranslatorEnglish : public Translator
 // new since 1.3.9
 //////////////////////////////////////////////////////////////////////////
 
+    /*! This is used as the name of the chapter containing the directory
+     *  hierarchy.
+     */
     virtual QCString trDirIndex()
-    { return "Directories"; }
+    { return "Directory Hierarchy"; }
+
+    /*! This is used as the name of the chapter containing the documentation
+     *  of the directories.
+     */
     virtual QCString trDirDocumentation()
     { return "Directory Documentation"; }
+
+    /*! This is used as the title of the directory index and also in the
+     *  Quick links of a HTML page, to link to the directory hierarchy.
+     */
     virtual QCString trDirectories()
     { return "Directories"; }
+
+    /*! This returns a sentences that introduces the directory hierarchy. 
+     *  and the fact that it is sorted alphabetically per level
+     */
     virtual QCString trDirDescription()
-    { return "Here is a list of all directories:"; }
+    { return "This directory hierarchy is sorted roughly, "
+             "but not completely, alphabetically:";
+    }
+
+    /*! This returns the title of a directory page. The name of the
+     *  directory is passed via \a dirName.
+     */
     virtual QCString trDirReference(const char *dirName)
     { QCString result=dirName; result+=" Directory Reference"; return result; }
+
+    /*! This returns the word directory with or without starting capital
+     *  (\a first_capital) and in sigular or plural form (\a singular).
+     */
     virtual QCString trDir(bool first_capital, bool singular)
     { 
       QCString result((first_capital ? "Director" : "director"));