diff --git a/Apps/Examples/Files/Pictures/Source_Code.rst b/Apps/Examples/Files/Pictures/Source_Code.rst index 31a35676d9017a002e373b09c7a59d1ea920f527..df9259f0179439aeecad74d128e61ef37f425ff9 100644 --- a/Apps/Examples/Files/Pictures/Source_Code.rst +++ b/Apps/Examples/Files/Pictures/Source_Code.rst @@ -108,7 +108,7 @@ The ``show_details`` method loads an image at its full size for display in the d :start-at: def show_details :end-at: self.pages.show_page -We use the `Gtk.TreePath`_ passed to this method, along with a `Gtk.TreeIter`_ object, to obtain the file name of the image from the model. A good introduction to this class is provided by the `Tree and List Widgets`_ chapter of the `Python GTK+ 3 Tutorial`_. +We use the `Gtk.TreePath`_ passed to this method, along with a `Gtk.TreeIter`_ object, to obtain the file name of the image from the model. A good introduction to this class is provided by the `Tree and List Widgets`_ chapter of the `Python GTK 3 Tutorial`_. Summary ------- diff --git a/Apps/Examples/General/Simple_Weather/Features/Cascading_Style_Sheets.rst b/Apps/Examples/General/Simple_Weather/Features/Cascading_Style_Sheets.rst index 39275cbc676c2b3541e229173eab9c2b87d1f1ae..ca9d92efdd2cb16b61f2035013dc790d11af391b 100644 --- a/Apps/Examples/General/Simple_Weather/Features/Cascading_Style_Sheets.rst +++ b/Apps/Examples/General/Simple_Weather/Features/Cascading_Style_Sheets.rst @@ -64,6 +64,6 @@ Care must be taken to avoid applying too many rules to the widgets in your appli Further Reading --------------- -The `GTK+ CSS Overview`_ and `GTK+ CSS Properties`_ documents on the GNOME developer site are useful for determining which parts of the standard widgets can be styled, and what changes they support. +The `GTK CSS Overview`_ and `GTK CSS Properties`_ documents on the GNOME developer site are useful for determining which parts of the standard widgets can be styled, and what changes they support. .. include:: /links.txt diff --git a/Apps/Examples/General/Treasure/Details/Main_Program.rst b/Apps/Examples/General/Treasure/Details/Main_Program.rst index 83b2d0fe8be8eb220d548f209bfe8d6c9606578d..4ebd40d0d2214ca20ad042f413c48becd14c7d27 100644 --- a/Apps/Examples/General/Treasure/Details/Main_Program.rst +++ b/Apps/Examples/General/Treasure/Details/Main_Program.rst @@ -24,7 +24,7 @@ We also import modules that allow us to create user interfaces: :start-at: import gi :end-at: Handy.init -These are standard modules for accessing GTK+ and GNOME features, plus the ``Handy`` module that helps us to create adaptive user interfaces. +These are standard modules for accessing GTK and GNOME features, plus the ``Handy`` module that helps us to create adaptive user interfaces. The Application Class --------------------- diff --git a/Apps/Examples/General/Treasure/Details/User_Interface.rst b/Apps/Examples/General/Treasure/Details/User_Interface.rst index 0273f6374b0df6c5a12003c53fd04c4f105c41d2..0ae01f25fd195e965e261b32b614be6a8a8e9824 100644 --- a/Apps/Examples/General/Treasure/Details/User_Interface.rst +++ b/Apps/Examples/General/Treasure/Details/User_Interface.rst @@ -39,6 +39,6 @@ Unlike the user interface for the window, the menu's UI file was defined in a te .. literalinclude:: ../app/src/ui/menus.ui -The actions are defined to be application-wide: each has the ``app.`` prefix. Their strings are marked as translatable so that they will be included in the message catalogs described in :ref:`examples_Treasure_po_dir`. Actions are described in more details in the `Actions section`_ of the `Python GTK+ 3 Tutorial`_. +The actions are defined to be application-wide: each has the ``app.`` prefix. Their strings are marked as translatable so that they will be included in the message catalogs described in :ref:`examples_Treasure_po_dir`. Actions are described in more details in the `Actions section`_ of the `Python GTK 3 Tutorial`_. .. include:: /links.txt diff --git a/Apps/GNOME/GBuilder.rst b/Apps/GNOME/GBuilder.rst index ea6be8d5c5350f1f746b8122233d630ec2eeca7c..1aa42789ff95c56a46376f44c1fa7c5477ab7af5 100644 --- a/Apps/GNOME/GBuilder.rst +++ b/Apps/GNOME/GBuilder.rst @@ -11,7 +11,7 @@ This section will show you how to use GNOME Builder for developing, building, and deploying app flatpaks to a phone shell environment. Apps built from GNOME Builder can theoretically be deployed on Plasma Mobile as well. -Builder is a fantastic IDE traditionally used for building GNOME GTK+ apps however the fun doesn't have to stop there. It can build KDE apps as long as there is flatpak metadata for the application - more on that later. +Builder is a fantastic IDE traditionally used for building GNOME GTK apps however the fun doesn't have to stop there. It can build KDE apps as long as there is flatpak metadata for the application - more on that later. First, checkout the `GNOME Builder documentation`_. @@ -74,7 +74,7 @@ qemu-aarch64:: ******************************************************** -Building a C/GTK+3 (libhandy) flatpak with GNOME Builder +Building a C/GTK 3 (libhandy) flatpak with GNOME Builder ******************************************************** For this example, the `geary `_ application will be built (written in C and available in Debian apt repositories). This build was done on an x86 system running Debian testing. @@ -127,7 +127,7 @@ Alternatively, you can click the omnibar in Builder and select the "Export Bundl When the flatpak creation is finished, a nautilus window will pop up in the directory where the sm.puri.Handy.Example.flatpak is located. In this example, the flatpak can be found here: ~/.var/app/org.gnome.Builder/cache/gnome-builder/projects/libhandy/flatpak/staging/arm-wip-stackablebox/sm.puri.Handy.Example.flatpak ********************************************************************** -Deploying a C/GTK+3 (libhandy) flatpak to Phosh running on i.MX6 board +Deploying a C/GTK 3 (libhandy) flatpak to Phosh running on i.MX6 board ********************************************************************** To run this flatpak you must first get the flatpak onto the dev board and install it. diff --git a/Apps/GNOME/Gtk+.rst b/Apps/GNOME/GTK.rst similarity index 82% rename from Apps/GNOME/Gtk+.rst rename to Apps/GNOME/GTK.rst index 19fb54643f0e5f3a590f398c69ad8688c0f8a233..5d6e27eac30d5f8830fd35c4a5e30affe822edeb 100644 --- a/Apps/GNOME/Gtk+.rst +++ b/Apps/GNOME/GTK.rst @@ -1,10 +1,14 @@ .. _gtk_adaptive_overview: -GTK+ -==== +GTK +=== -`GTK+ `_ is the graphical application framework used to develop all GNOME applications. This guide aims to provide a brief overview of GTK+ applications and tools that can assist in their development. +Applications (apps) for the Librem 5 will typically be built using the +`GTK toolkit`_. In fact many of the apps available will have been ported from +existing apps which are part of the GNOME environment. + +This guide aims to provide a brief overview of GTK 3 applications and the tools that can assist in their development. GTK 3.32 is the minimum version that applications on the Librem 5 are expected to use. .. contents:: :local: @@ -57,12 +61,12 @@ Debugging It can be useful to examine the user interface of a running application for debugging or diagnostic purposes. -The GTK+ Inspector -~~~~~~~~~~~~~~~~~~ +The GTK Inspector +~~~~~~~~~~~~~~~~~ -The `GTK+ Inspector`_ is a tool giving you direct and dynamic access to the internal state of the user interface of your GTK+ application at runtime. It is similar in concept to a web inspector. +The `GTK Inspector`_ is a tool giving you direct and dynamic access to the internal state of the user interface of your GTK application at runtime. It is similar in concept to a web inspector. -The GTK+ Inspector is an extremely convenient tool to help with debugging your GTK+ application. To use it you first need to enable it via GSettings:: +The GTK Inspector is an extremely convenient tool to help with debugging your GTK application. To use it you first need to enable it via GSettings:: $ gsettings set org.gtk.Settings.Debug enable-inspector-keybinding true @@ -72,7 +76,7 @@ Alternatively you can set the ``GTK_DEBUG`` environment variable to ``interactiv $ GTK_DEBUG=interactive your-application -.. note:: For the GTK+ Inspector to work in your flatpaked application, see how to `enable dconf access`_ in the the Flatpak documentation. +.. note:: For the GTK Inspector to work in your flatpaked application, see how to `enable dconf access`_ in the the Flatpak documentation. .. include:: /links.txt diff --git a/Apps/GNOME/Glade.rst b/Apps/GNOME/Glade.rst index 4f13d7e52c17c5a1e89d5263ed4ff365ab16ae5a..9294c6b7ff299fd751a4d866acf9cdd46c502eb3 100644 --- a/Apps/GNOME/Glade.rst +++ b/Apps/GNOME/Glade.rst @@ -3,7 +3,7 @@ Glade ===== -`Glade`_ is a Rapid Application Development (RAD) tool for designing GTK+ based +`Glade`_ is a Rapid Application Development (RAD) tool for designing GTK based user interfaces (UIs). It provides a visual environment that enables developers to design UIs for their applications that can be easily accessed by the code that handles the application logic. diff --git a/Apps/GNOME/Resources.rst b/Apps/GNOME/Resources.rst index ebf089316e86e1a91f6f13d225a4231bcbbc170a..9ec6e6b4c48ce5c9bf9b4b7edfb46ed7672c18e1 100644 --- a/Apps/GNOME/Resources.rst +++ b/Apps/GNOME/Resources.rst @@ -1,7 +1,7 @@ .. _gnome_resources: -GTK+/GNOME Resources -==================== +GTK/GNOME Resources +=================== When developing an application for the GNOME environment running on a Librem 5 phone, the following resources may contain useful information and advice: diff --git a/Apps/Gnome.rst b/Apps/Gnome.rst index 51fc08eac7d38835c5736bf8e607538c1ea3f87e..d08cf9f0880d68c7d9473fdad8250793929058af 100644 --- a/Apps/Gnome.rst +++ b/Apps/Gnome.rst @@ -3,14 +3,7 @@ Developing for GNOME ==================== -Applications (apps) for the Librem 5 will typically be built using the -`GTK+ toolkit`_. In fact many of the apps available will have been ported from -existing apps which are part of the GNOME environment. When you write an app or -port a current app to the Librem 5, you are likely going to use tools and -libraries from the GNOME Desktop Environment, building user interfaces -based on GTK+ using the GObject model. There are many supporting libraries -like libsoup for HTTP access or GSettings for settings management, D-Bus -interaction and lower level I/O. +When you write an app or port a current app to the Librem 5, you are likely going to use tools and libraries from the GNOME Desktop Environment, building user interfaces based on GTK using the GObject model. There are many supporting libraries like libsoup for HTTP access or GSettings for settings management, D-Bus interaction and lower level I/O. See the :ref:`development_environment` chapter of this manual, and especially the :ref:`workstation` section for an overview of the tools that make up @@ -22,7 +15,7 @@ these tools in more detail. GNOME/Flatpak_setup GNOME/GBuilder - GNOME/Gtk+ + GNOME/GTK GNOME/Glade GNOME/Application_Resources GNOME/Settings diff --git a/Apps/Guides/Design/Adaptive_UI/index.rst b/Apps/Guides/Design/Adaptive_UI/index.rst index 71905b1babd3aa87692ee1d07105b2f24f09ecee..a1b5c6e6e9636d14d2953d43eec0251238a884c5 100644 --- a/Apps/Guides/Design/Adaptive_UI/index.rst +++ b/Apps/Guides/Design/Adaptive_UI/index.rst @@ -17,7 +17,7 @@ Introduction This library is central to the way that adaptive applications are created using GTK. The following sections show how each of its components are employed to make new or existing GTK-based user interfaces adaptable. The :ref:`porting_gnome_apps_guide` guide covers more specific issues related to converting traditional applications to fit the adaptive paradigm. -For general GTK+ and GNOME development resources please consult the :ref:`gnome_resources` page and the `GTK+ 3 documentation`_. +For general GTK and GNOME development resources please consult the :ref:`gnome_resources` page and the `GTK 3 documentation`_. Style Guidelines ---------------- diff --git a/Apps/Guides/Porting_GNOME_Applications/index.rst b/Apps/Guides/Porting_GNOME_Applications/index.rst index c51b6986d7ecd58bda164b47cb56a8105f1540cb..e61b2b4c8718322b1b09bf133716d2d320555af9 100644 --- a/Apps/Guides/Porting_GNOME_Applications/index.rst +++ b/Apps/Guides/Porting_GNOME_Applications/index.rst @@ -29,7 +29,7 @@ A typical developer workflow for porting will involve something like this: Hints and Tips -------------- -There are some UI elements in GTK+ that are touch-friendly, and therefore ready to use on a phone, while others are not. +There are some UI elements in GTK that are touch-friendly, and therefore ready to use on a phone, while others are not. A collection of `application mock-ups`_ for GNOME applications should help to give an overview of the presentation and user interface paradigms that developers are using. diff --git a/Apps/Guides/Working_with_UI_Files/index.rst b/Apps/Guides/Working_with_UI_Files/index.rst index 38180c9f28a19e456cd8e7996c1865ae8647f501..4927ae15a20dd0a5f52f728809db552df17a1fa3 100644 --- a/Apps/Guides/Working_with_UI_Files/index.rst +++ b/Apps/Guides/Working_with_UI_Files/index.rst @@ -54,7 +54,7 @@ Note the ``id`` property on the object describing the `Gtk.ApplicationWindow`_ w The ``id`` attribute allows the application code to refer to specific widgets. In this case, the main window of the application can be referred to using the ``window`` identifier. -The ```` element contains information about the libraries that provide the components specified in the UI file. In the example, all the components can be provided by GTK+ version 3.20. +The ```` element contains information about the libraries that provide the components specified in the UI file. In the example, all the components can be provided by GTK version 3.20. Creating UI Files ----------------- diff --git a/Contact/Community.rst b/Contact/Community.rst index 7c4ca1809b1541451e6c3bf3933389b05717e970..c1c836d2023855166a0f5a4d28592fa3a8066384 100644 --- a/Contact/Community.rst +++ b/Contact/Community.rst @@ -59,7 +59,7 @@ Librem 5 specific: ID: !CBfWYXjnVtAdBQWXVI:talk.puri.sm `Libhandy `__ - For discussions regarding the `libhandy `__ GTK+ library |br| + For discussions regarding the `libhandy `__ GTK library |br| ID: !nrNOrVsRZxzaDdspgs:talk.puri.sm `Chatty `__ diff --git a/Development_Environment/Boards/HowTo/SSH_Access.rst b/Development_Environment/Boards/HowTo/SSH_Access.rst index 6d1fd36942792f155440662ce0c4b1dfc42c3d48..680f1cc9ce1f1f3dc20ea552ab525086588c3ba6 100644 --- a/Development_Environment/Boards/HowTo/SSH_Access.rst +++ b/Development_Environment/Boards/HowTo/SSH_Access.rst @@ -38,7 +38,7 @@ The application should appear on the workstation's screen. The GNOME Chess application running on the development board and shown on the workstation's display (click to enlarge) -.. [#] Described in the `Running GTK+ Applications`_ GNOME developer document. +.. [#] Described in the `Running GTK Applications`_ GNOME developer document. Running Phosh in an X Window ---------------------------- diff --git a/Development_Environment/Workstation/GNOME.rst b/Development_Environment/Workstation/GNOME.rst index b939042488358b9ef6a9c7f3309c149482d8389f..743b28337db8f631419eea6ba37373b860f6766b 100644 --- a/Development_Environment/Workstation/GNOME.rst +++ b/Development_Environment/Workstation/GNOME.rst @@ -6,7 +6,7 @@ GNOME The default software stack for the Librem 5 is based on many of the `technologies`_ from the `GNOME`_ desktop environment. The applications supplied with the phone are also built using components from GNOME, such as the -`GTK+ toolkit`_. It can be useful to install the latest development packages in +`GTK toolkit`_. It can be useful to install the latest development packages in order to get access to features which can help with building mobile applications. diff --git a/Software_Reference/Environments/Phosh.rst b/Software_Reference/Environments/Phosh.rst index 39747c81d230777ec1ec94ad4469f283a5152bfd..a7c06f76d396254b7bab304657cde89a91aaebda 100644 --- a/Software_Reference/Environments/Phosh.rst +++ b/Software_Reference/Environments/Phosh.rst @@ -4,7 +4,7 @@ Phosh ===== -The Phone's shell Phosh is based on GNOME_ technologies (GTK+, GSettings, DBus) +The Phone's shell Phosh is based on GNOME_ technologies (GTK, GSettings, DBus) and uses a custom Wayland compositor. .. image:: Phosh/images/phosh.jpg diff --git a/links.txt b/links.txt index ca469fe5aed11b4022b2674fbb5693683e1ac557..63c1319aa1752dc85c82d9e28477f8eb1d37ebd1 100644 --- a/links.txt +++ b/links.txt @@ -47,7 +47,7 @@ .. _`g_set_application_name`: https://developer.gnome.org/glib/stable/glib-Miscellaneous-Utility-Functions.html#g-set-application-name .. _`GSimpleAction`: https://developer.gnome.org/gio/2.60/GSimpleAction.html .. _`GSettings`: https://developer.gnome.org/gio/stable/GSettings.html -.. _`GTK+ 3 documentation`: https://developer.gnome.org/gtk3/stable/ +.. _`GTK 3 documentation`: https://developer.gnome.org/gtk3/stable/ .. _GtkApplication: https://developer.gnome.org/gtk3/stable/GtkApplication.html .. _`Gtk.Application`: https://lazka.github.io/pgi-docs/#Gtk-3.0/classes/Application.html .. _`GtkApplicationWindow`: https://developer.gnome.org/gtk3/stable/GtkApplicationWindow.html @@ -58,14 +58,14 @@ .. _`Gtk.Builder`: https://lazka.github.io/pgi-docs/#Gtk-3.0/classes/Builder.html .. _GtkButton : https://developer.gnome.org/gtk3/stable/GtkButton.html .. _`Gtk.CssProvider`: https://lazka.github.io/pgi-docs/#Gtk-3.0/classes/CssProvider.html -.. _`GTK+ CSS Overview`: https://developer.gnome.org/gtk3/stable/chap-css-overview.html -.. _`GTK+ CSS Properties`: https://developer.gnome.org/gtk3/stable/chap-css-properties.html +.. _`GTK CSS Overview`: https://developer.gnome.org/gtk3/stable/chap-css-overview.html +.. _`GTK CSS Properties`: https://developer.gnome.org/gtk3/stable/chap-css-properties.html .. _`Gtk.Dialog`: https://lazka.github.io/pgi-docs/#Gtk-3.0/classes/Dialog.html .. _GtkGrid: https://developer.gnome.org/gtk3/stable/GtkGrid.html .. _GtkHeaderBar : https://developer.gnome.org/gtk3/stable/GtkHeaderBar.html .. _`Gtk.IconView`: https://lazka.github.io/pgi-docs/#Gtk-3.0/classes/IconView.html .. _`Gtk.Image`: https://lazka.github.io/pgi-docs/#Gtk-3.0/classes/Image.html -.. _`GTK+ Inspector`: https://wiki.gnome.org/Projects/GTK+/Inspector +.. _`GTK Inspector`: https://wiki.gnome.org/Projects/GTK+/Inspector .. _GtkLabel ellipsize property : https://developer.gnome.org/gtk3/stable/GtkLabel.html#GtkLabel--ellipsize .. _GtkLabel: https://developer.gnome.org/gtk3/stable/GtkLabel.html .. _`Gtk.Label`: https://lazka.github.io/pgi-docs/#Gtk-3.0/classes/Label.html @@ -85,8 +85,8 @@ .. _Gtk.TreeIter : https://lazka.github.io/pgi-docs/#Gtk-3.0/classes/TreeIter.html .. _Gtk.TreePath : https://lazka.github.io/pgi-docs/#Gtk-3.0/classes/TreePath.html .. _Gtk.TreeView : https://lazka.github.io/pgi-docs/#Gtk-3.0/classes/TreeView.html -.. _`GTK+ toolkit`: https://www.gtk.org -.. _`GTK+ website`: https://www.gtk.org/ +.. _`GTK toolkit`: https://www.gtk.org +.. _`GTK website`: https://www.gtk.org/ .. _`Gtk.Widget.get_style_context`: https://lazka.github.io/pgi-docs/#Gtk-3.0/classes/Widget.html#Gtk.Widget.get_style_context .. _`Gtk.Window.set_transient_for`: https://lazka.github.io/pgi-docs/#Gtk-3.0/classes/Window.html#Gtk.Window.set_transient_for .. _`Handy.Dialog`: https://lazka.github.io/pgi-docs/#Handy-0.0/classes/Dialog.html @@ -129,7 +129,7 @@ .. _`python-evdev`: https://python-evdev.readthedocs.io/en/latest/usage.html .. _`python-evdev tutorial`: https://python-evdev.readthedocs.io/en/latest/tutorial.html .. _`Python gettext module`: https://docs.python.org/3/library/gettext.html -.. _`Python GTK+ 3 Tutorial`: https://python-gtk-3-tutorial.readthedocs.io +.. _`Python GTK 3 Tutorial`: https://python-gtk-3-tutorial.readthedocs.io .. _`Python locale module`: https://docs.python.org/3/library/locale.html .. _`python-periphery`: https://python-periphery.readthedocs.io/en/latest/ .. _`qemu`: https://www.qemu.org @@ -138,7 +138,7 @@ .. _`Qt documentation`: https://doc.qt.io/qt-5 .. _`Qt Quick`: https://doc.qt.io/qt-5/qtquick-index.html .. _`Qt Quick Controls 2`: https://doc.qt.io/qt-5/qtquickcontrols2-index.html -.. _`Running GTK+ Applications`: https://developer.gnome.org/gtk3/stable/gtk-running.html +.. _`Running GTK Applications`: https://developer.gnome.org/gtk3/stable/gtk-running.html .. _`Sandbox Permissions`: http://docs.flatpak.org/en/latest/sandbox-permissions-reference.html .. _`Scalable Vector Graphics`: https://www.w3.org/TR/SVG/ .. _`Sidebar lists`: https://developer.gnome.org/hig/stable/sidebar-lists.html.en