Bug 99997 - Copy email and address from header to clipboard. r=IanN

Port TB Bug 232021 [name should be included with email address when copying from header menu].

suite/locales/en-US/chrome/mailnews/msgHdrViewPopup.dtd

@@ -13,6 +13,8 @@
 <!ENTITY SendMailTo.accesskey              "s">
 <!ENTITY CopyEmailAddress.label            "Copy Email Address">
 <!ENTITY CopyEmailAddress.accesskey        "C">
+<!ENTITY CopyNameAndEmailAddress.label     "Copy Name and Email Address">
+<!ENTITY CopyNameAndEmailAddress.accesskey "N">
 <!ENTITY CreateFilterFrom.label            "Create Filter From…">
 <!ENTITY CreateFilterFrom.accesskey        "F">
 <!ENTITY openInBrowser.label               "Open in Browser">

suite/mailnews/mailContextMenus.js

@@ -479,12 +479,22 @@ function SendMailTo(fullAddress, aEvent)
   MailServices.compose.OpenComposeWindowWithParams(null, params);
 }
 
-// CopyEmailAddress takes the email address title button, extracts
-// the email address we stored in there and copies it to the clipboard
-function CopyEmailAddress(emailAddressNode)
+/**
+ * Takes the email address, extracts the address/name
+ * we stored in there and copies it to the clipboard.
+ *
+ * @param addressNode  a node which has an "emailAddress"
+ *                     attribute
+ * @param aIncludeName when true, also copy the name onto the clipboard,
+ *                     otherwise only the email address
+ */
+function CopyEmailAddress(emailAddressNode, aIncludeName = false)
 {
-  if (emailAddressNode)
-    CopyString(emailAddressNode.getAttribute("emailAddress"));
+  if (emailAddressNode) {
+    let address = emailAddressNode.getAttribute(aIncludeName ? "fullAddress"
+                                                             : "emailAddress");
+    CopyString(address);
+  }
 }
 
 // show the message id in the context menu

suite/mailnews/msgHdrViewOverlay.xul

@@ -79,7 +79,11 @@
   <menuitem id="copyEmailAddressItem"
             label="&CopyEmailAddress.label;"
             accesskey="&CopyEmailAddress.accesskey;"
-            oncommand="CopyEmailAddress(document.popupNode)"/>
+            oncommand="CopyEmailAddress(document.popupNode);"/>
+  <menuitem id="copyNameAndEmailAddressItem"
+            label="&CopyNameAndEmailAddress.label;"
+            accesskey="&CopyNameAndEmailAddress.accesskey;"
+            oncommand="CopyEmailAddress(document.popupNode, true);"/>
 </menupopup>
 
 <menupopup id="attachmentListContext" onpopupshowing="return onShowAttachmentContextMenu();">