Phoneme descriptions copied from now removed docs/phonemes.* file to phsource/phonemes and phsource/ph_english files

phsource/ph_english

@@ -124,13 +124,13 @@ phoneme @    //  Schwa
 endphoneme
 
 
-phoneme 3    //  Schwa, used for rhotic schwa in American
+phoneme 3    //  Schwa, used for rhotic schwa in American, e.g. bett**er**
   CALL @
   ipa ə
 endphoneme
 
 
-phoneme @2   //  Schwa, changes to I before a vowel
+phoneme @2   //  Schwa, changes to I before a vowel. th**e**, used only for "the".
   vowel  starttype #@  endtype #@
   unstressed dontlist
   length 120
@@ -141,7 +141,7 @@ phoneme @2   //  Schwa, changes to I before a vowel
 endphoneme
 
 
-phoneme @5   //  Schwa, changes to U before a vowel
+phoneme @5   //  Schwa, changes to U before a vowel. t**o**, used only for "to".
   vowel  starttype #@  endtype #@
   unstressed dontlist
   length 140
@@ -152,7 +152,7 @@ phoneme @5   //  Schwa, changes to U before a vowel
 endphoneme
 
 
-phoneme @L
+phoneme @L // simp**le**
   vowel  starttype #@  endtype l
   ipa ə|l
   unstressed
@@ -179,7 +179,7 @@ phoneme a2  // don't reduce to a#
 endphoneme
 
 
-phoneme a#
+phoneme a# // **a**bout. This may be \[@\] or may be a more open schwa.
   vowel  starttype #@  endtype #@
   ipa ɐ
   unstressed
@@ -193,7 +193,7 @@ phoneme a#
 endphoneme
 
 
-phoneme aa   //   'bath' etc.
+phoneme aa   //   'b**a**th' etc. This is \[a\] in some accents, \[A:\] in others.
   vowel  starttype #a  endtype #a
   ipa a
   length 200
@@ -207,7 +207,7 @@ phoneme aa   //   'bath' etc.
 endphoneme
 
 
-phoneme E
+phoneme E // dr**e**ss
   vowel  starttype #e  endtype #e
   length 140
   IF nextPhW(n) THEN
@@ -240,7 +240,7 @@ endphoneme
 
 
 
-phoneme I
+phoneme I // k**i**t
   vowel  starttype #i  endtype #i
   length 130
   IfNextVowelAppend(;)
@@ -248,7 +248,7 @@ phoneme I
 endphoneme
 
 
-phoneme I2
+phoneme I2 // **i**ntend. As \[I\], but also indicates an unstressed syllable.
   vowel  starttype #i  endtype #i
   unstressed
   length 130
@@ -280,7 +280,7 @@ phoneme I#   // used for [I] which may be [@] in some accents
 endphoneme
 
 
-phoneme i   //  optional variant of [I] for end of words
+phoneme i   // happ**y**. optional variant of [I] for end of words
   vowel  starttype #i  endtype #i
   unstressed
   ipa i
@@ -295,7 +295,7 @@ phoneme i   //  optional variant of [I] for end of words
 endphoneme
 
 
-phoneme 0
+phoneme 0 // l**o**t
   vowel  starttype #o  endtype #o
   length 140
   ChangeIfDiminished(@)
@@ -316,14 +316,14 @@ endphoneme
 
 
 phoneme 02   // becomes V in en-us
-  vowel  starttype #o  endtype #o
+  vowel  starttype #o  endtype #o/
   dontlist
   length 140
   ChangePhoneme(0)
 endphoneme
 
 
-phoneme V
+phoneme V // str**u**t
   vowel  starttype #a  endtype #@
   length 140
 
@@ -332,7 +332,7 @@ phoneme V
 endphoneme
 
 
-phoneme U
+phoneme U // f**oo**t
   vowel  starttype #o  endtype #o
   length 150
   
@@ -346,7 +346,7 @@ endphoneme
 
 
 
-phoneme A:
+phoneme A: // p**al**m
   vowel  starttype #a  endtype #a
   length 230
   IfNextVowelAppend(r-)
@@ -354,7 +354,7 @@ phoneme A:
 endphoneme
 
 
-phoneme A@     // Used for [A:] when followed by 'r'
+phoneme A@     // st**ar**t. Used for [A:] when followed by 'r'.
   vowel  starttype #a  endtype #a
   ipa ɑː
   length 230
@@ -372,7 +372,7 @@ endphoneme
 
 
 
-phoneme 3:
+phoneme 3: // n**ur**se
   vowel  starttype #@  endtype #@
   length 210
   IfNextVowelAppend(r-)
@@ -381,7 +381,7 @@ phoneme 3:
 endphoneme
 
 
-phoneme i:
+phoneme i: // fl**ee**ce
   vowel  starttype #i  endtype #i
   length 175
   IfNextVowelAppend(;)
@@ -392,7 +392,7 @@ phoneme i:
 endphoneme
 
 
-phoneme O:
+phoneme O: // th**ou**ght
   vowel  starttype #o  endtype #o
   length 230
   ChangeIfDiminished(@)
@@ -408,7 +408,7 @@ phoneme O
 endphoneme
 
 
-phoneme O@
+phoneme O@ // n**or**th
   vowel  starttype #o  endtype #o
   ipa ɔː
   length 240
@@ -417,7 +417,7 @@ phoneme O@
 endphoneme
 
 
-phoneme o@
+phoneme o@ // f**or**ce
   vowel  starttype #o  endtype #o
   ipa ɔː
   length 250
@@ -431,7 +431,7 @@ phoneme o@
 endphoneme
 
 
-phoneme u:
+phoneme u: // g**oo**se
   vowel  starttype #u  endtype #u
   length 210
   IF nextPh(l/2) THEN
@@ -444,14 +444,14 @@ phoneme u:
 endphoneme
 
 
-phoneme aU
+phoneme aU // m**ou**th
   vowel  starttype #a  endtype #u
   length 230
   FMT(vdiph/au)
 endphoneme
 
 
-phoneme oU
+phoneme oU // g**oa**t
   vowel  starttype #@  endtype #u
   ipa əʊ
   length 220
@@ -473,7 +473,7 @@ phoneme oU#
 endphoneme
 
 
-phoneme aI
+phoneme aI // pr**i**ce
   vowel  starttype #a  endtype #i
   length 240
   IF nextPh(#a) THEN
@@ -483,21 +483,21 @@ phoneme aI
 endphoneme
 
 
-phoneme eI
+phoneme eI // f**a**ce
   vowel  starttype #e  endtype #i
   length 210
   FMT(vdiph/eei)
 endphoneme
 
 
-phoneme OI
+phoneme OI // ch**oi**ce
   vowel  starttype #o  endtype #i
   length 230
   FMT(vdiph/ooi)
 endphoneme
 
 
-phoneme e@
+phoneme e@ // squ**are**
   vowel  starttype #e  endtype #@
   length 230
   IfNextVowelAppend(r-)
@@ -505,7 +505,7 @@ phoneme e@
 endphoneme
 
 
-phoneme i@
+phoneme i@ // n**ear**
   vowel  starttype #i  endtype #@
   length 250
   IfNextVowelAppend(r-)
@@ -526,7 +526,7 @@ phoneme i@3
 endphoneme
 
 
-phoneme U@
+phoneme U@ // c**ure**
   vowel  starttype #u  endtype #@
   length 200
   IfNextVowelAppend(r-)
@@ -537,7 +537,7 @@ phoneme U@
 endphoneme
 
 
-phoneme aI@
+phoneme aI@ // sc**ie**nce
   vowel  starttype #a  endtype #@
   length 280
   IfNextVowelAppend(r-)
@@ -552,7 +552,7 @@ phoneme aI3
 endphoneme
 
 
-phoneme aU@
+phoneme aU@ // h**our**
   vowel  starttype #a   endtype #@
   length 280
   IfNextVowelAppend(r-)

phsource/phonemes

@@ -136,7 +136,7 @@ endphoneme
 
 // Some default vowel definitions
 
-phoneme @    //  Schwa
+phoneme @    //  Schwa, e.g. alph**a**
   vowel   starttype #@  endtype #@
   unstressed
   length 140
@@ -157,14 +157,14 @@ phoneme @-   //  very short schwa
 endphoneme
 
 
-phoneme a
+phoneme a // tr**a**p
   vowel starttype #a endtype #a
   length 180
   FMT(vowel/a)
 endphoneme
 
 
-phoneme e
+phoneme e // German **eh**, French **é**
   vowel starttype #e endtype #e
   length 170
   FMT(vowel/e)
@@ -179,7 +179,7 @@ phoneme i
 endphoneme
 
 
-phoneme o
+phoneme o // German **oo**, French **o**
   vowel starttype #o endtype #o
   length 170
   FMT(vowel/oo)
@@ -292,7 +292,7 @@ phoneme l-   // syllabic l
 endphoneme
 
 
-phoneme r
+phoneme r // **r**ed (Omitted if not immediately followed by a vowel)
   liquid rhotic
   ipa ɹ
   lengthmod 7
@@ -547,7 +547,7 @@ endphoneme
 
 
 
-phoneme l^    // palatal l
+phoneme l^    // palatal l, e.g. Italian **g**li
   liquid
   ipa ʎ
   lengthmod 7
@@ -640,7 +640,7 @@ endphoneme
 
 
 
-phoneme j
+phoneme j // **y**es
   liquid palatal starttype #i
   lengthmod 7
 
@@ -796,7 +796,7 @@ phoneme n.
 endphoneme
 
 
-phoneme n^
+phoneme n^ // Spanish **ñ**
   vcd pal nasal palatal
   ipa ɲ
   Vowelout f1=3 f2=2500 300 500  f3=100 80  len=45 brk rate
@@ -829,7 +829,7 @@ phoneme n^
 endphoneme
 
 
-phoneme N
+phoneme N // si**ng** 
   vcd vel nasal
   Vowelout f1=3 f2=2300 300 400  f3=-200 80  len=40 rms=20 brk
   lengthmod 8            // longer than 'n'
@@ -1012,7 +1012,7 @@ phoneme d[
 endphoneme
 
 
-phoneme dZ
+phoneme dZ // **j**udge
   vcd pla afr sibilant
   voicingswitch tS
   lengthmod 5
@@ -1165,7 +1165,7 @@ phoneme v#        // approximant, not fricative
 endphoneme
 
 
-phoneme D
+phoneme D // **th**is
   vcd dnt frc
   voicingswitch T
   lengthmod 6
@@ -1200,7 +1200,7 @@ phoneme z
 endphoneme
 
 
-phoneme Z
+phoneme Z // plea**s**ure
   vcd pla frc sibilant
   voicingswitch S
   lengthmod 6
@@ -1392,7 +1392,7 @@ phoneme t[        // dental variant of /t/
 endphoneme
 
 
-phoneme tS
+phoneme tS     // **ch**urch
   vls pla afr sibilant
   voicingswitch dZ
   lengthmod 2
@@ -1492,7 +1492,7 @@ phoneme f
 endphoneme
 
 
-phoneme T
+phoneme T   // **th**in
   vls dnt frc
   voicingswitch D
   lengthmod 3
@@ -1522,7 +1522,7 @@ phoneme s
 endphoneme
 
 
-phoneme S
+phoneme S // **sh**op
   vls pla frc sibilant
   voicingswitch Z
   lengthmod 3
@@ -1603,7 +1603,7 @@ phoneme l#   // Lateral fricative (eg. Welsh "ll")
 endphoneme
 
 
-phoneme C
+phoneme C // German i**ch**
   vls pal frc palatal
   lengthmod 3
   Vowelin f1=0  f2=2700 400 600  f3=200 70
@@ -1616,7 +1616,7 @@ phoneme C
 endphoneme
 
 
-phoneme x
+phoneme x // German bu**ch**
   vls vel frc
   voicingswitch Q
   lengthmod 3