From: Peter Hutterer Date: Mon, 3 Jun 2019 07:01:52 +0000 (+1000) Subject: doc: change @retval documentation to help doxygen with rendering X-Git-Tag: libevdev-1.7.0~6 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=a68e91b172211393e396074670d2111d02aa9760;p=platform%2Fupstream%2Flibevdev.git doc: change @retval documentation to help doxygen with rendering This causes some weird rendering, let's split it into a list (which also happens to be more readable). Signed-off-by: Peter Hutterer --- diff --git a/libevdev/libevdev.h b/libevdev/libevdev.h index 63933bc..aa80e66 100644 --- a/libevdev/libevdev.h +++ b/libevdev/libevdev.h @@ -1531,9 +1531,12 @@ int libevdev_get_event_value(const struct libevdev *dev, unsigned int type, unsi * @param value The new value to set * * @return 0 on success, or -1 on failure. - * @retval -1 the device does not have the event type or code enabled, or the code is outside the - * allowed limits for the given type, or the type cannot be set, or the - * value is not permitted for the given code. + * @retval -1 + * - the device does not have the event type or + * - code enabled, or the code is outside the, or + * - the code is outside the allowed limits for the given type, or + * - the type cannot be set, or + * - the value is not permitted for the given code. * * @see libevdev_set_slot_value * @see libevdev_get_event_value @@ -1608,9 +1611,11 @@ int libevdev_get_slot_value(const struct libevdev *dev, unsigned int slot, unsig * @param value The new value to set * * @return 0 on success, or -1 on failure. - * @retval -1 the device does not have the event code enabled, or the code is - * outside the allowed limits for multitouch events, or the slot number is outside - * the limits for this device, or the device does not support multitouch events. + * @retval -1 + * - the device does not have the event code enabled, or + * - the code is outside the allowed limits for multitouch events, or + * - the slot number is outside the limits for this device, or + * - the device does not support multitouch events. * * @see libevdev_set_event_value * @see libevdev_get_slot_value