more doc
fix segv from LOS calculations
doxygen for all code