About .qmap files
=================
Georges Savoundararadj
07/31/2015

What is a qmap file?
~~~~~~~~~~~~~~~~~~~~

When one wants to change the keyboard layout, he has to
call the function:

void QEglFSFunctions::loadKeymap(const QString & filename)

_filename_ should be the path to the .qmap file that describes
the keyboard layout. [1]

How to generate a .qmap file?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

To generate a .qmap file, you need two programs:
* ckbcomp in console-setup [2]
* kmap2qmap in qttools [3]

For instance, if you want the Turkish layout, you have to find the
Turkish 2-letters layout code which is 'tr'.

Then,

# ckbcomp -layout tr > tr.kmap # Generate the .kmap file
# kmap2qmap tr.kmap tr.qmap    # Translate the .kmap into .qmap

[1] http://doc.qt.io/qt-5.4/qeglfsfunctions.html#loadKeymap
[2] http://anonscm.debian.org/cgit/d-i/console-setup.git/
[3] https://github.com/qtproject/qttools

