After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 672044 - Man page for rhythmbox-client should be updated
Man page for rhythmbox-client should be updated
Status: RESOLVED FIXED
Product: rhythmbox
Classification: Other
Component: Documentation
2.95
Other Linux
: Normal normal
: ---
Assigned To: RhythmBox Maintainers
RhythmBox Maintainers
Depends on:
Blocks:
 
 
Reported: 2012-03-14 12:15 UTC by Vadim Rutkovsky
Modified: 2013-08-24 05:28 UTC
See Also:
GNOME target: ---
GNOME version: ---


Attachments
Removed options from rhythmbox-client man page (1.28 KB, patch)
2012-11-22 17:17 UTC, Sindhu S
none Details | Review
Removed invalid options in rhythmbox-client man page see bug 672044 (1.21 KB, patch)
2012-11-26 14:51 UTC, Sindhu S
none Details | Review

Description Vadim Rutkovsky 2012-03-14 12:15:23 UTC
Man page for rhythmbox-client lists several outdated options:
 - notify
 - stop
 - mute
 - unmute

And doesn't contain description for some options:
 - check-running
 - seek
 - set-rating
Comment 1 Jani Uusitalo 2012-04-10 15:34:39 UTC
Should the first list include --quit too, as that one also doesn't seem to work? It (2.96) doesn't print a warning though, either:

jani@saegusa:~$ rhythmbox-client --quit
jani@saegusa:~$ 
jani@saegusa:~$ rhythmbox-client --debug --quit
(18:28:03) [0xc97800] [rb_debug_init_match] rb-debug.c:240: Debugging enabled
(18:28:03) [0xc97800] [main] rb-client.c:707: quitting existing instance
jani@saegusa:~$
Comment 2 Sindhu S 2012-11-22 17:17:48 UTC
Created attachment 229647 [details] [review]
Removed options from rhythmbox-client man page

I checked out the command line parameters and removed the options that weren't working. However I was unable to write descriptions for undocumented parameters as I couldn't trace out their exact behavior. Am only starting out contributing, do point me towards any guidance/resource if you may have about this. Thanks!
Comment 3 Sindhu S 2012-11-26 14:51:18 UTC
Created attachment 229907 [details] [review]
Removed invalid options in rhythmbox-client man page see bug 672044

Fixed commit message.
Comment 4 Sindhu S 2013-01-28 12:57:18 UTC
Can somebody please review this? So I can go ahead and commit to master.
Comment 5 Sindhu S 2013-02-04 07:47:02 UTC
1. Git cloned Rhythmbox from git.gnome.org/rhythmbox
2. Using Ubuntu Raring Ringtail Vagrant box, apt-get build-dep rhythm box
3. Built (./configure, make, make install) Rhythmbox, binary in /usr/local/bin/rhythmbox -> runs successfully.
4. Checked man rhythmbox-client , patch applied removes obsolete options
5. All fine, pushed to master in commit: 2911ec8086782a5aab4005dcca6a636377e26950
http://git.gnome.org/browse/rhythmbox/commit/?id=2911ec8086782a5aab4005dcca6a636377e26950

Only one glitch though, for committer it says "vagrant@quantal64" even though I have committed from my host machine and _not_ from my vagrant box. If this can be corrected, please let me know.
Comment 6 Jonathan Matthew 2013-02-04 07:59:29 UTC
Please don't commit changes to master without approval from a maintainer.
Comment 7 Sindhu S 2013-02-04 08:10:00 UTC
SO terribly sorry! 

1. Can I revert the commit back?
2. Are you the maintainer? If so, please let me know if there are any problems with the commit and how I can fix it asap.
Comment 8 Sindhu S 2013-05-02 05:13:03 UTC
These command line parameters:

 - check-running : not working, doesn't print anything even if Rhythmbox is currently running (and playing music, if it matters).
 - seek : doesn't work, if I run `rhythmbox-client --seek 3`, the file that's currently playing stops. I have tried this with a variety of seek values. Same behaviour for all of them.
 - set-rating : Doesn't work either.

In that case fresh bugs must be filed regarding these issues and this bug must be closed as the main issue is removing of obsolete parameters which indeed has been removed from Git master.

Please confirm on decision of closing bug and filing fresh bugs for other non-working parameters.
Comment 9 antivirtel 2013-08-23 21:20:04 UTC
https://bugs.launchpad.net/ubuntu/+source/rhythmbox/+bug/958238 - see updates, --hide & --no-start