Swift Navigation Doxygen style example

example.c

/** Brief description which ends at this dot.
 * Details follow here.
 *
 * \todo Fix the bugs
 *
 * \param a Description of first argument
 * \param b Description of second argument
 * \return Descripton of the return value
 */
float lolz(int a, int b)
{
  ...
}

/** Description of this global. */
int teh_global = 22;

typedef struct {
  double x; /**< The x coordinate, in meters */
  double y; /**< The y coordinate, in meters */
} point;