[Xfce4-commits] <parole:master> Plugin API updates, fix playlist search

Sean Davis noreply at xfce.org
Thu Dec 19 03:16:01 CET 2013


Updating branch refs/heads/master
         to 09df777859122dda720f61512d27739b70fb4d09 (commit)
       from 17127defa0f564a3bf506292858ef9bed435f187 (commit)

commit 09df777859122dda720f61512d27739b70fb4d09
Author: Sean Davis <smd.seandavis at gmail.com>
Date:   Wed Dec 18 21:15:29 2013 -0500

    Plugin API updates, fix playlist search

 ChangeLog                                        |    2 +
 docs/plugin-api/Makefile.am                      |    5 +
 docs/plugin-api/Parole-Plugins-docs.sgml         |   30 +++
 docs/plugin-api/Parole-Plugins-sections.txt      |   22 ++-
 docs/plugin-api/tmpl/Parole-Plugins-unused.sgml  |  223 +---------------------
 docs/plugin-api/tmpl/parole-file.sgml            |   59 +++++-
 docs/plugin-api/tmpl/parole-provider-player.sgml |   74 +++++++
 docs/plugin-api/tmpl/parole-provider-plugin.sgml |   10 -
 docs/plugin-api/tmpl/parole-stream.sgml          |    7 -
 docs/plugin-api/tmpl/parole.sgml                 |   18 ++
 src/misc/parole-file.c                           |    6 +-
 src/misc/parole-pl-parser.c                      |    4 +-
 src/misc/parole-provider-player.c                |   12 +-
 src/misc/parole-stream.c                         |   10 +
 src/parole-medialist.c                           |    4 +
 15 files changed, 240 insertions(+), 246 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 182954c..8e5734d 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -5,6 +5,8 @@
     * Fix IF/ELSE for plugin installation on multiple platforms (bugs #10142, #10441)
     * Fix building with enable-debug=full on some platforms (bug #10525)
     * Fix "Remove Duplicates" functionality.
+    * Plugin API documentation updates
+    * Fixed playlist search
 
 2013-10-19: bluesabre at xfce.org
     * Development release 0.5.90
diff --git a/docs/plugin-api/Makefile.am b/docs/plugin-api/Makefile.am
index e7b022b..731b054 100644
--- a/docs/plugin-api/Makefile.am
+++ b/docs/plugin-api/Makefile.am
@@ -79,6 +79,11 @@ GTKDOC_LIBS=                    \
 
 if ENABLE_GTK_DOC
 include $(top_srcdir)/gtk-doc.make
+doccheck: $(GTKDOC_CHECK)
+	$(AM_V_GEN)ln -s $< $@
+
+MOSTLYCLEANFILES = doccheck
+TESTS = doccheck
 else
 EXTRA_DIST=
 endif
diff --git a/docs/plugin-api/Parole-Plugins-docs.sgml b/docs/plugin-api/Parole-Plugins-docs.sgml
index 3462610..27a4fc9 100644
--- a/docs/plugin-api/Parole-Plugins-docs.sgml
+++ b/docs/plugin-api/Parole-Plugins-docs.sgml
@@ -76,5 +76,35 @@
     <title>API Index</title>
     <xi:include href="xml/api-index-full.xml"><xi:fallback /></xi:include>
   </index>
+  
+  <index id="api-index-0.2">
+    <title>API Index - 0.2</title>
+    <xi:include href="xml/api-index-0.2.xml"><xi:fallback /></xi:include>
+  </index>
+  
+  <index id="api-index-0.4">
+    <title>API Index - 0.4</title>
+    <xi:include href="xml/api-index-0.4.xml"><xi:fallback /></xi:include>
+  </index>
+  
+  <index id="api-index-0.6">
+    <title>API Index - 0.6</title>
+    <xi:include href="xml/api-index-0.6.xml"><xi:fallback /></xi:include>
+  </index>
+  
+  <index id="api-index-deprecated">
+    <title>API Index - Deprecated Symbols</title>
+    <xi:include href="xml/api-index-deprecated.xml"><xi:fallback /></xi:include>
+  </index>
+  
+  <index id="parole-enum-types">
+    <title>Parole Enum Types</title>
+    <xi:include href="xml/parole-enum-types.xml"><xi:fallback /></xi:include>
+  </index>
+  
+  <index id="parole-marshal">
+    <title>Parole Marshal</title>
+    <xi:include href="xml/parole-marshal.xml"><xi:fallback /></xi:include>
+  </index>
 
 </book>
diff --git a/docs/plugin-api/Parole-Plugins-sections.txt b/docs/plugin-api/Parole-Plugins-sections.txt
index 7ff537a..9f4ee8e 100644
--- a/docs/plugin-api/Parole-Plugins-sections.txt
+++ b/docs/plugin-api/Parole-Plugins-sections.txt
@@ -6,12 +6,20 @@ ParolePluginContainer
 ParoleState
 parole_provider_player_get_main_window
 parole_provider_player_pack
+parole_provider_player_get_action
+parole_provider_player_set_fullscreen
+parole_provider_player_get_fullscreen
+parole_stream_set_image
+parole_stream_get_image
 parole_provider_player_get_state
 parole_provider_player_get_stream
+parole_provider_player_get_stream_position
 parole_provider_player_play_uri
 parole_provider_player_pause
 parole_provider_player_resume
 parole_provider_player_stop
+parole_provider_player_play_next
+parole_provider_player_play_previous
 parole_provider_player_seek
 parole_provider_player_open_media_chooser
 <SUBSECTION Standard>
@@ -24,12 +32,12 @@ parole_provider_player_get_type
 
 <SECTION>
 <FILE>parole-provider-plugin</FILE>
-ParoleProviderPluginIface
 ParoleProviderPlugin
 parole_provider_plugin_get_is_configurable
 parole_provider_plugin_configure
 parole_provider_plugin_set_player
 <SUBSECTION Standard>
+ParoleProviderPluginIface
 PAROLE_PROVIDER_PLUGIN
 PAROLE_IS_PROVIDER_PLUGIN
 PAROLE_TYPE_PROVIDER_PLUGIN
@@ -41,15 +49,21 @@ parole_provider_plugin_get_type
 <FILE>parole-file</FILE>
 <TITLE>ParoleFile</TITLE>
 ParoleFile
-ParoleFileClass
 parole_file_new
 parole_file_new_with_display_name
+parole_file_new_cdda_track
+parole_file_new_dvd_chapter
 parole_file_get_file_name
 parole_file_get_display_name
 parole_file_get_uri
 parole_file_get_directory
 parole_file_get_content_type
+parole_file_set_dvd_chapter
+parole_file_get_dvd_chapter
+parole_file_set_custom_subtitles
+parole_file_get_custom_subtitles
 <SUBSECTION Standard>
+ParoleFileClass
 PAROLE_FILE
 PAROLE_IS_FILE
 PAROLE_TYPE_FILE
@@ -61,8 +75,8 @@ parole_file_get_type
 ParoleMediaType
 <TITLE>ParoleStream</TITLE>
 ParoleStream
-ParoleStreamClass
 <SUBSECTION Standard>
+ParoleStreamClass
 PAROLE_STREAM
 PAROLE_IS_STREAM
 PAROLE_TYPE_STREAM
@@ -110,6 +124,8 @@ PAROLE_DEFINE_TYPE_WITH_CODE
 PAROLE_DEFINE_ABSTRACT_TYPE
 PAROLE_DEFINE_ABSTRACT_TYPE_WITH_CODE
 PAROLE_IMPLEMENT_INTERFACE
+parole_get_supported_recent_files_filter
+parole_get_supported_recent_media_filter
 </SECTION>
 
 <SECTION>
diff --git a/docs/plugin-api/tmpl/Parole-Plugins-unused.sgml b/docs/plugin-api/tmpl/Parole-Plugins-unused.sgml
index 66c12b5..e3e2ae6 100644
--- a/docs/plugin-api/tmpl/Parole-Plugins-unused.sgml
+++ b/docs/plugin-api/tmpl/Parole-Plugins-unused.sgml
@@ -1,229 +1,24 @@
-<!-- ##### SECTION ./tmpl/parole-plugins.sgml:Long_Description ##### -->
+<!-- ##### STRUCT ParoleFileClass ##### -->
 <para>
 
 </para>
 
+ at parent_class: 
 
-<!-- ##### SECTION ./tmpl/parole-plugins.sgml:See_Also ##### -->
+<!-- ##### STRUCT ParoleProviderPluginIface ##### -->
 <para>
 
 </para>
 
+ at __parent__: 
+ at get_is_configurable: 
+ at configure: 
+ at set_player: 
 
-<!-- ##### SECTION ./tmpl/parole-plugins.sgml:Short_Description ##### -->
-
-
-
-<!-- ##### SECTION ./tmpl/parole-plugins.sgml:Stability_Level ##### -->
-
-
-
-<!-- ##### SECTION ./tmpl/parole-plugins.sgml:Title ##### -->
-Parole Plugin Tutorial
-
-    <para>
-	This section explains the steps required to write a plugin for Parole using
-	the C language interface.
-    </para>
-    
-    <para>
-	A simple example can be found in the parole plugins dir shipped with the source code, the sample
-	plugin.
-    </para>
-    <para>
-	As a basics, the plugin needs to implement <link linkend="ParoleProviderPlugin"><type>ParoleProviderPlugin</type></link>
-	interface, That is, the player use this interface to get if the plugin is configurable, to ask it to show
-	its properties dialog when needed, to set the <link linkend="ParoleProviderPlayer"><type>ParoleProviderPlayer</type></link>
-	interface used by plugins to access the the Parole player backend.
-    </para>
-    
-  <sect1 id="parole-plugin-strcuted">
-    <title>Plugin structure.</title>
-    sample-plugin.c
-    <programlisting>
- 
-#include "sample-provider.h"
-    
-/* Avoid a no previous function declaration compiler warning*/
-G_MODULE_EXPORT GType	parole_plugin_initialize (ParoleProviderPlugin *plugin);
-G_MODULE_EXPORT void	parole_plugin_shutdown   (void);
-
-G_MODULE_EXPORT GType
-parole_plugin_initialize (ParoleProviderPlugin *plugin)
-{
-    xfce_textdomain (GETTEXT_PACKAGE, PACKAGE_LOCALE_DIR, "UTF-8");
-    sample_provider_register_type (plugin);
-    return SAMPLE_TYPE_PROVIDER;
-}
-
-G_MODULE_EXPORT void
-parole_plugin_shutdown (void)
-{
-    
-}
-    </programlisting>
-    
-    sample-provider.h
-    <programlisting>
-#ifndef SAMPLE_PROVIDER_H_
-#define SAMPLE_PROVIDER_H_
-
-#include <src/misc/parole.h>
-
-G_BEGIN_DECLS
-
-typedef struct _SampleProviderClass SampleProviderClass;
-typedef struct _SampleProvider      SampleProvider;
-
-#define SAMPLE_TYPE_PROVIDER             (sample_provider_get_type ())
-#define SAMPLE_PROVIDER(obj)             (G_TYPE_CHECK_INSTANCE_CAST ((obj), SAMPLE_TYPE_PROVIDER, SampleProvider))
-#define SAMPLE_PROVIDER_CLASS(klass)     (G_TYPE_CHECK_CLASS_CAST ((klass), SAMPLE_TYPE_PROVIDER, SampleProviderClass))
-#define SAMPLE_IS_PROVIDER(obj)          (G_TYPE_CHECK_INSTANCE_TYPE ((obj), SAMPLE_TYPE_PROVIDER))
-#define SAMPLE_IS_PROVIDER_CLASS(klass)  (G_TYPE_CHECK_CLASS_TYPE ((klass), SAMPLE_TYPE_PROVIDER))
-#define SAMPLE_PROVIDER_GET_CLASS(obj)   (G_TYPE_INSTANCE_GET_CLASS ((obj), SAMPLE_TYPE_PROVIDER, SampleProviderClass))
-
-GType sample_provider_get_type      	(void) G_GNUC_CONST G_GNUC_INTERNAL;
-
-void  sample_provider_register_type	(ParoleProviderPlugin *plugin);
-
-G_END_DECLS
-    </programlisting>
-    
-    sample-provider.c
-    <programlisting>
-
-#include "sample-provider.h"
-
-static void   sample_provider_iface_init 	   (ParoleProviderPluginIface *iface);
-static void   sample_provider_finalize             (GObject 	              *object);
-
-
-struct _SampleProviderClass
-{
-    GObjectClass parent_class;
-};
-
-struct _SampleProvider
-{
-    GObject      parent;
-    ParoleProviderPlayer *player;
-};
-
-PAROLE_DEFINE_TYPE_WITH_CODE (SampleProvider, 
-			      sample_provider, 
-			      G_TYPE_OBJECT,
-			      PAROLE_IMPLEMENT_INTERFACE (PAROLE_TYPE_PROVIDER_PLUGIN, 
-							  sample_provider_iface_init));
-		
-static void  sample_provider_configure (ParoleProviderPlugin *provider, GtkWidget *parent)
-{
-    /*Open the configuration dialog, parent is the window transient for*/
-}
-
-static gboolean sample_provider_is_configurable (ParoleProviderPlugin *plugin)
-{
-    return TRUE; /*Returns FALSE and don't override the iface->configure function*/
-}
-
-static void
-sample_provider_set_player (ParoleProviderPlugin *plugin, ParoleProviderPlayer *player)
-{
-    SampleProvider *provider;
-    provider = SAMPLE_PROVIDER (plugin);
-    
-    provider->player = player;
-}
-
-static void
-sample_provider_iface_init (ParoleProviderPluginIface *iface)
-{
-    iface->get_is_configurable = sample_provider_is_configurable;
-    iface->configure = sample_provider_configure;
-    iface->set_player = sample_provider_set_player;
-}
-
-static void sample_provider_class_init (SampleProviderClass *klass)
-{
-    GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
-    
-    gobject_class->finalize = sample_provider_finalize;
-}
-
-static void sample_provider_init (SampleProvider *provider)
-{
-    provider->player = NULL;
-}
-
-static void sample_provider_finalize (GObject *object)
-{
-    G_OBJECT_CLASS (sample_provider_parent_class)->finalize (object);
-}    
-    </programlisting>
-    
-  </sect1>
-    
-  </part>
-
-
-<!-- ##### MACRO PAROLE_PROVIDER_PLAYER_GET_INTERFACE ##### -->
-<para>
-
-</para>
-
- at o: 
-
-<!-- ##### MACRO PAROLE_PROVIDER_PLUGIN_GET_INTERFACE ##### -->
-<para>
-
-</para>
-
- at o: 
-
-<!-- ##### ENUM ParoleFileFormat ##### -->
-<para>
-
-</para>
-
- at PAROLE_FILE_UNKNOWN: 
- at PAROLE_FILE_AUDIO: 
- at PAROLE_FILE_VIDEO: 
- at PAROLE_FILE_PLAYLIST: 
-
-<!-- ##### FUNCTION parole_file_guess_format ##### -->
-<para>
-
-</para>
-
- at file: 
- at Returns: 
-
-<!-- ##### FUNCTION parole_provider_player_get_main_window ##### -->
-<para>
-
-</para>
-
- at player: 
- at Returns: 
-
-<!-- ##### FUNCTION parole_provider_player_get_stream ##### -->
-<para>
-
-</para>
-
- at player: 
- at Returns: 
-
-<!-- ##### FUNCTION parole_stream_init_properties ##### -->
-<para>
-
-</para>
-
- at stream: 
-
-<!-- ##### FUNCTION parole_stream_new ##### -->
+<!-- ##### STRUCT ParoleStreamClass ##### -->
 <para>
 
 </para>
 
- at Returns: 
+ at parent_class: 
 
diff --git a/docs/plugin-api/tmpl/parole-file.sgml b/docs/plugin-api/tmpl/parole-file.sgml
index 5af9aaa..ff19deb 100644
--- a/docs/plugin-api/tmpl/parole-file.sgml
+++ b/docs/plugin-api/tmpl/parole-file.sgml
@@ -61,28 +61,41 @@ Simple file handling.
 
 </para>
 
-<!-- ##### STRUCT ParoleFileClass ##### -->
+<!-- ##### FUNCTION parole_file_new ##### -->
 <para>
 
 </para>
 
- at parent_class: 
+ at filename: 
+ at Returns: 
+
 
-<!-- ##### FUNCTION parole_file_new ##### -->
+<!-- ##### FUNCTION parole_file_new_with_display_name ##### -->
 <para>
 
 </para>
 
 @filename: 
+ at display_name: 
 @Returns: 
 
 
-<!-- ##### FUNCTION parole_file_new_with_display_name ##### -->
+<!-- ##### FUNCTION parole_file_new_cdda_track ##### -->
 <para>
 
 </para>
 
- at filename: 
+ at track_num: 
+ at display_name: 
+ at Returns: 
+
+
+<!-- ##### FUNCTION parole_file_new_dvd_chapter ##### -->
+<para>
+
+</para>
+
+ at chapter_num: 
 @display_name: 
 @Returns: 
 
@@ -132,3 +145,39 @@ Simple file handling.
 @Returns: 
 
 
+<!-- ##### FUNCTION parole_file_set_dvd_chapter ##### -->
+<para>
+
+</para>
+
+ at file: 
+ at dvd_chapter: 
+
+
+<!-- ##### FUNCTION parole_file_get_dvd_chapter ##### -->
+<para>
+
+</para>
+
+ at file: 
+ at Returns: 
+
+
+<!-- ##### FUNCTION parole_file_set_custom_subtitles ##### -->
+<para>
+
+</para>
+
+ at file: 
+ at suburi: 
+
+
+<!-- ##### FUNCTION parole_file_get_custom_subtitles ##### -->
+<para>
+
+</para>
+
+ at file: 
+ at Returns: 
+
+
diff --git a/docs/plugin-api/tmpl/parole-provider-player.sgml b/docs/plugin-api/tmpl/parole-provider-player.sgml
index 49a31cc..19365d8 100644
--- a/docs/plugin-api/tmpl/parole-provider-player.sgml
+++ b/docs/plugin-api/tmpl/parole-provider-player.sgml
@@ -89,6 +89,53 @@ playback status.
 @container: 
 
 
+<!-- ##### FUNCTION parole_provider_player_get_action ##### -->
+<para>
+
+</para>
+
+ at player: 
+ at action: 
+ at Returns: 
+
+
+<!-- ##### FUNCTION parole_provider_player_set_fullscreen ##### -->
+<para>
+
+</para>
+
+ at player: 
+ at fullscreen: 
+ at Returns: 
+
+
+<!-- ##### FUNCTION parole_provider_player_get_fullscreen ##### -->
+<para>
+
+</para>
+
+ at player: 
+ at Returns: 
+
+
+<!-- ##### FUNCTION parole_stream_set_image ##### -->
+<para>
+
+</para>
+
+ at object: 
+ at pixbuf: 
+
+
+<!-- ##### FUNCTION parole_stream_get_image ##### -->
+<para>
+
+</para>
+
+ at object: 
+ at Returns: 
+
+
 <!-- ##### FUNCTION parole_provider_player_get_state ##### -->
 <para>
 
@@ -98,6 +145,15 @@ playback status.
 @Returns: 
 
 
+<!-- ##### FUNCTION parole_provider_player_get_stream_position ##### -->
+<para>
+
+</para>
+
+ at player: 
+ at Returns: 
+
+
 <!-- ##### FUNCTION parole_provider_player_play_uri ##### -->
 <para>
 
@@ -135,6 +191,24 @@ playback status.
 @Returns: 
 
 
+<!-- ##### FUNCTION parole_provider_player_play_next ##### -->
+<para>
+
+</para>
+
+ at player: 
+ at Returns: 
+
+
+<!-- ##### FUNCTION parole_provider_player_play_previous ##### -->
+<para>
+
+</para>
+
+ at player: 
+ at Returns: 
+
+
 <!-- ##### FUNCTION parole_provider_player_seek ##### -->
 <para>
 
diff --git a/docs/plugin-api/tmpl/parole-provider-plugin.sgml b/docs/plugin-api/tmpl/parole-provider-plugin.sgml
index fa87556..bf86f4b 100644
--- a/docs/plugin-api/tmpl/parole-provider-plugin.sgml
+++ b/docs/plugin-api/tmpl/parole-provider-plugin.sgml
@@ -23,16 +23,6 @@ can use to get access to various functionalities of the player.
 <!-- ##### SECTION Image ##### -->
 
 
-<!-- ##### STRUCT ParoleProviderPluginIface ##### -->
-<para>
-
-</para>
-
- at __parent__: 
- at get_is_configurable: 
- at configure: 
- at set_player: 
-
 <!-- ##### STRUCT ParoleProviderPlugin ##### -->
 <para>
 
diff --git a/docs/plugin-api/tmpl/parole-stream.sgml b/docs/plugin-api/tmpl/parole-stream.sgml
index e8a862d..5c7ff60 100644
--- a/docs/plugin-api/tmpl/parole-stream.sgml
+++ b/docs/plugin-api/tmpl/parole-stream.sgml
@@ -163,10 +163,3 @@ signal of the player, the plugin shouldn't take reference and all the properties
 
 </para>
 
-<!-- ##### STRUCT ParoleStreamClass ##### -->
-<para>
-
-</para>
-
- at parent_class: 
-
diff --git a/docs/plugin-api/tmpl/parole.sgml b/docs/plugin-api/tmpl/parole.sgml
index 8e57ffa..7de4df5 100644
--- a/docs/plugin-api/tmpl/parole.sgml
+++ b/docs/plugin-api/tmpl/parole.sgml
@@ -114,3 +114,21 @@ Parole
 @iface_init: 
 
 
+<!-- ##### FUNCTION parole_get_supported_recent_files_filter ##### -->
+<para>
+
+</para>
+
+ at void: 
+ at Returns: 
+
+
+<!-- ##### FUNCTION parole_get_supported_recent_media_filter ##### -->
+<para>
+
+</para>
+
+ at void: 
+ at Returns: 
+
+
diff --git a/src/misc/parole-file.c b/src/misc/parole-file.c
index f816416..2936e0b 100644
--- a/src/misc/parole-file.c
+++ b/src/misc/parole-file.c
@@ -459,7 +459,7 @@ parole_file_new_with_display_name (const gchar *filename, const gchar *display_n
 /**
  * parole_file_new_cdda_track:
  * @track_num: cd track number.
- * 
+ * @display_name: the track name to display.
  * 
  * 
  * Returns: A new #ParoleFile object.
@@ -483,8 +483,8 @@ parole_file_new_cdda_track (const gint track_num, const gchar *display_name)
 
 /**
  * parole_file_new_dvd_chapter:
- * @track_num: dvd chapter number.
- * 
+ * @chapter_num: dvd chapter number.
+ * @display_name: the chapter name to display.
  * 
  * 
  * Returns: A new #ParoleFile object.
diff --git a/src/misc/parole-pl-parser.c b/src/misc/parole-pl-parser.c
index 4054ff2..6a26735 100644
--- a/src/misc/parole-pl-parser.c
+++ b/src/misc/parole-pl-parser.c
@@ -775,7 +775,7 @@ gboolean parole_pl_parser_save_from_files (GSList *files, const gchar *filename,
  * @filename: a filename.
  * 
  * 
- * Returns: a #GSList containts a list of #Parolefile parsed from the playlist, 
+ * Returns: a #GSList containts a list of #ParoleFile parsed from the playlist, 
  *          or NULL if no files were parsed.
  * 
  * Since: 0.2
@@ -806,7 +806,7 @@ out:
  * This function tries to parse a playlist without guessing the playlist format.
  * 
  * 
- * Returns: a #GSList containts a list of #Parolefile parsed from the playlist, 
+ * Returns: a #GSList containts a list of #ParoleFile parsed from the playlist, 
  *          or NULL if no files were parsed.
  * 
  * Since: 0.2
diff --git a/src/misc/parole-provider-player.c b/src/misc/parole-provider-player.c
index d3c7c03..4667fb1 100644
--- a/src/misc/parole-provider-player.c
+++ b/src/misc/parole-provider-player.c
@@ -129,11 +129,12 @@ static void parole_provider_player_class_init (gpointer klass)
 
 /**
  * parole_provider_player_get_main_window:
- * @player: a #ParoleProviderPlayer 
+ * @player: a #ParoleProviderPlayer
  * 
  * Ask the Player to get the Parole main window.
  * 
- * Returns: #GtkWidget window.
+ * Returns: a #GtkWidget window.
+ * 
  * 
  * Since: 0.2
  **/
@@ -424,6 +425,8 @@ gboolean parole_provider_player_seek (ParoleProviderPlayer *player, gdouble pos)
  * @player: a #ParoleProviderPlayer
  * 
  * Get stream position (microseconds) for Parole.
+ *
+ * Returns: a #gdouble containing the current stream position in microseconds.
  * 
  * Since: 0.6
  **/
@@ -465,6 +468,9 @@ void parole_provider_player_open_media_chooser (ParoleProviderPlayer *player)
  * 
  * Get GtkAction from Parole.
  * 
+ * Returns: the requested #GtkAction.
+ * 
+ * 
  * Since: 0.6
  **/
 GtkAction *parole_provider_player_get_action(ParoleProviderPlayer *player, ParolePlayerAction action)
@@ -486,6 +492,8 @@ GtkAction *parole_provider_player_get_action(ParoleProviderPlayer *player, Parol
  * @player: a #ParoleProviderPlayer
  * 
  * Get fullscreen status for Parole.
+ *
+ * Returns: TRUE if the player window is fullscreen, FALSE otherwise.
  * 
  * Since: 0.6
  **/
diff --git a/src/misc/parole-stream.c b/src/misc/parole-stream.c
index 3db0b61..20c8f13 100644
--- a/src/misc/parole-stream.c
+++ b/src/misc/parole-stream.c
@@ -341,6 +341,16 @@ parole_stream_finalize (GObject *object)
     G_OBJECT_CLASS (parole_stream_parent_class)->finalize (object);
 }
 
+/**
+ * parole_stream_set_image:
+ * @object: a #ParoleStream object.
+ * @pixbuf: a #GdkPixbuf to set as the stream image.
+ * 
+ * Set the ParoleStream image to a new pixbuf.
+ * 
+ * 
+ * Since: 0.6
+ **/
 void 
 parole_stream_set_image (GObject *object, GdkPixbuf *pixbuf)
 {
diff --git a/src/parole-medialist.c b/src/parole-medialist.c
index 00f46f5..c197d7d 100644
--- a/src/parole-medialist.c
+++ b/src/parole-medialist.c
@@ -1574,6 +1574,10 @@ parole_media_list_setup_view (ParoleMediaList *list)
     g_object_set (disc_renderer, 
                   "ellipsize", PANGO_ELLIPSIZE_END, 
                   NULL);
+                  
+    /* Make the name column the search target */
+    gtk_tree_view_set_search_column(GTK_TREE_VIEW(list->priv->view), 1);
+    gtk_tree_view_set_search_column(GTK_TREE_VIEW(list->priv->disc_view), 1);
     
     /**
      * Media length


More information about the Xfce4-commits mailing list