From 0c1a023c70532b6523317e8ebeae977e80494f53 Mon Sep 17 00:00:00 2001
From: Juergen Spitzmueller <spitz@lyx.org>
Date: Fri, 16 Sep 2016 13:47:26 +0200
Subject: [PATCH] Citation dialog: add & improve tooltips.

---
 src/frontends/qt4/GuiCitation.cpp  |  8 +++++---
 src/frontends/qt4/ui/CitationUi.ui | 22 +++++++++++++++++-----
 2 files changed, 22 insertions(+), 8 deletions(-)

diff --git a/src/frontends/qt4/GuiCitation.cpp b/src/frontends/qt4/GuiCitation.cpp
index b294fd8a28..a7b4af5c04 100644
--- a/src/frontends/qt4/GuiCitation.cpp
+++ b/src/frontends/qt4/GuiCitation.cpp
@@ -104,7 +104,7 @@ GuiCitation::GuiCitation(GuiView & lv)
 	filter_->setAutoHideButton(FancyLineEdit::Right, true);
 #endif
 #if QT_VERSION >= 0x040700
-	filter_->setPlaceholderText(qt_("Filter available"));
+	filter_->setPlaceholderText(qt_("All avail. citations"));
 #endif
 
 	filterBarL->addWidget(filter_, 0);
@@ -368,9 +368,11 @@ void GuiCitation::updateInfo(BiblioInfo const & bi, QModelIndex const & idx)
 {
 	if (!idx.isValid() || bi.empty()) {
 		infoML->document()->clear();
+		infoML->setToolTip(qt_("Displays a sketchy preview if a citation is selected above"));
 		return;
 	}
 
+	infoML->setToolTip(qt_("Sketchy preview of the selected citation"));
 	QString const keytxt = toqstr(
 		bi.getInfo(qstring_to_ucs4(idx.data().toString()), documentBuffer(), true));
 	infoML->document()->setHtml(keytxt);
@@ -479,8 +481,8 @@ void GuiCitation::regexChanged()
 void GuiCitation::updateFilterHint()
 {
 	QString const hint = instant_->isChecked() ?
-		qt_("Enter the text to search for") :
-		qt_("Enter the text to search for and press Enter");
+		qt_("Enter string to filter the list of available citations") :
+		qt_("Enter string to filter the list of available citations and press <Enter>");
 	filter_->setToolTip(hint);
 }
 
diff --git a/src/frontends/qt4/ui/CitationUi.ui b/src/frontends/qt4/ui/CitationUi.ui
index 54638a18eb..4eb346bd3e 100644
--- a/src/frontends/qt4/ui/CitationUi.ui
+++ b/src/frontends/qt4/ui/CitationUi.ui
@@ -44,6 +44,9 @@
          <verstretch>0</verstretch>
         </sizepolicy>
        </property>
+       <property name="toolTip">
+        <string>Select the fields on which the filter applies</string>
+       </property>
        <property name="maxVisibleItems">
         <number>16</number>
        </property>
@@ -68,6 +71,9 @@
          <verstretch>0</verstretch>
         </sizepolicy>
        </property>
+       <property name="toolTip">
+        <string>Select the entry types on which the filter applies</string>
+       </property>
        <property name="insertPolicy">
         <enum>QComboBox::NoInsert</enum>
        </property>
@@ -83,6 +89,9 @@
      </item>
      <item>
       <widget class="QPushButton" name="searchOptionsPB">
+       <property name="toolTip">
+        <string>Click for more filter options</string>
+       </property>
        <property name="text">
         <string>O&amp;ptions</string>
        </property>
@@ -246,6 +255,9 @@
          <property name="acceptDrops">
           <bool>false</bool>
          </property>
+         <property name="toolTip">
+          <string/>
+         </property>
          <property name="readOnly">
           <bool>true</bool>
          </property>
@@ -298,7 +310,7 @@
              </sizepolicy>
             </property>
             <property name="toolTip">
-             <string>Natbib citation style to use</string>
+             <string>Citation style to use, if different styles are provided</string>
             </property>
            </widget>
           </item>
@@ -307,7 +319,7 @@
             <item>
              <widget class="QLineEdit" name="textBeforeED">
               <property name="toolTip">
-               <string>Text to place before citation</string>
+               <string>Text that precedes the reference (e.g., &quot;cf.&quot;)</string>
               </property>
              </widget>
             </item>
@@ -324,7 +336,7 @@
             <item>
              <widget class="QLineEdit" name="textAfterED">
               <property name="toolTip">
-               <string>Text to place after citation</string>
+               <string>Text that follows the reference (e.g., pages)</string>
               </property>
              </widget>
             </item>
@@ -367,7 +379,7 @@
         <item>
          <widget class="QCheckBox" name="forceuppercaseCB">
           <property name="toolTip">
-           <string>Force upper case in citation</string>
+           <string>Force upper case in names (&quot;Del Piero&quot;, not &quot;del Piero&quot;)</string>
           </property>
           <property name="text">
            <string>Force upcas&amp;ing</string>
@@ -377,7 +389,7 @@
         <item>
          <widget class="QCheckBox" name="fulllistCB">
           <property name="toolTip">
-           <string>List all authors</string>
+           <string>Always list all authors (rather than using &quot;et al.&quot;)</string>
           </property>
           <property name="text">
            <string>All aut&amp;hors</string>
-- 
2.39.2