From a68e91b172211393e396074670d2111d02aa9760 Mon Sep 17 00:00:00 2001 From: Peter Hutterer Date: Mon, 3 Jun 2019 17:01:52 +1000 Subject: [PATCH] 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 --- libevdev/libevdev.h | 17 +++++++++++------ 1 file changed, 11 insertions(+), 6 deletions(-) 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