[Rhythmbox-devel] [PATCH] review of plugin names and descriptions

[Luca Ferretti <elle uca libero it>]

IMHO some plugin names and or descriptions should be changed to provide
more useful information to user and/or to avoid other issues.

Example 1: audiocd and cd-recorder plugin

        Current names are "Audio CD" and "CD Recorder". The name for
        audiocd plugin don't explain that enabling this plugin you will
        have the ability to play (and only play) audio cds. The name for
        cd-recorder plugin, instead, don't explain you will have support
        for audio cd.

        So I suggest to change names to "Audio CD Player" and "Audio CD
        Recorder"

Example 2: iradio plugin

        Current name is iRadio. But "iRadio" is a (trademarked?) service
        by motorola[1]. Moreover the description is too short. Proposal
        (from [2]) is using "Internet Radio" as name and "Support for
        broadcasting services transmitted via the Internet" as
        description (maybe add "worldwide"?)

I prepared and attached a patch, changing in a similar way other names
and or description. 

I just have some doubt about ipod and generic-player plugins: to keep
those well sorted in plugin list I placed a dash in ipod source, so the
list should be

        .....
        Portable Players
        Portable Players - iPod
        ....
        
Should I change the second one to "iPod Players" forgetting the sort
order in plugin list?

----------------------------------

[1] http://en.wikipedia.org/wiki/IRadio
[2] http://en.wikipedia.org/wiki/Internet_radio
        

Index: plugins/artdisplay/artdisplay.rb-plugin.desktop.in
===================================================================
RCS file: /cvs/gnome/rhythmbox/plugins/artdisplay/artdisplay.rb-plugin.desktop.in,v
retrieving revision 1.1
diff -n -u -r1.1 artdisplay.rb-plugin.desktop.in
--- plugins/artdisplay/artdisplay.rb-plugin.desktop.in	20 Apr 2006 17:25:18 -0000	1.1
+++ plugins/artdisplay/artdisplay.rb-plugin.desktop.in	8 Oct 2006 12:58:06 -0000
@@ -2,8 +2,8 @@
 Loader=python
 Module=artdisplay
 IAge=1
-_Name=Art Display
-_Description=Displays art for the playing track
+_Name=Cover art
+_Description=Fetch album covers from Internet and display while playing
 Authors=James Livingston <jrl ids org au>
 Copyright=Copyright � 2006 james Livingston
 Website=http://www.rhythmbox.org
Index: plugins/audiocd/audiocd.rb-plugin.desktop.in
===================================================================
RCS file: /cvs/gnome/rhythmbox/plugins/audiocd/audiocd.rb-plugin.desktop.in,v
retrieving revision 1.1
diff -n -u -r1.1 audiocd.rb-plugin.desktop.in
--- plugins/audiocd/audiocd.rb-plugin.desktop.in	2 Sep 2006 13:41:15 -0000	1.1
+++ plugins/audiocd/audiocd.rb-plugin.desktop.in	8 Oct 2006 12:58:06 -0000
@@ -1,8 +1,8 @@
 [RB Plugin]
 Module=audiocd
 IAge=1
-_Name=Audio CD
-_Description=Support for audio CDs
+_Name=Audio CD Player
+_Description=Support for playing of audio CDs as music source
 Authors=James Livingston, Jonathan Matthew
 Copyright=Copyright � 2005-2006 James Livingston, Jonathan Matthew
 Website=http://www.rhythmbox.org/
Index: plugins/cd-recorder/cd-recorder.rb-plugin.desktop.in
===================================================================
RCS file: /cvs/gnome/rhythmbox/plugins/cd-recorder/cd-recorder.rb-plugin.desktop.in,v
retrieving revision 1.1
diff -n -u -r1.1 cd-recorder.rb-plugin.desktop.in
--- plugins/cd-recorder/cd-recorder.rb-plugin.desktop.in	10 Jul 2006 02:00:34 -0000	1.1
+++ plugins/cd-recorder/cd-recorder.rb-plugin.desktop.in	8 Oct 2006 12:58:06 -0000
@@ -1,7 +1,7 @@
 [RB Plugin]
 Module=cd-recorder
 IAge=1
-_Name=CD Recorder
+_Name=Audio CD Recorder
 _Description=Support for recording audio CDs from playlists
 Authors=William Jon McCann
 Copyright=Copyright � 2006 William Jon McCann
Index: plugins/generic-player/generic-player.rb-plugin.desktop.in
===================================================================
RCS file: /cvs/gnome/rhythmbox/plugins/generic-player/generic-player.rb-plugin.desktop.in,v
retrieving revision 1.1
diff -n -u -r1.1 generic-player.rb-plugin.desktop.in
--- plugins/generic-player/generic-player.rb-plugin.desktop.in	25 May 2006 07:20:47 -0000	1.1
+++ plugins/generic-player/generic-player.rb-plugin.desktop.in	8 Oct 2006 12:58:06 -0000
@@ -1,8 +1,8 @@
 [RB Plugin]
 Module=generic-player
 IAge=1
-_Name=Generic Audio Player
-_Description=Support for generic audio player devices (and PSP and Nokia 770)
+_Name=Portable Players
+_Description=Support for generic audio player devices (plus PSP and Nokia 770)
 Authors=James Livingston, Jonathan Matthew
 Copyright=Copyright � 2005-2006 James Livingston, Jonathan Matthew
 Website=http://www.rhythmbox.org
Index: plugins/ipod/ipod.rb-plugin.desktop.in
===================================================================
RCS file: /cvs/gnome/rhythmbox/plugins/ipod/ipod.rb-plugin.desktop.in,v
retrieving revision 1.1
diff -n -u -r1.1 ipod.rb-plugin.desktop.in
--- plugins/ipod/ipod.rb-plugin.desktop.in	17 Apr 2006 14:35:25 -0000	1.1
+++ plugins/ipod/ipod.rb-plugin.desktop.in	8 Oct 2006 12:58:06 -0000
@@ -1,8 +1,8 @@
 [RB Plugin]
 Module=ipod
 IAge=1
-_Name=iPod support
-_Description=Adds iPod support to Rhythmbox so that it can show an iPod content, and play from there
+_Name=Portable Players - iPod
+_Description=Support for Apple iPod devices (show the content, play from device)
 Authors=James Livingston, Christophe Fergeau
 Copyright=(C) 2006 James Livingston
 Website=http://www.rhythmbox.org
Index: plugins/iradio/iradio.rb-plugin.desktop.in
===================================================================
RCS file: /cvs/gnome/rhythmbox/plugins/iradio/iradio.rb-plugin.desktop.in,v
retrieving revision 1.1
diff -n -u -r1.1 iradio.rb-plugin.desktop.in
--- plugins/iradio/iradio.rb-plugin.desktop.in	2 Oct 2006 11:55:01 -0000	1.1
+++ plugins/iradio/iradio.rb-plugin.desktop.in	8 Oct 2006 12:58:06 -0000
@@ -1,8 +1,8 @@
 [RB Plugin]
 Module=iradio
 IAge=1
-_Name=iRadio
-_Description=Internet radio streaming
+_Name=Internet Radio
+_Description=Support for broadcasting services transmitted via the Internet
 Authors=Rhythmbox authors
 Copyright=Copyright � 2002-2006 Rhythmbox authors
 Website=http://www.rhythmbox.org
Index: plugins/lyrics/lyrics.rb-plugin.desktop.in
===================================================================
RCS file: /cvs/gnome/rhythmbox/plugins/lyrics/lyrics.rb-plugin.desktop.in,v
retrieving revision 1.1
diff -n -u -r1.1 lyrics.rb-plugin.desktop.in
--- plugins/lyrics/lyrics.rb-plugin.desktop.in	17 May 2006 03:52:56 -0000	1.1
+++ plugins/lyrics/lyrics.rb-plugin.desktop.in	8 Oct 2006 12:58:06 -0000
@@ -2,8 +2,8 @@
 Loader=python
 Module=lyrics
 IAge=1
-_Name=Lyrics
-_Description=Displays song lyrics
+_Name=Song Lyrics
+_Description=Fetch song lyrics from Internet and display
 Authors=Jonathan Matthew, Eduardo Gonzalez
 Copyright=Copyright � 2005, 2006 Jonathan Matthew, Eduardo Gonzalez
 Website=http://www.rhythmbox.org
Index: plugins/sample/sample.rb-plugin.desktop.in
===================================================================
RCS file: /cvs/gnome/rhythmbox/plugins/sample/sample.rb-plugin.desktop.in,v
retrieving revision 1.2
diff -n -u -r1.2 sample.rb-plugin.desktop.in
--- plugins/sample/sample.rb-plugin.desktop.in	2 May 2006 22:43:34 -0000	1.2
+++ plugins/sample/sample.rb-plugin.desktop.in	8 Oct 2006 12:58:06 -0000
@@ -2,7 +2,7 @@
 Module=sample
 IAge=1
 _Name=Sample Plugin
-_Description=Does a whole lot of not much
+_Description=A sample plugin in C with no features
 Authors=Paolo Maggi <paolo gnome org>
 Copyright=Copyright � 2002-2005 Paolo Maggi
 Website=http://www.rhythmbox.org
Index: plugins/sample-python/sample-python.rb-plugin.desktop.in
===================================================================
RCS file: /cvs/gnome/rhythmbox/plugins/sample-python/sample-python.rb-plugin.desktop.in,v
retrieving revision 1.1
diff -n -u -r1.1 sample-python.rb-plugin.desktop.in
--- plugins/sample-python/sample-python.rb-plugin.desktop.in	11 Mar 2006 05:24:56 -0000	1.1
+++ plugins/sample-python/sample-python.rb-plugin.desktop.in	8 Oct 2006 12:58:06 -0000
@@ -2,8 +2,8 @@
 Loader=python
 Module=sample-python
 IAge=1
-_Name=Python Sample
-_Description= doesn't do much
+_Name=Python Sample Plugin
+_Description=A sample plugin in Python with no features
 Authors=James Livingston <jrl ids org au>
 Copyright=Copyright � 2006 james Livingston
 Website=http://www.rhythmbox.org