From fa0b0e258aff23dded18aa3705791299a63d7b9a Mon Sep 17 00:00:00 2001
From: Mat <mail@mathias.is>
Date: Thu, 1 Dec 2022 23:59:27 +0200
Subject: Update docs and code examples to GTK 4

---
 docs/getting_started.rst | 45 +++++++++++++++++++++++++++++----------------
 1 file changed, 29 insertions(+), 16 deletions(-)

(limited to 'docs/getting_started.rst')

diff --git a/docs/getting_started.rst b/docs/getting_started.rst
index e6921af8..01874efa 100644
--- a/docs/getting_started.rst
+++ b/docs/getting_started.rst
@@ -13,14 +13,27 @@ the following content and save it somewhere:
 
 .. code:: python
 
+    import sys
+
     import gi
-    gi.require_version("Gtk", "3.0")
-    from gi.repository import Gtk
 
-    window = Gtk.Window(title="Hello World")
-    window.show()
-    window.connect("destroy", Gtk.main_quit)
-    Gtk.main()
+    gi.require_version("Gtk", "4.0")
+    from gi.repository import GLib, Gtk
+
+
+    class MyApplication(Gtk.Application):
+        def __init__(self):
+            super().__init__(application_id="com.example.MyGtkApplication")
+            GLib.set_application_name('My Gtk Application')
+
+        def do_activate(self):
+            window = Gtk.ApplicationWindow(application=self, title="Hello World")
+            window.present()
+
+
+    app = MyApplication()
+    exit_status = app.run(sys.argv)
+    sys.exit(exit_status)
 
 Before we can run the example application we need to install PyGObject, GTK
 and their dependencies. Follow the instructions for your platform below.
@@ -45,8 +58,8 @@ libraries. There are also typing stubs available here `PyGObject-stubs <https://
 #) Follow the instructions on the page for setting up the basic environment
 #) Run ``C:\msys64\mingw64.exe`` - a terminal window should pop up
 #) Execute ``pacman -Suy``
-#) Execute ``pacman -S mingw-w64-x86_64-gtk3 mingw-w64-x86_64-python3 mingw-w64-x86_64-python3-gobject``
-#) To test that GTK 3 is working you can run ``gtk3-demo``
+#) Execute ``pacman -S mingw-w64-x86_64-gtk4 mingw-w64-x86_64-python3 mingw-w64-x86_64-python3-gobject``
+#) To test that GTK is working you can run ``gtk4-demo``
 #) Copy the ``hello.py`` script you created to ``C:\msys64\home\<username>``
 #) In the mingw32 terminal execute ``python3 hello.py`` - a window should appear.
 
@@ -61,13 +74,13 @@ libraries. There are also typing stubs available here `PyGObject-stubs <https://
 
 Installing the system provided PyGObject:
   #) Open a terminal
-  #) Execute ``sudo apt install python3-gi python3-gi-cairo gir1.2-gtk-3.0``
+  #) Execute ``sudo apt install python3-gi python3-gi-cairo gir1.2-gtk-4.0``
   #) Change the directory to where your ``hello.py`` script can be found (e.g. ``cd Desktop``)
   #) Run ``python3 hello.py``
 
 Installing from PyPI with pip:
   #) Open a terminal and enter your virtual environment
-  #) Execute ``sudo apt install libgirepository1.0-dev gcc libcairo2-dev pkg-config python3-dev gir1.2-gtk-3.0``
+  #) Execute ``sudo apt install libgirepository1.0-dev gcc libcairo2-dev pkg-config python3-dev gir1.2-gtk-4.0``
      to install the build dependencies and GTK
   #) Execute ``pip3 install pycairo`` to build and install Pycairo
   #) Execute ``pip3 install PyGObject`` to build and install PyGObject
@@ -85,13 +98,13 @@ Installing from PyPI with pip:
 
 Installing the system provided PyGObject:
   #) Open a terminal
-  #) Execute ``sudo dnf install python3-gobject gtk3``
+  #) Execute ``sudo dnf install python3-gobject gtk4``
   #) Change the working directory to where your ``hello.py`` script can be found
   #) Run ``python3 hello.py``
 
 Installing from PyPI with pip:
   #) Open a terminal and enter your virtual environment
-  #) Execute ``sudo dnf install gcc gobject-introspection-devel cairo-gobject-devel pkg-config python3-devel gtk3``
+  #) Execute ``sudo dnf install gcc gobject-introspection-devel cairo-gobject-devel pkg-config python3-devel gtk4``
      to install the build dependencies and GTK
   #) Execute ``pip3 install pycairo`` to build and install Pycairo
   #) Execute ``pip3 install PyGObject`` to build and install PyGObject
@@ -106,13 +119,13 @@ Installing from PyPI with pip:
 
 Installing the system provided PyGObject:
   #) Open a terminal
-  #) Execute ``sudo pacman -S python-gobject gtk3``
+  #) Execute ``sudo pacman -S python-gobject gtk4``
   #) Change the working directory to where your ``hello.py`` script can be found
   #) Run ``python3 hello.py``
 
 Installing from PyPI with pip:
   #) Open a terminal and enter your virtual environment
-  #) Execute ``sudo pacman -S python cairo pkgconf gobject-introspection gtk3``
+  #) Execute ``sudo pacman -S python cairo pkgconf gobject-introspection gtk4``
      to install the build dependencies and GTK
   #) Execute ``pip3 install pycairo`` to build and install Pycairo
   #) Execute ``pip3 install PyGObject`` to build and install PyGObject
@@ -127,7 +140,7 @@ Installing from PyPI with pip:
 
 Installing the system provided PyGObject:
   #) Open a terminal
-  #) Execute ``sudo zypper install python3-gobject python3-gobject-Gdk typelib-1_0-Gtk-3_0 libgtk-3-0``
+  #) Execute ``sudo zypper install python3-gobject python3-gobject-Gdk typelib-1_0-Gtk-4_0 libgtk-4-1``
   #) Change the directory to where your ``hello.py`` script can be found
   #) Run ``python3 hello.py``
 
@@ -148,7 +161,7 @@ Installing from PyPI with pip:
 
 #) Go to https://brew.sh/ and install homebrew
 #) Open a terminal
-#) Execute ``brew install pygobject3 gtk+3``
+#) Execute ``brew install pygobject3 gtk4``
 #) Change the working directory to where your ``hello.py`` script can be found
 #) Run ``python3 hello.py``
 
-- 
cgit v1.2.1