[retro-gtk/wip/aplazas/c-port] Fixes

[Adrien Plazas <aplazas src gnome org>]

commit b4be280a7d2cba6de5c7f18a9af2dafda21f584b
Author: Adrien Plazas <kekun plazas laposte net>
Date:   Tue Oct 10 08:26:00 2017 +0200

    Fixes

 retro-gtk/retro-core.c |   49 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 files changed, 49 insertions(+), 0 deletions(-)
---
diff --git a/retro-gtk/retro-core.c b/retro-gtk/retro-core.c
index 1c72165..21650bf 100644
--- a/retro-gtk/retro-core.c
+++ b/retro-gtk/retro-core.c
@@ -1064,6 +1064,7 @@ on_key_event (GtkWidget   *widget,
 
 /* Public */
 
+// FIXME documentation
 guint retro_core_get_api_version (RetroCore *self) {
   guint result;
   RetroApiVersion api_version;
@@ -1078,6 +1079,7 @@ guint retro_core_get_api_version (RetroCore *self) {
   return result;
 }
 
+// FIXME documentation
 const gchar *
 retro_core_get_filename (RetroCore *self)
 {
@@ -1086,6 +1088,7 @@ retro_core_get_filename (RetroCore *self)
   return self->filename;
 }
 
+// FIXME documentation
 const gchar *
 retro_core_get_system_directory (RetroCore *self)
 {
@@ -1094,6 +1097,7 @@ retro_core_get_system_directory (RetroCore *self)
   return self->system_directory;
 }
 
+// FIXME documentation
 void retro_core_set_system_directory (RetroCore *self, const gchar* value) {
   g_return_if_fail (RETRO_IS_CORE (self));
 
@@ -1105,6 +1109,7 @@ void retro_core_set_system_directory (RetroCore *self, const gchar* value) {
   g_object_notify_by_pspec (G_OBJECT (self), properties[PROP_SYSTEM_DIRECTORY]);
 }
 
+// FIXME documentation
 const gchar *
 retro_core_get_libretro_path (RetroCore *self)
 {
@@ -1113,6 +1118,7 @@ retro_core_get_libretro_path (RetroCore *self)
   return self->libretro_path;
 }
 
+// FIXME documentation
 void
 retro_core_set_libretro_path (RetroCore   *self,
                               const gchar *value)
@@ -1127,6 +1133,7 @@ retro_core_set_libretro_path (RetroCore   *self,
   g_object_notify_by_pspec (G_OBJECT (self), properties[PROP_LIBRETRO_PATH]);
 }
 
+// FIXME documentation
 const gchar *
 retro_core_get_content_directory (RetroCore *self)
 {
@@ -1135,6 +1142,7 @@ retro_core_get_content_directory (RetroCore *self)
   return self->content_directory;
 }
 
+// FIXME documentation
 void
 retro_core_set_content_directory (RetroCore   *self,
                                   const gchar *value)
@@ -1149,6 +1157,7 @@ retro_core_set_content_directory (RetroCore   *self,
   g_object_notify_by_pspec (G_OBJECT (self), properties[PROP_CONTENT_DIRECTORY]);
 }
 
+// FIXME documentation
 const gchar *
 retro_core_get_save_directory (RetroCore *self)
 {
@@ -1157,6 +1166,7 @@ retro_core_get_save_directory (RetroCore *self)
   return self->save_directory;
 }
 
+// FIXME documentation
 void
 retro_core_set_save_directory (RetroCore   *self,
                                const gchar *value)
@@ -1171,6 +1181,7 @@ retro_core_set_save_directory (RetroCore   *self,
   g_object_notify_by_pspec (G_OBJECT (self), properties[PROP_SAVE_DIRECTORY]);
 }
 
+// FIXME documentation
 gboolean
 retro_core_get_is_initiated (RetroCore *self)
 {
@@ -1187,6 +1198,7 @@ retro_core_get_game_loaded (RetroCore *self)
   return self->game_loaded;
 }
 
+// FIXME documentation
 gboolean
 retro_core_get_support_no_game (RetroCore *self)
 {
@@ -1195,6 +1207,7 @@ retro_core_get_support_no_game (RetroCore *self)
   return self->support_no_game;
 }
 
+// FIXME documentation
 void
 retro_core_set_support_no_game (RetroCore *self,
                                 gboolean   value)
@@ -1208,6 +1221,7 @@ retro_core_set_support_no_game (RetroCore *self,
   g_object_notify_by_pspec (G_OBJECT (self), properties[PROP_SUPPORT_NO_GAME]);
 }
 
+// FIXME documentation
 gdouble
 retro_core_get_frames_per_second (RetroCore *self)
 {
@@ -1263,6 +1277,16 @@ retro_core_boot (RetroCore  *self,
   }
 }
 
+/**
+ * retro_core_set_medias:
+ * @self: a #RetroCore
+ * @uris: (array zero-terminated=1 length=length) (element-type utf8)
+ * (transfer none): the URIs
+ *
+ * Sets the medias to load into the core.
+ *
+ * You can use this before booting the core.
+ */
 void
 retro_core_set_medias (RetroCore    *self,
                        const gchar **uris)
@@ -1277,6 +1301,16 @@ retro_core_set_medias (RetroCore    *self,
   self->media_uris = g_strdupv ((gchar **) uris);
 }
 
+/**
+ * retro_core_set_current_media:
+ * @self: a #RetroCore
+ * @media_index: the media index
+ * @error: return location for a #GError, or %NULL
+ *
+ * Sets the current media index.
+ *
+ * You can use this after booting the core.
+ */
 void
 retro_core_set_current_media (RetroCore  *self,
                               guint       media_index,
@@ -1315,6 +1349,7 @@ retro_core_set_current_media (RetroCore  *self,
   }
 }
 
+// FIXME Merge this into retro_core_set_controller().
 void
 retro_core_set_controller_port_device (RetroCore       *self,
                                        guint            port,
@@ -1330,6 +1365,12 @@ retro_core_set_controller_port_device (RetroCore       *self,
   retro_core_pop_cb_data ();
 }
 
+/**
+ * retro_core_reset:
+ * @self: a #RetroCore
+ *
+ * Resets @self.
+ */
 void
 retro_core_reset (RetroCore *self)
 {
@@ -1343,6 +1384,12 @@ retro_core_reset (RetroCore *self)
   retro_core_pop_cb_data ();
 }
 
+/**
+ * retro_core_run:
+ * @self: a #RetroCore
+ *
+ * Iterate @self for a frame.
+ */
 void
 retro_core_run (RetroCore *self)
 {
@@ -1679,6 +1726,7 @@ retro_core_get_controller_input_state (RetroCore       *self,
                                              id);
 }
 
+// FIXME documentation
 void
 retro_core_set_controller_descriptors (RetroCore            *self,
                                        RetroInputDescriptor *input_descriptors,
@@ -1689,6 +1737,7 @@ retro_core_set_controller_descriptors (RetroCore            *self,
   // TODO
 }
 
+// FIXME documentation
 guint64
 retro_core_get_controller_capabilities (RetroCore *self)
 {