Improve code documentation

PTC code is not properly documented. We need to review it thoroughly and document it better. For the record, a tool such as [doxygen](https://github.com/doxygen/doxygen) might be useful for this purpose.
