diff -r 81e3fc19524f -r ab8ba6a9ced9 AbstractOperatingSystem.st
--- a/AbstractOperatingSystem.st	Wed Aug 29 09:35:11 2018 +0200
+++ b/AbstractOperatingSystem.st	Wed Aug 29 09:58:09 2018 +0200
@@ -6675,6 +6675,8 @@
 
     "portable:
      OperatingSystem speak:'hello world - this is the default voice' voiceName:nil
+
+    non-portable (depends on voice-name mappings):     
      OperatingSystem speak:'hello world - this is a male voice' voiceName:'male'
      OperatingSystem speak:'hello world - this is a female voice' voiceName:'female'
      OperatingSystem speak:'hello world - this is a computer voice' voiceName:'computer'
@@ -6691,6 +6693,8 @@
      OperatingSystem speak:'hello world - this is a pipe organ speaking' voiceName:'Pipe Organ'
      OperatingSystem speak:'hello world - happy birthday to you' voiceName:'Good News'
     "
+
+    "Modified (comment): / 29-08-2018 / 09:42:07 / Claus Gittinger"
 !
 
 voiceCommandSpec
@@ -6737,7 +6741,7 @@
 voiceMapping
     "return a mapping from common (OS-independent) voice names
      to OS-specific names or IDs.
-     The speak:voiceName interface will recgnize both.
+     The speak:voiceName interface will recognize both.
      For portable programs, always use the OS-independent name and
      let every OS xlate to its internal name."
 
@@ -6759,16 +6763,14 @@
             'default' -> 'Fiona'
         }
     "
+
+    "Modified (comment): / 29-08-2018 / 09:42:40 / Claus Gittinger"
 !
 
 voiceMapping:aMapping
-    "return a mapping from common (OS-independent) voice names
+    "set a mapping from common (OS-independent) voice names
      to OS-specific names or IDs.
-     The speak:voiceName interface will recgnize both.
-     For portable programs, always use the OS-independent name and
-     let every OS xlate to its internal name."
-
-    "The mapping here maps all common names to the default"
+     The speak:voiceName interface will recgnize both."
 
     VoiceMapping := aMapping
 
@@ -6781,6 +6783,8 @@
                 'default' -> 'Fiona'
             }.
     "
+
+    "Modified (comment): / 29-08-2018 / 09:57:45 / Claus Gittinger"
 ! !
 
 !AbstractOperatingSystem class methodsFor:'time and date'!