ALLJOYN-1709 Generate API documentation for C bindings

This required adding doxygen to the C bindings.  As well as addressing all of
the errors that doxygen reported in the documentation.

While fixing the documentation it was discovered that the PropertyChanged
callback needed to be updated.

Change-Id: Ic0749aa96f9cfa5db79c791c598b5d40863b5922