! Please note that this is a snapshot of our old Bugzilla server, which is read only since May 29, 2020. Please go to gitlab.xfce.org for our new server !
Patches for xfce4-mixer strings
Status:
CLOSED: FIXED
Severity:
enhancement
Product:
Xfce4-mixer
Component:
Panel Plugin

Comments

Description Josh Saddler 2008-12-10 06:35:52 CET
Here's the stuff for the panel plugin. Only xfce-volume-button.c didn't seem to need any changes; the others have the usual improvements per the strings style guidelines.
Comment 1 Josh Saddler 2008-12-10 06:36:23 CET
Created attachment 2027 
xfce-mixer-plugin.c.patch
Comment 2 Josh Saddler 2008-12-10 06:36:42 CET
Created attachment 2028 
xfce-plugin-dialog.c.patch
Comment 3 Josh Saddler 2008-12-10 07:38:22 CET
Created attachment 2029 
xfce-mixer.c.patch

More stuff for xfce4-mixer.
Comment 4 Josh Saddler 2008-12-10 07:38:36 CET
Created attachment 2030 
xfce-mixer-controls-dialog.c.patch
Comment 5 Josh Saddler 2008-12-10 07:38:53 CET
Created attachment 2031 
xfce-mixer-window.c.patch
Comment 6 Josh Saddler 2008-12-10 07:45:22 CET
I went through the libxfce4mixer files; nothing to be done for anything there. It didn't have any strings that needed changin'.
Comment 7 Jannis Pohlmann editbugs 2008-12-10 20:17:09 CET
What is the rationale behind removing "Please" from all strings?
Comment 8 Josh Saddler 2008-12-10 20:20:02 CET
Shortening the strings, which the style guide says is good. No real need for 'em. It's not impolite to leave them out; it may even be too polite to leave them in.

It's better to get straight to the point when asking the user for action. :)

Lemme ask you this -- why preface every request string with "please"? Why leave it *in*?
Comment 9 Brian J. Tarricone (not reading bugmail) 2008-12-10 22:05:12 CET
In general I don't object to prefixing requests with "please" when it's in a dialog box where it's unavoidable to directly address the user, but I'd leave it out in most places, especially in an XfceTitledDialog subtitle.  The subtitle should *not* be used as a replacement for proper dialog text.  It should provide a short and to-the-point expository description of what the dialog is for.  To put it another way, you shouldn't be using the subtitle to ask the user to do something.  (I'd say the usage in xfce-mixer-controls-dialog.c is wrong, though I woudn't say that definitively as I haven't looked at the actual dialog.)

(Josh: as a note for future work, it's easier on us if you just create one patch file with all of the changes, instead of one patch per source file.)
Comment 10 Jannis Pohlmann editbugs 2008-12-10 23:08:47 CET
(In reply to comment #8)
> Shortening the strings, which the style guide says is good. No real need for
> 'em. It's not impolite to leave them out; it may even be too polite to leave
> them in.
> 
> It's better to get straight to the point when asking the user for action. :)

Right.
 
> Lemme ask you this -- why preface every request string with "please"? Why leave
> it *in*?

I thought it would be more polite and friendly. But if you say it isn't necessarily needed, I'm fine with removing the "please". In fact, I've just committed your patches (the one for xfce-mixer-plugin.c with one modification) to SVN (revision 29004).

Bug #4704

Reported by:
Josh Saddler
Reported on: 2008-12-10
Last modified on: 2011-11-04

People

Assignee:
Jannis Pohlmann
CC List:
2 users

Version

Attachments

xfce-mixer-plugin.c.patch (1.12 KB, patch)
2008-12-10 06:36 CET , Josh Saddler
no flags
xfce-plugin-dialog.c.patch (698 bytes, patch)
2008-12-10 06:36 CET , Josh Saddler
no flags
xfce-mixer.c.patch (850 bytes, patch)
2008-12-10 07:38 CET , Josh Saddler
no flags
xfce-mixer-controls-dialog.c.patch (686 bytes, patch)
2008-12-10 07:38 CET , Josh Saddler
no flags
xfce-mixer-window.c.patch (684 bytes, patch)
2008-12-10 07:38 CET , Josh Saddler
no flags

Additional information