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

phsource/ph_english

 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
 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
 endphoneme
 
 
-phoneme @L
+phoneme @L // simp**le**
   vowel  starttype #@  endtype l
   ipa ə|l
   unstressed
 endphoneme
 
 
-phoneme a#
+phoneme a# // **a**bout. This may be \[@\] or may be a more open schwa.
   vowel  starttype #@  endtype #@
   ipa ɐ
   unstressed
 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
 endphoneme
 
 
-phoneme E
+phoneme E // dr**e**ss
   vowel  starttype #e  endtype #e
   length 140
   IF nextPhW(n) THEN
 
 
 
-phoneme I
+phoneme I // k**i**t
   vowel  starttype #i  endtype #i
   length 130
   IfNextVowelAppend(;)
 endphoneme
 
 
-phoneme I2
+phoneme I2 // **i**ntend. As \[I\], but also indicates an unstressed syllable.
   vowel  starttype #i  endtype #i
   unstressed
   length 130
 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
 endphoneme
 
 
-phoneme 0
+phoneme 0 // l**o**t
   vowel  starttype #o  endtype #o
   length 140
   ChangeIfDiminished(@)
 
 
 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
 
 endphoneme
 
 
-phoneme U
+phoneme U // f**oo**t
   vowel  starttype #o  endtype #o
   length 150
   
 
 
 
-phoneme A:
+phoneme A: // p**al**m
   vowel  starttype #a  endtype #a
   length 230
   IfNextVowelAppend(r-)
 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
 
 
 
-phoneme 3:
+phoneme 3: // n**ur**se
   vowel  starttype #@  endtype #@
   length 210
   IfNextVowelAppend(r-)
 endphoneme
 
 
-phoneme i:
+phoneme i: // fl**ee**ce
   vowel  starttype #i  endtype #i
   length 175
   IfNextVowelAppend(;)
 endphoneme
 
 
-phoneme O:
+phoneme O: // th**ou**ght
   vowel  starttype #o  endtype #o
   length 230
   ChangeIfDiminished(@)
 endphoneme
 
 
-phoneme O@
+phoneme O@ // n**or**th
   vowel  starttype #o  endtype #o
   ipa ɔː
   length 240
 endphoneme
 
 
-phoneme o@
+phoneme o@ // f**or**ce
   vowel  starttype #o  endtype #o
   ipa ɔː
   length 250
 endphoneme
 
 
-phoneme u:
+phoneme u: // g**oo**se
   vowel  starttype #u  endtype #u
   length 210
   IF nextPh(l/2) THEN
 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
 endphoneme
 
 
-phoneme aI
+phoneme aI // pr**i**ce
   vowel  starttype #a  endtype #i
   length 240
   IF nextPh(#a) THEN
 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-)
 endphoneme
 
 
-phoneme i@
+phoneme i@ // n**ear**
   vowel  starttype #i  endtype #@
   length 250
   IfNextVowelAppend(r-)
 endphoneme
 
 
-phoneme U@
+phoneme U@ // c**ure**
   vowel  starttype #u  endtype #@
   length 200
   IfNextVowelAppend(r-)
 endphoneme
 
 
-phoneme aI@
+phoneme aI@ // sc**ie**nce
   vowel  starttype #a  endtype #@
   length 280
   IfNextVowelAppend(r-)
 endphoneme
 
 
-phoneme aU@
+phoneme aU@ // h**our**
   vowel  starttype #a   endtype #@
   length 280
   IfNextVowelAppend(r-)

phsource/phonemes

 
 // Some default vowel definitions
 
-phoneme @    //  Schwa
+phoneme @    //  Schwa, e.g. alph**a**
   vowel   starttype #@  endtype #@
   unstressed
   length 140
 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)
 endphoneme
 
 
-phoneme o
+phoneme o // German **oo**, French **o**
   vowel starttype #o endtype #o
   length 170
   FMT(vowel/oo)
 endphoneme
 
 
-phoneme r
+phoneme r // **r**ed (Omitted if not immediately followed by a vowel)
   liquid rhotic
   ipa ɹ
   lengthmod 7
 
 
 
-phoneme l^    // palatal l
+phoneme l^    // palatal l, e.g. Italian **g**li
   liquid
   ipa ʎ
   lengthmod 7
 
 
 
-phoneme j
+phoneme j // **y**es
   liquid palatal starttype #i
   lengthmod 7
 
 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
 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'
 endphoneme
 
 
-phoneme dZ
+phoneme dZ // **j**udge
   vcd pla afr sibilant
   voicingswitch tS
   lengthmod 5
 endphoneme
 
 
-phoneme D
+phoneme D // **th**is
   vcd dnt frc
   voicingswitch T
   lengthmod 6
 endphoneme
 
 
-phoneme Z
+phoneme Z // plea**s**ure
   vcd pla frc sibilant
   voicingswitch S
   lengthmod 6
 endphoneme
 
 
-phoneme tS
+phoneme tS     // **ch**urch
   vls pla afr sibilant
   voicingswitch dZ
   lengthmod 2
 endphoneme
 
 
-phoneme T
+phoneme T   // **th**in
   vls dnt frc
   voicingswitch D
   lengthmod 3
 endphoneme
 
 
-phoneme S
+phoneme S // **sh**op
   vls pla frc sibilant
   voicingswitch Z
   lengthmod 3
 endphoneme
 
 
-phoneme C
+phoneme C // German i**ch**
   vls pal frc palatal
   lengthmod 3
   Vowelin f1=0  f2=2700 400 600  f3=200 70
 endphoneme
 
 
-phoneme x
+phoneme x // German bu**ch**
   vls vel frc
   voicingswitch Q
   lengthmod 3