Wrote some doku.
Added documentation, including examples in README.md
Created sphinx documentation files with

  sphinx-apidoc -A "J. Katzwinkel" -F -o docs/ kathaireo/

and hopefully stated correct path in docs/conf.py
Changed import statements to relative module paths hoping this would
let sphinx find everything it looks for. This appeared to require to
also move main module kathaireo.py up one level, out of kathaireo
package. After doing all this update, all imports work, even in sphinx.

Because sphinx is not that complicated after all, I began modifying
existing docstrings to work with sphinx, which right now seems fairly
satisfied and produces already pretty nice html output, which is
located at docs/_build and included in this commit.
With the last commit (aef3ffd69a1ae0306439c793d547588e70c4db71), I
forgot to actually commit the changes made to get sphinx to work
with our python sources. Sphinx's html output (make html) is included,
nonetheless.
This commit includes all those changes described in the last one, and the
results of an ambitious attempt to clean things up. Ontology resources
and test codes are now in a directory of their own.
Finally added html docs.
shell.sh: abort if only python 3 is available. add *bold* formatting of single words in output, fix error in debug message at startup.
function handler decorator