Doc: Add Alt-text to the Qt SQL examples

QDoc generates warnings for images that do not have alt-text associated
with them. Alt-text is used to add context to images for users who use
screen-readers.

This patch applies alt-text to images in the Qt SQL module that do not
have any alt-text associated with them.

Fixes: QTBUG-135114
Change-Id: Iead375852d30219db7dfed12bb1f383eb55713e6
Reviewed-by: Topi Reiniö <topi.reinio@qt.io>
(cherry picked from commit 7b66c906bf7a8c32650157fdd13221822ec1558e)
Reviewed-by: Qt Cherry-pick Bot <cherrypick_bot@qt-project.org>
(cherry picked from commit f7ad71f39c1ebacfea88b07fb10a05d125ccaf33)

examples/sql/doc/src/books.qdoc

@@ -11,7 +11,7 @@
     The Books example shows how Qt's SQL classes can be used with the model/view
     framework to create rich user interfaces for information stored in a database.
 
-    \borderedimage books-demo.png
+    \image books-demo.png {The main window displays information related to the books stored in the database}
 
     Information about a collection of books is held in a database. The books are
     catalogued by author, title, genre, and year of publication. Although each of

examples/sql/doc/src/cachedtable.qdoc

@@ -11,7 +11,7 @@
     caching any changes to the data until the user explicitly submits them using a
     push button.
 
-    \borderedimage cachedtable-example.png
+    \image cachedtable-example.png {The user updates a cell in the table, and selects the submit button to apply the change in the database}
 
     The example consists of a single class, \c TableEditor, which is a
     custom dialog widget that allows the user to modify data stored in

examples/sql/doc/src/drilldown.qdoc

@@ -11,7 +11,7 @@
     well as submit changes, using the QSqlRelationalTableModel and
     QDataWidgetMapper classes.
 
-    \borderedimage drilldown-example.png Screenshot of the Drill Down Example
+    \image drilldown-example.png {The main window displays user-selectable images of the Qt, Qt Quick, Qt Creator and Qt Project products}
 
     When running the example application, a user can retrieve
     information about each item by clicking the corresponding image.

examples/sql/doc/src/masterdetail.qdoc

@@ -13,9 +13,9 @@
     database, while each album's tracks are stored in an XML
     file.
 
-    The example also shows how to add as well as remove data from both
+    The example also shows how to add, as well as remove data from both
     the database and the associated XML file using the API provided by
     the Qt SQL and Qt XML modules, respectively.
 
-    \borderedimage masterdetail-example.png
+    \image masterdetail-example.png {The main window displays artist and album information from the database, together with the album tracks stored in an XML file}
 */

examples/sql/doc/src/querymodel.qdoc

@@ -11,5 +11,5 @@
     data obtained from a SQL query, using a model that encapsulates
     the query and table views to display the results.
 
-    \borderedimage querymodel-example.png
+    \image querymodel-example.png {The user can create different query models, from a Plain Query Model, to models that can be edited and customized further}
 */

examples/sql/doc/src/relationaltablemodel.qdoc

@@ -10,5 +10,5 @@
     \brief The Relational Table Model example shows how to use table views with a relational
     model to visualize the relations between items in a database.
 
-    \borderedimage relationaltablemodel-example.png
+    \image relationaltablemodel-example.png {The main window displays the relationship between a user's name, the city that that they are from, as well as the corresponding country}
 */

examples/sql/doc/src/sqlbrowser.qdoc

@@ -10,5 +10,5 @@
     \brief The SQL Browser example shows how a data browser can be used to visualize
     the results of SQL statements on a live database.
 
-    \borderedimage sqlbrowser-demo.png
+    \image sqlbrowser-demo.png {The main window depicts the connected database together with the items in the database. The user is able to generate an SQL query and submit it.}
 */

examples/sql/doc/src/sqlwidgetmapper.qdoc

@@ -10,7 +10,7 @@
     \brief The SQL Widget Mapper example shows how to use a map information from a
     database to widgets on a form.
 
-    \borderedimage sql-widget-mapper.png
+    \image sql-widget-mapper.png {The main window displays the user name, the user address, and it classifies the address type.}
 
     In the \l{Combo Widget Mapper Example}, we showed how to use a named
     mapping between a widget mapper and a QComboBox widget with a special
@@ -51,7 +51,7 @@
     including values for the address types that correspond to the address
     types are stored in a separate table.
 
-    \borderedimage widgetmapper-sql-mapping-table.png
+    \image widgetmapper-sql-mapping-table.png {The main window displays a table that consists of the information stored in the database.}
 
     We create an "addresstype" table containing the identifiers used in the
     "person" table and the corresponding strings:
@@ -70,7 +70,7 @@
     used wherever the "typeid" is presented to the user. (See the
     QSqlRelationalTableModel::setRelation() documentation for details.)
 
-    \borderedimage widgetmapper-sql-mapping.png
+    \image widgetmapper-sql-mapping.png {The table depicts the relationship between the "typeid" field and the "addresstype".}
 
     The constructor of the \c Window class can be explained in three parts.
     In the first part, we set up the model used to hold the data, then we set

examples/sql/doc/src/tablemodel.qdoc

@@ -10,5 +10,5 @@
     \brief The Table Model example shows how to use a specialized SQL table model with table
     views to edit information in a database.
 
-    \borderedimage tablemodel-example.png
+    \image tablemodel-example.png {The user is able to edit fields in Table Model View 1, and these changes are propagated to Table Model View 2}
 */

src/sql/doc/src/sql-programming.qdoc

@@ -565,7 +565,7 @@
     using QDataWidgetMapper with an SQL model is as simple as using it with
     any other table model.
 
-    \image qdatawidgetmapper-simple.png
+    \image qdatawidgetmapper-simple.png {The table depicts the relationship between the different fields}
 
     The \l{books}{Books} example shows how information can
     be presented for easy access by using QDataWidgetMapper and a set of

src/sql/models/qsqlrelationaldelegate.cpp

@@ -23,7 +23,7 @@ QT_BEGIN_NAMESPACE
     conjunction with QSqlRelationalTableModel to provide tables with
     foreign key support.
 
-    \image relationaltable.png
+    \image relationaltable.png {The user is able to edit a foreign key in a relational table}
 
     \sa QSqlRelationalTableModel, {Model/View Programming}
 */

src/sql/models/qsqlrelationaltablemodel.cpp

@@ -347,7 +347,7 @@ void QSqlRelationalTableModelPrivate::clearCache()
     QSqlRelationalDelegate to provide tables with foreign key
     support.
 
-    \image relationaltable.png
+    \image relationaltable.png {The user is able to edit a foreign key in a relational table}
 
     Notes: