.. -*- fill-column: 78 -*-

.. include:: header.rst

=======================
 gadict HACKING guide.
=======================
.. contents::

Document version.
=================

.. include:: VERSION.rst

Comment syntax convention.
==========================

As 'dictd -c5' format does not support comment syntax we filter out all
lines that start with '#'.

Register gadict dictionaries for dictd under Debian.
====================================================
::

  $ su
  $ cat >>etc/dictd/dictd.order <<EOF
  gadict-dictabbr
  /home/user/usr/share/dictd/
  $ dictdconfig --write
  $ /etc/init.d/dictd restart
  $ ^D
  $ dictdconfig --list
  $ dict -d gadict-dictabbr v


IPA chars.
==========

Hare list of spetial IPA chars (code present in UTF-8 encoding):

  θʃŋʧðʒæıʌʊɒɛəɑɜɔˌˈːˑṃṇḷ
  æɑɒʌәєŋvθðʃʒɚːɡˏˊˋ

You can copy/paste they in phonetic string.

TODO
----
::

            Front       Central     Back
         long  short long  short long  short
  Close   iː    ɪ                 uː    ʊ
  Mid           e     ɜː    ə     ɔː
  Open          æ           ʌ     ɑː    ɒ

      Diphthong          Triphthong
  Closing    Centring
   /eɪ/       /ɪə/        /aɪə/
   /aɪ/       /eə/        /ɑʊə/
   /ɔɪ/       /ʊə/
   /əʊ/
   /aʊ/

Old vs. new transcription.
--------------------------

From "Better English pronunciation."::

  Old  iː i e ɔː u uː ei ou ai au ɔi æ ɔ ʌ əː ɑː iə ɛə uə ə
  New  iː ɪ e ɔː ʊ uː eɪ əʊ aɪ aʊ ɔɪ æ ɒ ʌ ɜː ɑː ɪə eə ʊə ə

Also from wikipedia::

  Old  æ e əː ʌɪ ɑʊ ɛə
  New  a ɛ ɜː aɪ aʊ eə

Emacs.
------

For entering IPA chars use IPA input method. To enable it type::

  C-u C-\ ipa <enter>

All chars from alphabet typed as usual. To type special IPA chars use next key
bindings.

For vowel::

  æ ae
  ɑ o| (small letter o and ) or A (upper letter A)
  ɒ |o () or /A
  ʊ U (upper-letter-u)
  ɛ /3 (slash three)
  ɔ /c
  ə /e
  ʌ /v
  ɪ I

For consonant::

  θ th
  ð dh
  ʃ sh
  ʒ zh or 3
  ŋ ng
  ɡ g

Special chars::

  ː : (semicolon)
  ˈ ' (quote)
  ˌ ` (back quote)