Added QWhatsThis help text

3 files changed, 28 insertions, 3 deletions

diff --git a/noncore/apps/dagger/configuredlg.cpp b/noncore/apps/dagger/configuredlg.cpp
index e4dd60f..0a9317c 100644
--- a/noncore/apps/dagger/configuredlg.cpp
+++ b/noncore/apps/dagger/configuredlg.cpp
@@ -19,5 +19,6 @@ file; see the file COPYING. If not, write to the Free Software Foundation, Inc.,
 
-#include <qvbuttongroup.h>
 #include <qlabel.h>
 #include <qlayout.h>
+#include <qvbuttongroup.h>
+#include <qwhatsthis.h>
 
@@ -25,3 +26,3 @@ ConfigureDlg::ConfigureDlg( QWidget *parent, const QString &swordPath, bool alwa
                             bool disableBlanking, int copyFormat, const QFont *font )
-    : QDialog( parent, QString::null, true )
+    : QDialog( parent, QString::null, true, WStyle_ContextHelp )
     , m_tabs( this )
@@ -40,6 +41,8 @@ ConfigureDlg::ConfigureDlg( QWidget *parent, const QString &swordPath, bool alwa
 
-    QLabel *label = new QLabel( tr( "Path where Sword modules are located:" ), widget );
+    QLabel *label = new QLabel( tr( "Path where Sword texts are located:" ), widget );
     label->setAlignment( Qt::AlignLeft | Qt::AlignTop | Qt::WordBreak );
+    QWhatsThis::add( label, tr( "Enter the path where the Sword modules (Bible texts, commentaries, etc.) can be found.  This path should contain either the 'mods.conf' file or 'mods.d' sub-directory." ) );
     grid->addMultiCellWidget( label, 0, 0, 0, 1 );
     m_swordPath = new QLineEdit( swordPath, widget );
+    QWhatsThis::add( m_swordPath, tr( "Enter the path where the Sword texts (Bibles, commentaries, etc.) can be found.  This path should contain either the 'mods.conf' file or 'mods.d' sub-directory." ) );
     grid->addMultiCellWidget( m_swordPath, 1, 1, 0, 1 );
@@ -47,2 +50,3 @@ ConfigureDlg::ConfigureDlg( QWidget *parent, const QString &swordPath, bool alwa
     label->setAlignment( Qt::AlignHCenter | Qt::AlignTop | Qt::WordBreak );
+    QWhatsThis::add( label, tr( "Enter the path where the Sword modules (Bible texts, commentaries, etc.) can be found.  This path should contain either the 'mods.conf' file or 'mods.d' sub-directory." ) );
     grid->addMultiCellWidget( label, 2, 2, 0, 1 );
@@ -53,2 +57,3 @@ ConfigureDlg::ConfigureDlg( QWidget *parent, const QString &swordPath, bool alwa
     m_alwaysOpenNew->setChecked( alwaysOpenNew );
+    QWhatsThis::add( m_alwaysOpenNew, tr( "Tap here to always open texts in a new window.  If this option is not selected, only one copy of a Sword text will be opened." ) );
     grid->addMultiCellWidget( m_alwaysOpenNew, 4, 4, 0, 1 );
@@ -59,2 +64,3 @@ ConfigureDlg::ConfigureDlg( QWidget *parent, const QString &swordPath, bool alwa
     label->setAlignment( Qt::AlignLeft | Qt::AlignTop | Qt::WordBreak );
+    QWhatsThis::add( label, tr( "Enter the number of verses to display at a time.  This also affects how far the scroll to previous/next page buttons on the Navigation bar scroll." ) );
     grid->addWidget( label, 6, 0 );
@@ -62,2 +68,3 @@ ConfigureDlg::ConfigureDlg( QWidget *parent, const QString &swordPath, bool alwa
     m_numVerses->setValue( numVerses );
+    QWhatsThis::add( m_numVerses, tr( "Enter the number of verses to display at a time.  This also affects how far the scroll to previous/next page buttons on the Navigation bar scroll." ) );
     grid->addWidget( m_numVerses, 6, 1 );
@@ -68,2 +75,3 @@ ConfigureDlg::ConfigureDlg( QWidget *parent, const QString &swordPath, bool alwa
     m_disableScreenBlank->setChecked( disableBlanking );
+    QWhatsThis::add( m_disableScreenBlank, tr( "Tap here to disable Opie's automatic power management feature which will dim and turn off the screen after a specified time.  This will only be effective while Dagger is running." ) );
     grid->addMultiCellWidget( m_disableScreenBlank, 8, 8, 0, 1 );
@@ -74,2 +82,3 @@ ConfigureDlg::ConfigureDlg( QWidget *parent, const QString &swordPath, bool alwa
     widget = new QWidget( this );
+    QWhatsThis::add( widget, tr( "Select the format used when copying the current verse to the clipboard." ) );
     layout = new QVBoxLayout( widget );
@@ -117,2 +126,4 @@ ConfigureDlg::ConfigureDlg( QWidget *parent, const QString &swordPath, bool alwa
         m_font->setSelectedFont( *font );
+    QWhatsThis::add( m_font, tr( "Select the font, style and size used for displaying texts." ) );
+
     m_tabs.addTab( m_font, "font", tr( "Font" ) );
diff --git a/noncore/apps/dagger/navbar.cpp b/noncore/apps/dagger/navbar.cpp
index 212dc36..97761f7 100644
--- a/noncore/apps/dagger/navbar.cpp
+++ b/noncore/apps/dagger/navbar.cpp
@@ -24,2 +24,3 @@ file; see the file COPYING. If not, write to the Free Software Foundation, Inc.,
 #include <qlineedit.h>
+#include <qwhatsthis.h>
 
@@ -31,2 +32,3 @@ NavBar::NavBar( QMainWindow *parent )
                                        QString::null, 0, this, 0 );
+    m_actionPrevPage->setWhatsThis( tr( "Tap here to scroll backward one page." ) );
     m_actionPrevPage->addTo( this );
@@ -36,2 +38,3 @@ NavBar::NavBar( QMainWindow *parent )
                                      QString::null, 0, this, 0 );
+    m_actionPrevVerse->setWhatsThis( tr( "Tap here to scroll backward one verse." ) );
     m_actionPrevVerse->addTo( this );
@@ -41,2 +44,3 @@ NavBar::NavBar( QMainWindow *parent )
     setStretchableWidget( m_key );
+    QWhatsThis::add( m_key, tr( "Enter location to display here." ) );
     connect(m_key, SIGNAL(textChanged(const QString &)), this, SIGNAL(keyChanged(const QString &)) );
@@ -45,2 +49,3 @@ NavBar::NavBar( QMainWindow *parent )
                                      QString::null, 0, this, 0 );
+    m_actionNextVerse->setWhatsThis( tr( "Tap here to scroll forward one verse." ) );
     m_actionNextVerse->addTo( this );
@@ -50,2 +55,3 @@ NavBar::NavBar( QMainWindow *parent )
                                        QString::null, 0, this, 0 );
+    m_actionNextPage->setWhatsThis( tr( "Tap here to scroll forward one page." ) );
     m_actionNextPage->addTo( this );
@@ -57,2 +63,3 @@ NavBar::NavBar( QMainWindow *parent )
     m_scrollRate->setMinimumWidth( 35 );
+    QWhatsThis::add( m_scrollRate, tr( "Adjust auto-scroll rate here.  A larger value represents a slower scrolling rate." ) );
     connect( m_scrollRate, SIGNAL(valueChanged(int)), this, SIGNAL(scrollRateChanged(int)) );
@@ -62,2 +69,3 @@ NavBar::NavBar( QMainWindow *parent )
     m_actionScroll->setToggleAction( true );
+    m_actionScroll->setWhatsThis( tr( "Tap here to start or stop auto-scrolling." ) );
     connect( m_actionScroll, SIGNAL(toggled(bool)), this, SIGNAL(autoScroll(bool)) );
diff --git a/noncore/apps/dagger/searchbar.cpp b/noncore/apps/dagger/searchbar.cpp
index ff434dd..9953e8f 100644
--- a/noncore/apps/dagger/searchbar.cpp
+++ b/noncore/apps/dagger/searchbar.cpp
@@ -28,2 +28,3 @@ file; see the file COPYING. If not, write to the Free Software Foundation, Inc.,
 #include <qlineedit.h>
+#include <qwhatsthis.h>
 
@@ -45,2 +46,3 @@ SearchBar::SearchBar( QMainWindow *parent )
     setStretchableWidget( m_searchText );
+    QWhatsThis::add( m_searchText, tr( "Enter text to search for here." ) );
     connect(m_searchText, SIGNAL(textChanged(const QString &)),
@@ -52,2 +54,3 @@ SearchBar::SearchBar( QMainWindow *parent )
     m_actionFind->addTo( this );
+    m_actionFind->setWhatsThis( tr( "Tap here search the current module for the text entered to the left." ) );
     connect( m_actionFind, SIGNAL(activated()), this, SLOT(slotFind()) );
@@ -60,2 +63,3 @@ SearchBar::SearchBar( QMainWindow *parent )
     m_actionPrev->addTo( this );
+    m_actionPrev->setWhatsThis( tr( "Tap here to view the previous search result." ) );
     connect( m_actionPrev, SIGNAL(activated()), this, SLOT(slotPrev()) );
@@ -64,2 +68,3 @@ SearchBar::SearchBar( QMainWindow *parent )
     m_resultList->setEnabled( false );
+    QWhatsThis::add( m_resultList, tr( "Select the desired search result here." ) );
     connect( m_resultList, SIGNAL(activated(const QString &)), this, SIGNAL(sigResultClicked(const QString &)) );
@@ -70,2 +75,3 @@ SearchBar::SearchBar( QMainWindow *parent )
     m_actionNext->addTo( this );
+    m_actionNext->setWhatsThis( tr( "Tap here to view the next search result." ) );
     connect( m_actionNext, SIGNAL(activated()), this, SLOT(slotNext()) );