Use C style comments in C headers

pi2-view/include/MapAppABI.h

@@ -7,47 +7,61 @@
 extern "C" {
 #endif
 
-/// The application to show a map, a list of vehicles and additional information
+/**
+ * The application to show a map, a list of vehicles and additional information
+ */
 struct MapApp;
 
-/// Creates a MapApp and opens the corresponding window.
-///
-/// You *have* to call mapAppDestroy(MapApp *) to avoid memory leaks.
-///
-/// \returns A pointer to the created MapApp
+/**
+ * Creates a MapApp and opens the corresponding window.
+ *
+ * You *have* to call mapAppDestroy(MapApp *) to avoid memory leaks.
+ *
+ * \returns A pointer to the created MapApp
+ */
 MapApp *mapAppCreate(const char *windowTitle);
 
-/// Destroys \p mapApp and frees its memory.
+/**
+ * Destroys \p mapApp and frees its memory.
+ */
 void mapAppDestroy(MapApp *mapApp);
 
-/// Adds a junction to \p mapApp
-///
-/// The coordinates \p x and \p y mark the middle of the junction
-/// and represent amounts of pixels.
+/**
+ * Adds a junction to \p mapApp
+ *
+ * The coordinates \p x and \p y mark the middle of the junction and represent
+ * amounts of pixels.
+ */
 void mapAppAddJunction(MapApp *mapApp, double x, double y);
 
-/// Adds a road to \p mapApp
-///
-/// \param coordinates A pointer to the begin of an array of the coordinates
-/// The coordinates have to be alternating values of x and y in pixels.
-/// \param coordinateCount The count of \p coordinates
+/**
+ * Adds a road to \p mapApp
+ *
+ * \param coordinates A pointer to the begin of an array of the coordinates
+ * The coordinates have to be alternating values of x and y in pixels.
+ * \param coordinateCount The count of \p coordinates
+ */
 void mapAppAddRoad(MapApp *mapApp, const char *laneThereName,
                    const char *laneBackName, const double *coordinates,
                    size_t coordinateCount);
 
-/// Adds or replaces a vehicle to/in \p mapApp
-///
-/// The parameters \p red \p green and \p blue are the RGB components of the
-/// color representing the vehicle. They have to be between 0 and 1.
-///
-/// \param positionOnLane The relative position of the vehicle on its lane
-/// has to be between 0 and 1.
+/**
+ * Adds or replaces a vehicle to/in \p mapApp
+ *
+ * The parameters \p red \p green and \p blue are the RGB components of the
+ * color representing the vehicle. They have to be between 0 and 1.
+ *
+ * \param positionOnLane The relative position of the vehicle on its lane
+ * has to be between 0 and 1.
+ */
 void mapAppAddOrReplaceVehicle(MapApp *mapApp, const char *vehicleName,
                                const char *roadName, double positionOnLane,
                                double speed, double remainingFuel, double red,
                                double green, double blue);
 
-/// Sets the duration label of \p mapApp to \p minutes
+/**
+ * Sets the duration label of \p mapApp to \p minutes
+ */
 void mapAppSetDurationLabel(MapApp *mapApp, int64_t minutes);
 
 #ifdef __cplusplus