From c7351c2dea57b772f21dacb3c7f8743db8381459 Mon Sep 17 00:00:00 2001
From: Sam Lantinga <slouken@libsdl.org>
Date: Sun, 20 Nov 2016 21:26:56 -0800
Subject: [PATCH] Fixed a few warnings that show up with -Wdocumentation and
 -Wdocumentation-unknown-command, patch contributed by Sylvain

---
 include/SDL_assert.h         | 4 ++--
 include/SDL_gamecontroller.h | 4 +++-
 include/SDL_hints.h          | 6 +++++-
 include/SDL_joystick.h       | 4 +++-
 4 files changed, 13 insertions(+), 5 deletions(-)

diff --git a/include/SDL_assert.h b/include/SDL_assert.h
index 402981f967486..d6e1d672a0196 100644
--- a/include/SDL_assert.h
+++ b/include/SDL_assert.h
@@ -201,7 +201,7 @@ typedef SDL_AssertState (SDLCALL *SDL_AssertionHandler)(
  *
  *  This callback is NOT reset to SDL's internal handler upon SDL_Quit()!
  *
- *  \return SDL_AssertState value of how to handle the assertion failure.
+ *  Return SDL_AssertState value of how to handle the assertion failure.
  *
  *  \param handler Callback function, called when an assertion fails.
  *  \param userdata A pointer passed to the callback as-is.
@@ -250,7 +250,7 @@ extern DECLSPEC SDL_AssertionHandler SDLCALL SDL_GetAssertionHandler(void **puse
  *  <code>
  *  const SDL_AssertData *item = SDL_GetAssertionReport();
  *  while (item) {
- *      printf("'%s', %s (%s:%d), triggered %u times, always ignore: %s.\n",
+ *      printf("'%s', %s (%s:%d), triggered %u times, always ignore: %s.\\n",
  *             item->condition, item->function, item->filename,
  *             item->linenum, item->trigger_count,
  *             item->always_ignore ? "yes" : "no");
diff --git a/include/SDL_gamecontroller.h b/include/SDL_gamecontroller.h
index a872628280d8a..3bf13c1e1a9fb 100644
--- a/include/SDL_gamecontroller.h
+++ b/include/SDL_gamecontroller.h
@@ -51,7 +51,9 @@ extern "C" {
  *  SDL_Init(): SDL_HINT_JOYSTICK_ALLOW_BACKGROUND_EVENTS
  */
 
-/* The gamecontroller structure used to identify an SDL game controller */
+/**
+ * The gamecontroller structure used to identify an SDL game controller
+ */
 struct _SDL_GameController;
 typedef struct _SDL_GameController SDL_GameController;
 
diff --git a/include/SDL_hints.h b/include/SDL_hints.h
index 177b18d7bf2fe..6f4f58cecab83 100644
--- a/include/SDL_hints.h
+++ b/include/SDL_hints.h
@@ -780,6 +780,11 @@ extern DECLSPEC const char * SDLCALL SDL_GetHint(const char *name);
  */
 extern DECLSPEC SDL_bool SDLCALL SDL_GetHintBoolean(const char *name, SDL_bool default_value);
 
+/**
+ * \brief type definition of the hint callback function.
+ */
+typedef void (*SDL_HintCallback)(void *userdata, const char *name, const char *oldValue, const char *newValue);
+
 /**
  *  \brief Add a function to watch a particular hint
  *
@@ -787,7 +792,6 @@ extern DECLSPEC SDL_bool SDLCALL SDL_GetHintBoolean(const char *name, SDL_bool d
  *  \param callback The function to call when the hint value changes
  *  \param userdata A pointer to pass to the callback function
  */
-typedef void (*SDL_HintCallback)(void *userdata, const char *name, const char *oldValue, const char *newValue);
 extern DECLSPEC void SDLCALL SDL_AddHintCallback(const char *name,
                                                  SDL_HintCallback callback,
                                                  void *userdata);
diff --git a/include/SDL_joystick.h b/include/SDL_joystick.h
index 6bc40403bdb17..b466dc28a4f41 100644
--- a/include/SDL_joystick.h
+++ b/include/SDL_joystick.h
@@ -60,7 +60,9 @@ extern "C" {
  *  SDL_Init(): SDL_HINT_JOYSTICK_ALLOW_BACKGROUND_EVENTS
  */
 
-/* The joystick structure used to identify an SDL joystick */
+/**
+ * The joystick structure used to identify an SDL joystick
+ */
 struct _SDL_Joystick;
 typedef struct _SDL_Joystick SDL_Joystick;