3 files changed, 117 insertions, 16 deletions
diff --git a/user/hosts/macos.rst b/user/hosts/macos.rst
index 78cef88..75ac5a3 100644
--- a/user/hosts/macos.rst
+++ b/user/hosts/macos.rst
@@ -7,18 +7,105 @@
 Apple macOS
 ===========
 
-Apple's macOS is fully supported. You need to download and install a recent
-version of the Apple developer application Xcode. Xocde is available in the App
-Store. Make sure you install the Command Line Tools add on available for
-download within Xcode and once installed open a Terminal shell and enter the
-command ``cc`` and accept the license agreement.
+Apple's macOS is supported. You need to download and install a recent
+version of the Apple developer application Xcode. Xcode is available
+in the App Store. Make sure you install the Command Line Tools add on
+available for download within Xcode and once installed open a Terminal
+shell and enter the command ``cc`` and accept the license agreement.
 
-The normal prefix when working on macOS as a user is under your home directory.
-Prefixes of :file:`$HOME/development/rtems` or :file:`$HOME/rtems` are
-suitable.
+The normal prefix when working on macOS as a user is under your home
+directory.  Prefixes of :file:`$HOME/development/rtems` or
+:file:`$HOME/rtems` are suitable.
 
 :ref:`QuickStartPrefixes` details using Prefixes to manage the installation.
 
+Homebrew and Macports should work but are not tested by the project as
+they are rolling releases making it difficult to reproduce any
+problems there may be. We recommend reaching out to those projects for
+support.
+
+Intel and Apple silicon is supported.
+
+Python
+~~~~~~
+
+Building GDB requires the installation of Python's development
+libraries. Building GDB includes the Python runtime header
+``Python.h`` and linking to the Python runtime libraries. The RSB
+detects a valid header and libraries before starting a GDB
+build.
+
+It is recommended you run the RSB in a Python virtual environment. A
+virtual environment manages paths for you, provides a ``python``
+executable mapped to the version the virtual environment is built with
+and a command to find the appropiate runtime header and library files
+GDB needs. Virtual environments make it easier to update Python to a
+newer version if this is needed.
+
+Apple has removed support for Python's development libraries from
+recent versions of MacOS as users can manage Python using the
+installer packages provided by the Python project.
+
+To install:
+
+#. Download a Python installer for MacOS from https://www.python.org/.
+
+#. Run the installer and install Python.
+
+#. Open a terminal and update your shell profile using the command
+   Python provides. For Python 3.12 the command is:
+
+   .. code-block:: shell
+
+      /Applications/Python\ 3.12/Update\ Shell\ Profile.command
+
+   Check with:
+
+   .. code-block:: shell
+
+      % type python3.12
+      python3.12 is /Library/Frameworks/Python.framework/Versions/3.12/bin/python3.12
+
+#. Create a virtual environment:
+
+   .. code-block:: shell
+
+      mkdir $HOME/development/rtems
+      cd $HOME/development/rtems
+      python3.12 -m venv py3.12
+
+   Activate the virtual environment:
+
+   .. code-block:: shell
+
+      . $HOME/development/rtems/py3.12/bin/activate
+
+   You are now ready to the build the tools within the virtual
+   environment.
+
+.. _Sonoma:
+
+Sonoma
+~~~~~~
+
+The RSB is supported on Sonoma and Applie silicon.
+
+.. _Ventura:
+
+Ventura
+~~~~~~~
+
+The RSB is supported on Ventura and Intel silicon.
+
+.. _Monterey:
+
+Monterey
+~~~~~~~~
+
+The RSB is supported on Ventura and Intel silicon.
+
+.. _Catalina:
+
 Catalina
 ~~~~~~~~
 
@@ -30,6 +117,8 @@ also
 Due to the deprecated Python 2.7 support, we recommend to install and use the
 `latest Python 3 release from python.org <https://www.python.org/downloads/mac-osx/>`_.
 
+.. _Sierra:
+
 Sierra
 ~~~~~~
 
diff --git a/user/hosts/posix.rst b/user/hosts/posix.rst
index 9769e07..d79e183 100644
--- a/user/hosts/posix.rst
+++ b/user/hosts/posix.rst
@@ -137,16 +137,16 @@ prefix under your home directory as recommended and end up on the SD card.
 Ubuntu
 ~~~~~~
 
-The latest version is Ubuntu 20.04.3 LTS 64-bit. This section also includes
+The latest version is Ubuntu 22.04 LTS 64-bit. This section also includes
 Xubuntu. A minimal installation was used and the following packages installed:
 
 .. code-block:: none
 
-  $ sudo apt-get build-dep build-essential gcc-defaults g++ gdb unzip \
-  pax bison flex texinfo python3-dev libpython2-dev libncurses5-dev \
-  zlib1g-dev
+  $ sudo apt install build-essential g++ gdb unzip pax bison flex texinfo \
+  python3-dev python-is-python3 libpython2-dev libncurses5-dev zlib1g-dev \
+  ninja-build pkg-config
 
-Note that in previous versions of Ubuntu, the package libpython2-dev was
+Note that in older versions of Ubuntu, the package libpython2-dev was
 python2.7-dev. The name of packages changes over time. You need the
 package with Python development libraries for C/C++ programs. The following
 is needed for recent versions:
@@ -179,8 +179,19 @@ than the usual zlib-dev):
 openSUSE
 ~~~~~~~~
 
-This has been reported to work but no instructions were provided. This is an
-opportunity to contribute. Please submit any guidance you can provide.
+The RTEMS Source Builder has been tested on openSUSE Leap 15.4 64bit.
+Starting with a clean install with source repositories enabled, the following
+zypper command installs the required packages:
+
+.. code-block:: none
+
+   # sudo zypper in -t pattern devel_C_C++ devel_python3
+
+In addition, the following command can set python3 as the default python interpreter:
+
+.. code-block:: none
+
+   # sudo update-alternatives --install /usr/bin/python python /usr/bin/python3 1
 
 .. _FreeBSD:
 
diff --git a/user/hosts/windows.rst b/user/hosts/windows.rst
index fac1366..fd7ff55 100644
--- a/user/hosts/windows.rst
+++ b/user/hosts/windows.rst
@@ -156,6 +156,7 @@ The packages we require are:
 * python
 * mingw-w64-x86_64-python2
 * mingw-w64-x86_64-gcc
+* flex
 * git
 * bison
 * cvs
@@ -176,7 +177,7 @@ Install the packages using ``pacman``:
 .. code-block:: none
 
   $ pacman -S python mingw-w64-x86_64-python2 mingw-w64-x86_64-gcc \
-  bison cvs diffutils git make patch tar texinfo unzip
+  bison flex cvs diffutils git make patch tar texinfo unzip
   resolving dependencies...
   looking for conflicting packages...
       .... output shortened for brevity ....