Closed Bug 834028 Opened 7 years ago Closed 7 years ago
Wrong parameter name for f
EAlert method in ns IImap Server Sink interface
I just saw this by coincidence: There is a typo in the fEAlert() parameter definition for the alert string, which is "aAlertSring" rather than correct "aAlertString" (introduced with bug 137489 renaming that parameter). That's likely non-consequential, but since I ran into it, no reason not to fix it. ;-)
These are the two only occurrences of that string. I don't know how to test this as I'm unable to trigger a message, but it compiles and runs without issues.
Oh, and I didn't rev the UUID given that the type of the parameter is unchanged.
http://mxr.mozilla.org/comm-central/source/mailnews/imap/src/nsImapIncomingServer.cpp#1791 defines the implementation as nsImapIncomingServer::FEAlert(const nsAString& aString, nsIMsgMailNewsUrl *aUrl Shouldn't this be "const nsAString& aAlertString" as well?
Let's make this consistent, also fixes the FEAlertFromServer parameter.
Comment on attachment 705600 [details] [diff] [review] Fix typo in name I'm going to + this one because I'm not sure the other one is worthwhile.
Ok, let's wait for Mark. I figured that it's better to make the argument lists of the implementations match the prototypes for these cases, to avoid any ambiguity.
(In reply to firstname.lastname@example.org from comment #5) > ... I'm not sure the other one is worthwhile. While Mark seems to be busy hunting down the various bustages, can you elaborate a bit more where you see any problems with the "long version" of the patch? Maybe it wasn't worth the effort to also fix the implementations, but now I've done it and so it's readily available. Having the arguments match the prototypes helps reading the code when you see it the first time a lot, and we only talk about changing a parameter's name. Thus, I don't see any risk involved.
The first is a typo change, after all if you're searching for both "Alert" and "String" in the same line you'll miss this. The second is more subtle as the word "Alert" is already present on the same line as well as throughout the body of the function and its purpose is therefore more obvious.
Well, that sure is a point, but then you could argue that the interface definition should consistently use "aString" only as well for fEAlert() and fEAlertFromServer(). The main issue is consistency in the parameter naming between interface and implementation rather than the name itself. It was my impression that bug 137489 renamed the interface argument on purpose from the generic "aString" to more specific ones, thus I'd tend to correct the implementation rather than reverting that change other than correcting the typo.
(In reply to rsx11m from comment #9) > It was my impression that bug 137489 renamed the interface argument on > purpose from the generic "aString" to more specific ones, thus I'd tend to > correct the implementation rather than reverting that change other than > correcting the typo. Well, let's ask the author ;-)
Yeah, that's correct. I don't think aString is a good name for anything (but the new ones coule perhaps have been better too). Sorry about the typo.
Comment on attachment 705681 [details] [diff] [review] Fix all occurences OK, so as this was just an oversight by mkmelin, then r=me.
Attachment #705681 - Flags: review?(neil) → review+
Comment on attachment 705681 [details] [diff] [review] Fix all occurences Thanks, I'm cancelling the feedback request for Mark given the r+ for this one.
Push for trunk/comm-central, please.
Whiteboard: [c-n: comm-central]
Status: ASSIGNED → RESOLVED
Closed: 7 years ago
Resolution: --- → FIXED
Whiteboard: [c-n: comm-central]
Target Milestone: --- → Thunderbird 21.0
You need to log in before you can comment on or make changes to this bug.