Add contact dialog: add tool tips

To help users understand the purpose of the various fields of this
dialog, tool tips are added by this commit. They provide basic
explanation for the primary controls (name, address/number, account and
group).

Thanks to David Bolton for suggesting the used tool tips text.

2 files changed, 27 insertions, 0 deletions

diff --git a/resources/languages/resources.properties b/resources/languages/resources.properties
index 20b0691..39c5078 100644
--- a/resources/languages/resources.properties
+++ b/resources/languages/resources.properties
@@ -171,6 +171,7 @@ service.gui.CONNECTION=Connection
 service.gui.CONNECTION_FAILED_MSG=Connection failed for the following account: User name: {0}, Server name: {1}. Please check your network connection or contact your network administrator for more information.
 service.gui.CONNECTION_EXPIRED_MSG=You are currently disconnected from the {0} server.
 service.gui.CONTACT_NAME=ID or Number
+service.gui.CONTACT_NAME_INFO=Add either an instant messaging address (such as jane.doe@example.com) or a VoIP number
 service.gui.CONTACT_NOT_SUPPORTING_TELEPHONY=The chosen {0} contact doesn''t support telephony.
 service.gui.CONTACT_NOT_SUPPORTING_CHAT_CONF=The chosen {0} contact doesn''t support chat conferencing.
 service.gui.CONTACT_PAUSED_TYPING={0} paused typing the message
@@ -204,6 +205,7 @@ service.gui.DESKTOP_SHARING_WARNING=<b>Are you sure you want to start screen sha
 service.gui.DESKTOP_SHARING_DIALOG_INDICATE=You are sharing your screen
 service.gui.DIALPAD=Dial Pad
 service.gui.DISPLAY_NAME=Display name
+service.gui.DISPLAY_NAME_INFO=Add a name for this contact. If left blank the IM address or VoIP number will be used. (Optional)
 service.gui.DISCONNECTED_STATUS=Disconnected
 service.gui.DND_STATUS=Do not disturb
 service.gui.DO_NOT_ASK_AGAIN=Don't ask again
@@ -509,8 +511,10 @@ service.gui.SEARCH_FOR_CHAT_ROOMS_MSG=Click the below button to show all chat ro
 service.gui.SEARCH_STRING_CONTACT_SOURCE=Searched contact
 service.gui.SECURITY=Security
 service.gui.SELECT_ACCOUNT=Select account
+service.gui.SELECT_ACCOUNT_INFO=Which account do you want to use to communicate with this contact?
 service.gui.SELECT_COLOR=Select color
 service.gui.SELECT_GROUP=Select group
+service.gui.SELECT_GROUP_INFO=Which group do you want to display this contact under? (Optional)
 service.gui.SELECT_GROUP_WIZARD_MSG=The list below contains all groups in your Contact List. Select the one, where you would like to add the new contact.
 service.gui.SELECT_NO_GROUP=No group
 service.gui.SELECT_GROUP_WIZARD=Specify group
diff --git a/src/net/java/sip/communicator/impl/gui/main/contactlist/AddContactDialog.java b/src/net/java/sip/communicator/impl/gui/main/contactlist/AddContactDialog.java
index 4860f9d..ffb93ea 100644
--- a/src/net/java/sip/communicator/impl/gui/main/contactlist/AddContactDialog.java
+++ b/src/net/java/sip/communicator/impl/gui/main/contactlist/AddContactDialog.java
@@ -170,27 +170,49 @@ public class AddContactDialog
      */
     private void init()
     {
+        // Get tool tip text for primary controls
+        final String display_name_info =
+            GuiActivator.getResources().getI18NString(
+                "service.gui.DISPLAY_NAME_INFO");
+        final String contact_info =
+            GuiActivator.getResources().getI18NString(
+                "service.gui.CONTACT_NAME_INFO");
+        final String account_info =
+            GuiActivator.getResources().getI18NString(
+                "service.gui.SELECT_ACCOUNT_INFO");
+        final String group_info =
+            GuiActivator.getResources().getI18NString(
+                "service.gui.SELECT_GROUP_INFO");
+
+        // Initialize controls
         this.accountLabel = new JLabel(
             GuiActivator.getResources().getI18NString(
                 "service.gui.SELECT_ACCOUNT") + ": ");
+        this.accountLabel.setToolTipText(account_info);
 
         this.accountCombo = new JComboBox();
+        this.accountCombo.setToolTipText(account_info);
 
         this.contactAddressLabel = new JLabel(
             GuiActivator.getResources().getI18NString(
                 "service.gui.CONTACT_NAME") + ": ");
+        this.contactAddressLabel.setToolTipText(contact_info);
 
         this.displayNameLabel = new JLabel(
             GuiActivator.getResources().getI18NString(
                 "service.gui.DISPLAY_NAME") + ": ");
+        this.displayNameLabel.setToolTipText(display_name_info);
 
         this.contactAddressField = new JTextField();
+        this.contactAddressField.setToolTipText(contact_info);
 
         this.displayNameField = new JTextField();
+        this.displayNameField.setToolTipText(display_name_info);
 
         this.groupLabel = new JLabel(
             GuiActivator.getResources().getI18NString(
                 "service.gui.SELECT_GROUP") + ": ");
+        this.groupLabel.setToolTipText(group_info);
 
         this.addButton = new JButton(
             GuiActivator.getResources().getI18NString("service.gui.ADD"));
@@ -201,6 +223,7 @@ public class AddContactDialog
         this.imageLabel = new JLabel();
 
         this.groupCombo = createGroupCombo(this);
+        this.groupCombo.setToolTipText(group_info);
 
         if(metaContact != null)
         {