Patches to add doxygen support to build and add some comments.

[Jef Driesen]

On 07-11-16 13:05, Anton Lundin wrote:
> On 04 November, 2016 - Ryan McLean wrote:
>> |You also started to document some internal stuff. But none of that is
>> |supposed to end up in the documentation! The part that needs to be
>> |documented are the public header files.
>>
>> I started there as I was trying to understand how libdivecomputer acutally works and
>> figured all should be documented. I thought there would be two types of developers:
>> 1) those using your public API such as subsurface
>> 2) those wanting to contribute to libdivecomputer itself.
>> Maybe should have two subfolders in the docs dir; public API and fulldoc.
>>
>
> One can use the
> http://www.stack.nl/~dimitri/doxygen/manual/commands.html#cmdinternal to
> separate whats "internal" and whats external documentation.
>
> That way one can "hide" internal api's when generating the "normal"
> documentation, but still have them documented the same way, and include
> them when generating the "internal" documentation for libdivecomputer.

It's even more simple: only the header files in the include directory are 
public, everything else is private.

Jef