Merge branch 'topic/glade-deprecation' into 'master'

Document a Glade deprecation disclaimer

Closes #15

See merge request eng/ide/gtkada!33

Author: eliericha

docs/gtkada_ug/getting_started.rst

@@ -17,7 +17,7 @@ How to build and install GtkAda
 This section explains how to build and install GtkAda on your machine.
 
 On Windows systems, we provide an automatic installer that installs GtkAda
-along with dependent components like gtk+ libraries and `Glade`.
+along with dependent components like gtk+ libraries.
 
 On Unix systems, just follow the instructions listed in the
 :file:`README-gtkada-<release>.txt` file. Note that the :file:`doinstall.sh` script

docs/gtkada_ug/glade.rst

@@ -1,13 +1,27 @@
 .. _Support_for_Glade,_the_Gtk_GUI_builder:
 
-**************************************
-Support for Glade, the Gtk GUI builder
-**************************************
+****************************************************************
+Support for Glade, the Gtk GUI builder (planned for deprecation)
+****************************************************************
+
+Deprecation
+===========
+
+GtkAda 26 will be the last release that includes Glade; Glade will be removed
+from GtkAda starting with the 27.0 release.
+
+`Glade <https://glade.gnome.org/>`_ is no longer maintained in the wider GNOME
+community, as per the release notes of the last stable release 3.40.0. Using
+Glade to produce XML GtkBuilder UI definitions is discouraged.
+
+However the XML GtkBuilder UI definitions format itself is still a supported
+artifact of the `Gtk.Builder <https://docs.gtk.org/gtk3/class.Builder.html>`_
+API and a valid means of interaction with the `Gtkada.Builder` package.
 
 Introduction
 ============
 
-GtkAda now comes with support for the GUI builder Glade-3.  Glade-3 provides a
+GtkAda comes with support for the GUI builder Glade-3.  Glade-3 provides a
 graphical interface for designing windows and dialogs.  The interface
 description is saved in an XML file which can be loaded at run-time by your
 GtkAda application. With this approach, there is no need to write or generate

docs/gtkada_ug/intro.rst

@@ -21,10 +21,6 @@ callbacks area), and object-oriented programming. As opposed to common
 knowledge, it requires *less* type casting than with in C.  Its efficiency is
 about the same as the C library through the use of inline subprograms.
 
-GtkAda comes with a complete integration to the graphical interface builder
-`Glade`. This makes it even easier to develop interfaces, since you just have to
-click to create a description of the window and all the dialogs. Ada code can
-simply import that description to bring the windows to life.
 
 Under some platforms, GtkAda also provides a bridge to use OpenGL, with which
 you can create graphical applications that display 3D graphics, and display
@@ -33,14 +29,12 @@ document OpenGL at all, see any book on OpenGL, or the specification that came
 with your OpenGL library, for more information.
 
 The following Internet sites will always contain the latest public packages for
-`GtkAda`, `gtk+`, `Glade` and `Cairo`
+`GtkAda`, `gtk+` and `Cairo`
 
 * `https://github.com/AdaCore/gtkada <https://github.com/AdaCore/gtkada>`_
 
 * `http://www.gtk.org/ <http://www.gtk.org/>`_
 
-* `http://glade.gnome.org/ <http://glade.gnome.org/>`_
-
 * `http://www.cairographics.org/ <http://www.cairographics.org/>`_
 
 This toolkit was tested on the following systems: