clients: Fix/resolved doxygen warnings

Missing/wrong parameters and '[out]' issues.

Signed-off-by: Marius Vlad <marius.vlad@collabora.com>

clients/eventdemo.c

@@ -193,10 +193,11 @@ keyboard_focus_handler(struct window *window,
 /**
  * \brief CALLBACK function, Wayland informs about key event
  * \param window window
+ * \param input input
+ * \param time time
  * \param key keycode
  * \param unicode associated character
  * \param state pressed or released
- * \param modifiers modifiers: ctrl, alt, meta etc.
  * \param data user data associated to the window
  */
 static void
@@ -351,8 +352,8 @@ axis_discrete_handler(struct widget *widget, struct input *input,
  * \param time time the event happened
  * \param x absolute x position
  * \param y absolute y position
- * \param sx x position relative to the window
+ * \param x x position relative to the window
- * \param sy y position relative to the window
+ * \param y y position relative to the window
  * \param data user data associated to the window
  *
  * Demonstrates the use of different cursors

clients/touch-calibrator.c

@@ -108,8 +108,8 @@ struct poly {
  * cancel, multiple touch-downs) needs to undo the current sample and
  * possibly show user feedback "wrong".
  *
- * <STATE>
+ * \<STATE\>
- * - <triggers>: <actions>
+ * - \<triggers\>: \<actions\>
  *
  * IDLE
  * - touch down: sample, -> DOWN

shared/file-util.c

@@ -69,7 +69,7 @@ create_file_excl(const char *fname)
  * \param path File path
  * \param prefix File name prefix.
  * \param suffix File name suffix.
- * \param name_out[out] Buffer for the resulting file name.
+ * \param[out] name_out Buffer for the resulting file name.
  * \param name_len Number of bytes usable in name_out.
  * \return stdio FILE pointer, or NULL on failure.
  *

shared/helpers.h

@@ -123,7 +123,7 @@ extern "C" {
  *     expanded[i] = small[4];
  * @endcode
  *
- * @param condition Expression to check for truth
+ * @param cond Expression to check for truth
  * @param msg Message to print on failure
  */
 #ifndef static_assert