summaryrefslogtreecommitdiffstats
path: root/src/serial.c
diff options
context:
space:
mode:
authorNeels Hofmeyr <nhofmeyr@sysmocom.de>2017-06-20 00:17:59 +0200
committerNeels Hofmeyr <nhofmeyr@sysmocom.de>2017-06-23 00:18:22 +0000
commit87e4550585c643e97e0003119b254251ac5ed1d4 (patch)
tree9287f66aba70e9253f4d62926c54dddeb492895e /src/serial.c
parent249fb71a2e124acb191b7cd4d2c3af6a45da4a5e (diff)
doxygen: enable AUTOBRIEF, drop \brief
Especially for short descriptions, it is annoying to have to type \brief for every single API doc. Drop all \brief and enable the AUTOBRIEF feature of doxygen, which always takes the first sentence of an API doc as the brief description. Change-Id: I11a8a821b065a128108641a2a63fb5a2b1916e87
Diffstat (limited to 'src/serial.c')
-rw-r--r--src/serial.c10
1 files changed, 5 insertions, 5 deletions
diff --git a/src/serial.c b/src/serial.c
index 51a32bbc..b8c347bd 100644
--- a/src/serial.c
+++ b/src/serial.c
@@ -24,7 +24,7 @@
/*! \addtogroup serial
* @{
- * \brief Osmocom serial port helpers
+ * Osmocom serial port helpers
*/
/*! \file serial.c */
@@ -50,7 +50,7 @@
# define dbg_perror(x) do { } while (0)
#endif
-/*! \brief Open serial device and does base init
+/*! Open serial device and does base init
* \param[in] dev Path to the device node to open
* \param[in] baudrate Baudrate constant (speed_t: B9600, B...)
* \returns >=0 file descriptor in case of success or negative errno.
@@ -149,7 +149,7 @@ _osmo_serial_set_baudrate(int fd, speed_t baudrate)
return 0;
}
-/*! \brief Change current baudrate
+/*! Change current baudrate
* \param[in] fd File descriptor of the open device
* \param[in] baudrate Baudrate constant (speed_t: B9600, B...)
* \returns 0 for success or negative errno.
@@ -161,7 +161,7 @@ osmo_serial_set_baudrate(int fd, speed_t baudrate)
return _osmo_serial_set_baudrate(fd, baudrate);
}
-/*! \brief Change current baudrate to a custom one using OS specific method
+/*! Change current baudrate to a custom one using OS specific method
* \param[in] fd File descriptor of the open device
* \param[in] baudrate Baudrate as integer
* \returns 0 for success or negative errno.
@@ -210,7 +210,7 @@ osmo_serial_set_custom_baudrate(int fd, int baudrate)
#endif
}
-/*! \brief Clear any custom baudrate
+/*! Clear any custom baudrate
* \param[in] fd File descriptor of the open device
* \returns 0 for success or negative errno.
*