godlike wrote:Normally doxygen goes to the header but I don't have a convincing reason. Maybe, the only benefit I see is that if you compile and distribute newton the .cpp will disappear where the .h will still be there.
The .h is the header which is why people normally put comments their as far as i understand (Though i am use to Delphi's way of doing it where everything is in a single file instead of two). Technically having comments in the .h would be better because as you said the .h will be distributed but the .cpp may not (I.E With the DLL's the only thing thats needed is the header and dll).
Though given that Julio is basically the only person working on the source (No one comes close to his commit amount) its really whatever he prefers (I would love to be able to work on the source but Physics Maths is way over my head).