Refactor:core:Some doxygen additions and corrections (#406)

Signed-off-by: mvglasow <michael -at- vonglasow.com>

navit/attr.c

@@ -689,6 +689,19 @@ attr_generic_prepend_attr(struct attr **attrs, struct attr *attr)
 	return curr;
 }
 
+/**
+ * @brief Removes an attribute from an attribute list.
+ *
+ * If `attrs` contains `attr`, a new attribute list is created (which contains all attributes, except
+ * for `attr`) and both `attrs` (the original attribute list) and `attr` are freed.
+ *
+ * If `attrs` does not contain `attr`, this function is a no-op.
+ *
+ * @param attrs The attribute list
+ * @param attr The attribute to remove from the list
+ *
+ * @return The new attribute list
+ */
 struct attr **
 attr_generic_remove_attr(struct attr **attrs, struct attr *attr)
 {

navit/binding/dbus/binding_dbus.c

@@ -1350,12 +1350,6 @@ request_navit_zoom(DBusConnection *connection, DBusMessage *message)
 
 }
 
-/**
- * @brief Exports the current route as a GPX file
- * @param connection The DBusConnection object through which a message arrived
- * @param message The DBusMessage including the 'filename' parameter
- * @returns An empty reply if everything went right, otherwise DBUS_HANDLER_RESULT_NOT_YET_HANDLED
- */
 static DBusHandlerResult
 request_navit_zoom_to_route(DBusConnection *connection, DBusMessage *message)
 {
@@ -1375,6 +1369,13 @@ request_navit_zoom_to_route(DBusConnection *connection, DBusMessage *message)
 
 }
 
+/**
+ * @brief Exports the current route as a GPX file.
+ *
+ * @param connection The DBusConnection object through which a message arrived
+ * @param message The DBusMessage including the `filename` parameter
+ * @returns An empty reply if everything went right, otherwise `DBUS_HANDLER_RESULT_NOT_YET_HANDLED`
+ */
 static DBusHandlerResult
 request_navit_route_export_gpx(DBusConnection *connection, DBusMessage *message)
 {