some comment fixes, updated the doxygen automagic script and updated the
apparentmotion pilot function