electronstudio
diff --git a/‎README.md
Lines changed: 12 additions & 8 deletions b/‎README.md
Lines changed: 12 additions & 8 deletions
diff --git a/‎docs-src/pyray.rst
Lines changed: 0 additions & 1 deletion b/‎docs-src/pyray.rst
Lines changed: 0 additions & 1 deletion
diff --git a/‎docs/BUILDING.html
Lines changed: 1 addition & 1 deletion b/‎docs/BUILDING.html
Lines changed: 1 addition & 1 deletion
diff --git a/‎docs/README.html
Lines changed: 24 additions & 14 deletions b/‎docs/README.html
Lines changed: 24 additions & 14 deletions
diff --git a/‎docs/_sources/BUILDING.rst.txt
Lines changed: 1 addition & 1 deletion b/‎docs/_sources/BUILDING.rst.txt
Lines changed: 1 addition & 1 deletion
diff --git a/‎docs/_sources/README.md.txt
Lines changed: 20 additions & 11 deletions b/‎docs/_sources/README.md.txt
Lines changed: 20 additions & 11 deletions
diff --git a/‎docs/_sources/pyray.rst.txt
Lines changed: 0 additions & 1 deletion b/‎docs/_sources/pyray.rst.txt
Lines changed: 0 additions & 1 deletion
@@ -2,7 +2,7 @@
 ## Libraries: raymath, raygui, rlgl, physac and GLFW
 ## Backends: Desktop, SDL, DRM, Web
 
-Chatroom: [Discord](https://discord.gg/fKDwt85aX6) or [Matrix](https://matrix.to/#/#raylib-python-cffi:matrix.org)
+Chatroom: [Discord](https://discord.gg/fKDwt85aX6)
 
 New CFFI API static bindings.
 * Automatically generated to be as close as possible to 
@@ -39,7 +39,8 @@ Then install
     python3 -m pip install setuptools
     python3 -m pip install raylib==5.0.0.4
 
-On most platforms it should install a binary wheel.  If yours isn't available then pip will attempt to build from source, in which case you will need to have Raylib development libs installed, e.g. 
+On most platforms it should install a binary wheel.  If yours isn't available then pip will attempt to build from
+source, in which case you will need to have Raylib development libs installed, e.g. 
 using homebrew, apt, etc.
 
 ## Windows
@@ -68,7 +69,7 @@ if you want to test them.)
 Binaries require OS newer than Ubuntu 2020, x64 or arm64.   Otherwise build from source.
 (Pip should attempt automatically but will need Raylib itself installed and also pkg-config.)
 
-The arm64 builds are built on Raspberry Pi arm64 Bullseye
+The arm64 binaries are built on Raspberry Pi arm64 Bullseye with OpenGL 2.0
 so may not work on other boards.
 
 ## Raspberry Pi
@@ -79,6 +80,7 @@ so may not work on other boards.
 
 There is now a separate dynamic version of this binding:
 
+    python3 -m pip uninstall raylib
     python3 -m pip install raylib_dynamic
 
 It works on some systems where the static version doesn't, [but be sure to read these caveats before using it](https://electronstudio.github.io/raylib-python-cffi/dynamic.html)
@@ -106,22 +108,24 @@ You can't have multiple raylib packages installed at once.
 If it doesn't work, [try to build manually.](BUILDING.rst).  If that works then [submit an issue](https://github.com/electronstudio/raylib-python-cffi/issues)
 to let us know what you did.
 
-If you need help you can try asking [on Discord](https://discord.gg/raylib).
+If you need help you can try asking on [our discord](https://discord.gg/fKDwt85aX6).  There is also a large [Raylib discord](https://discord.gg/raylib)
+for issues that are not Python-specific.
 
 If it still doesn't work, [submit an issue](https://github.com/electronstudio/raylib-python-cffi/issues).
 
 
 # How to use
 
-There are two APIs, you can use either or both:
+There are two modules in the raylib package, `raylib` and `pyray`. (There is no separate package for
+pyray).  You can use either or both:
 
 ### If you are familiar with C coding and the Raylib C library and you want to use an exact copy of the C API
 
-Use [the C API](https://electronstudio.github.io/raylib-python-cffi/raylib.html).
+Use [the raylib module](https://electronstudio.github.io/raylib-python-cffi/raylib.html).
 
-### If you prefer a slightly more Pythonistic API and don't mind it might be slightly slower
+### If you prefer a  more Pythonistic API
 
-Use [the Python API](https://electronstudio.github.io/raylib-python-cffi/pyray.html).
+Use [the pyray module](https://electronstudio.github.io/raylib-python-cffi/pyray.html).
 
 # Running in a web browser
 
 
@@ -56,7 +56,6 @@ Example program:
         init_window(800, 450, "Raylib texture test")
         ...
 
-    (You don't need to use the PyRay() class anymore.)
 
 `See all examples here <https://github.com/electronstudio/raylib-python-cffi/tree/master/examples>`_
 
 
@@ -127,7 +127,7 @@ <h2>Or, Build from source manually<a class="headerlink" href="#or-build-from-sou
 <p>If the Pip build doesn’t work, please submit a bug. (And if you have
 fixed it, a PR.)</p>
 </div>
-<p>Manual instructions follow, but may be outdated, so see also how we actually build the wheels
+<p>Manual instructions follow, but are probably outdated, so see instead how we actually build the wheels
 at <a class="reference external" href="https://github.com/electronstudio/raylib-python-cffi/blob/master/.github/workflows/build.yml">https://github.com/electronstudio/raylib-python-cffi/blob/master/.github/workflows/build.yml</a></p>
 <section id="windows-manual-build">
 <h3>Windows manual build<a class="headerlink" href="#windows-manual-build" title="Link to this heading"></a></h3>
 
@@ -64,7 +64,7 @@
 </li>
 <li class="toctree-l1"><a class="reference internal" href="#how-to-use">How to use</a><ul>
 <li class="toctree-l2"><a class="reference internal" href="#if-you-are-familiar-with-c-coding-and-the-raylib-c-library-and-you-want-to-use-an-exact-copy-of-the-c-api">If you are familiar with C coding and the Raylib C library and you want to use an exact copy of the C API</a></li>
-<li class="toctree-l2"><a class="reference internal" href="#if-you-prefer-a-slightly-more-pythonistic-api-and-don-t-mind-it-might-be-slightly-slower">If you prefer a slightly more Pythonistic API and don’t mind it might be slightly slower</a></li>
+<li class="toctree-l2"><a class="reference internal" href="#if-you-prefer-a-more-pythonistic-api">If you prefer a  more Pythonistic API</a></li>
 </ul>
 </li>
 <li class="toctree-l1"><a class="reference internal" href="#running-in-a-web-browser">Running in a web browser</a></li>
@@ -116,7 +116,7 @@ <h2>Libraries: raymath, raygui, rlgl, physac and GLFW<a class="headerlink" href=
 </section>
 <section id="backends-desktop-sdl-drm-web">
 <h2>Backends: Desktop, SDL, DRM, Web<a class="headerlink" href="#backends-desktop-sdl-drm-web" title="Link to this heading"></a></h2>
-<p>Chatroom: <a class="reference external" href="https://discord.gg/fKDwt85aX6">Discord</a> or <a class="reference external" href="https://matrix.to/#/#raylib-python-cffi:matrix.org">Matrix</a></p>
+<p>Chatroom: <a class="reference external" href="https://discord.gg/fKDwt85aX6">Discord</a></p>
 <p>New CFFI API static bindings.</p>
 <ul class="simple">
 <li><p>Automatically generated to be as close as possible to
@@ -153,7 +153,8 @@ <h1>Installation<a class="headerlink" href="#installation" title="Link to this h
 python3 -m pip install raylib==5.0.0.4
 </pre></div>
 </div>
-<p>On most platforms it should install a binary wheel.  If yours isn’t available then pip will attempt to build from source, in which case you will need to have Raylib development libs installed, e.g.
+<p>On most platforms it should install a binary wheel.  If yours isn’t available then pip will attempt to build from
+source, in which case you will need to have Raylib development libs installed, e.g.
 using homebrew, apt, etc.</p>
 <section id="windows">
 <h2>Windows<a class="headerlink" href="#windows" title="Link to this heading"></a></h2>
@@ -162,19 +163,25 @@ <h2>Windows<a class="headerlink" href="#windows" title="Link to this heading">
 </section>
 <section id="macos">
 <h2>MacOS<a class="headerlink" href="#macos" title="Link to this heading"></a></h2>
-<p>Binaries require arm64 MacOS 13 or x64 MacOS 12 or newer.</p>
+<p>Binaries require:</p>
+<ul class="simple">
+<li><p>arm64 MacOS 14</p></li>
+<li><p>x64 MacOS 10.13, or newer.</p></li>
+</ul>
 <p>Older MacOS requires building from source but this is usually simple:</p>
 <div class="highlight-none notranslate"><div class="highlight"><pre><span></span>brew install pkg-config
 brew install raylib
 python3 -m pip install raylib==5.0.0.4
 </pre></div>
 </div>
+<p>(I do have binaries for arm64 MacOS 11, 12 and 13 but I have no way of testing they work, so post an issue
+if you want to test them.)</p>
 </section>
 <section id="linux">
 <h2>Linux<a class="headerlink" href="#linux" title="Link to this heading"></a></h2>
 <p>Binaries require OS newer than Ubuntu 2020, x64 or arm64.   Otherwise build from source.
 (Pip should attempt automatically but will need Raylib itself installed and also pkg-config.)</p>
-<p>The arm64 builds are built on Raspberry Pi arm64 Bullseye
+<p>The arm64 binaries are built on Raspberry Pi arm64 Bullseye with OpenGL 2.0
 so may not work on other boards.</p>
 </section>
 <section id="raspberry-pi">
@@ -184,7 +191,8 @@ <h2>Raspberry Pi<a class="headerlink" href="#raspberry-pi" title="Link to this h
 <section id="dynamic-binding-version">
 <h2>Dynamic binding version<a class="headerlink" href="#dynamic-binding-version" title="Link to this heading"></a></h2>
 <p>There is now a separate dynamic version of this binding:</p>
-<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>python3 -m pip install raylib_dynamic
+<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>python3 -m pip uninstall raylib
+python3 -m pip install raylib_dynamic
 </pre></div>
 </div>
 <p>It works on some systems where the static version doesn’t, <a class="reference external" href="https://electronstudio.github.io/raylib-python-cffi/dynamic.html">but be sure to read these caveats before using it</a></p>
@@ -196,7 +204,7 @@ <h2>SDL backend<a class="headerlink" href="#sdl-backend" title="Link to this hea
 python3 -m pip install raylib_sdl
 </pre></div>
 </div>
-<p>You can’t have multiple backends installed at once.</p>
+<p>You can’t have multiple raylib packages installed at once.</p>
 </section>
 <section id="drm-backend">
 <h2>DRM backend<a class="headerlink" href="#drm-backend" title="Link to this heading"></a></h2>
@@ -205,26 +213,28 @@ <h2>DRM backend<a class="headerlink" href="#drm-backend" title="Link to this hea
 python3 -m pip install raylib_drm
 </pre></div>
 </div>
-<p>You can’t have multiple backends installed at once.</p>
+<p>You can’t have multiple raylib packages installed at once.</p>
 </section>
 <section id="problems">
 <h2>Problems?<a class="headerlink" href="#problems" title="Link to this heading"></a></h2>
 <p>If it doesn’t work, <a class="reference internal" href="BUILDING.html"><span class="std std-doc">try to build manually.</span></a>.  If that works then <a class="reference external" href="https://github.com/electronstudio/raylib-python-cffi/issues">submit an issue</a>
 to let us know what you did.</p>
-<p>If you need help you can try asking <a class="reference external" href="https://discord.gg/raylib">on Discord</a>.</p>
+<p>If you need help you can try asking on <a class="reference external" href="https://discord.gg/fKDwt85aX6">our discord</a>.  There is also a large <a class="reference external" href="https://discord.gg/raylib">Raylib discord</a>
+for issues that are not Python-specific.</p>
 <p>If it still doesn’t work, <a class="reference external" href="https://github.com/electronstudio/raylib-python-cffi/issues">submit an issue</a>.</p>
 </section>
 </section>
 <section id="how-to-use">
 <h1>How to use<a class="headerlink" href="#how-to-use" title="Link to this heading"></a></h1>
-<p>There are two APIs, you can use either or both:</p>
+<p>There are two modules in the raylib package, <code class="docutils literal notranslate"><span class="pre">raylib</span></code> and <code class="docutils literal notranslate"><span class="pre">pyray</span></code>. (There is no separate package for
+pyray).  You can use either or both:</p>
 <section id="if-you-are-familiar-with-c-coding-and-the-raylib-c-library-and-you-want-to-use-an-exact-copy-of-the-c-api">
 <h2>If you are familiar with C coding and the Raylib C library and you want to use an exact copy of the C API<a class="headerlink" href="#if-you-are-familiar-with-c-coding-and-the-raylib-c-library-and-you-want-to-use-an-exact-copy-of-the-c-api" title="Link to this heading"></a></h2>
-<p>Use <a class="reference external" href="https://electronstudio.github.io/raylib-python-cffi/raylib.html">the C API</a>.</p>
+<p>Use <a class="reference external" href="https://electronstudio.github.io/raylib-python-cffi/raylib.html">the raylib module</a>.</p>
 </section>
-<section id="if-you-prefer-a-slightly-more-pythonistic-api-and-don-t-mind-it-might-be-slightly-slower">
-<h2>If you prefer a slightly more Pythonistic API and don’t mind it might be slightly slower<a class="headerlink" href="#if-you-prefer-a-slightly-more-pythonistic-api-and-don-t-mind-it-might-be-slightly-slower" title="Link to this heading"></a></h2>
-<p>Use <a class="reference external" href="https://electronstudio.github.io/raylib-python-cffi/pyray.html">the Python API</a>.</p>
+<section id="if-you-prefer-a-more-pythonistic-api">
+<h2>If you prefer a  more Pythonistic API<a class="headerlink" href="#if-you-prefer-a-more-pythonistic-api" title="Link to this heading"></a></h2>
+<p>Use <a class="reference external" href="https://electronstudio.github.io/raylib-python-cffi/pyray.html">the pyray module</a>.</p>
 </section>
 </section>
 <section id="running-in-a-web-browser">
 
@@ -38,7 +38,7 @@ project.
    If the Pip build doesn’t work, please submit a bug. (And if you have
    fixed it, a PR.)
 
-Manual instructions follow, but may be outdated, so see also how we actually build the wheels
+Manual instructions follow, but are probably outdated, so see instead how we actually build the wheels
 at https://github.com/electronstudio/raylib-python-cffi/blob/master/.github/workflows/build.yml
 
 Windows manual build
 
@@ -2,7 +2,7 @@
 ## Libraries: raymath, raygui, rlgl, physac and GLFW
 ## Backends: Desktop, SDL, DRM, Web
 
-Chatroom: [Discord](https://discord.gg/fKDwt85aX6) or [Matrix](https://matrix.to/#/#raylib-python-cffi:matrix.org)
+Chatroom: [Discord](https://discord.gg/fKDwt85aX6)
 
 New CFFI API static bindings.
 * Automatically generated to be as close as possible to 
@@ -39,7 +39,8 @@ Then install
     python3 -m pip install setuptools
     python3 -m pip install raylib==5.0.0.4
 
-On most platforms it should install a binary wheel.  If yours isn't available then pip will attempt to build from source, in which case you will need to have Raylib development libs installed, e.g. 
+On most platforms it should install a binary wheel.  If yours isn't available then pip will attempt to build from
+source, in which case you will need to have Raylib development libs installed, e.g. 
 using homebrew, apt, etc.
 
 ## Windows
@@ -50,20 +51,25 @@ Use an [official Windows Python release](https://www.python.org/downloads/window
 
 ## MacOS
 
-Binaries require arm64 MacOS 13 or x64 MacOS 12 or newer.
+Binaries require:
+ * arm64 MacOS 14
+ * x64 MacOS 10.13, or newer.
 
 Older MacOS requires building from source but this is usually simple:
 
     brew install pkg-config
     brew install raylib
     python3 -m pip install raylib==5.0.0.4
 
+(I do have binaries for arm64 MacOS 11, 12 and 13 but I have no way of testing they work, so post an issue
+if you want to test them.)
+
 ## Linux
 
 Binaries require OS newer than Ubuntu 2020, x64 or arm64.   Otherwise build from source.
 (Pip should attempt automatically but will need Raylib itself installed and also pkg-config.)
 
-The arm64 builds are built on Raspberry Pi arm64 Bullseye
+The arm64 binaries are built on Raspberry Pi arm64 Bullseye with OpenGL 2.0
 so may not work on other boards.
 
 ## Raspberry Pi
@@ -74,6 +80,7 @@ so may not work on other boards.
 
 There is now a separate dynamic version of this binding:
 
+    python3 -m pip uninstall raylib
     python3 -m pip install raylib_dynamic
 
 It works on some systems where the static version doesn't, [but be sure to read these caveats before using it](https://electronstudio.github.io/raylib-python-cffi/dynamic.html)
@@ -85,7 +92,7 @@ This is not well tested but has better support for controllers:
     python3 -m pip uninstall raylib
     python3 -m pip install raylib_sdl
 
-You can't have multiple backends installed at once.
+You can't have multiple raylib packages installed at once.
 
 ## DRM backend
 
@@ -94,29 +101,31 @@ This uses the Linux framebuffer for devices that don't run X11/Wayland:
     python3 -m pip uninstall raylib
     python3 -m pip install raylib_drm
 
-You can't have multiple backends installed at once.
+You can't have multiple raylib packages installed at once.
 
 ## Problems?
 
 If it doesn't work, [try to build manually.](BUILDING.rst).  If that works then [submit an issue](https://github.com/electronstudio/raylib-python-cffi/issues)
 to let us know what you did.
 
-If you need help you can try asking [on Discord](https://discord.gg/raylib).
+If you need help you can try asking on [our discord](https://discord.gg/fKDwt85aX6).  There is also a large [Raylib discord](https://discord.gg/raylib)
+for issues that are not Python-specific.
 
 If it still doesn't work, [submit an issue](https://github.com/electronstudio/raylib-python-cffi/issues).
 
 
 # How to use
 
-There are two APIs, you can use either or both:
+There are two modules in the raylib package, `raylib` and `pyray`. (There is no separate package for
+pyray).  You can use either or both:
 
 ### If you are familiar with C coding and the Raylib C library and you want to use an exact copy of the C API
 
-Use [the C API](https://electronstudio.github.io/raylib-python-cffi/raylib.html).
+Use [the raylib module](https://electronstudio.github.io/raylib-python-cffi/raylib.html).
 
-### If you prefer a slightly more Pythonistic API and don't mind it might be slightly slower
+### If you prefer a  more Pythonistic API
 
-Use [the Python API](https://electronstudio.github.io/raylib-python-cffi/pyray.html).
+Use [the pyray module](https://electronstudio.github.io/raylib-python-cffi/pyray.html).
 
 # Running in a web browser
 
 
@@ -56,7 +56,6 @@ Example program:
         init_window(800, 450, "Raylib texture test")
         ...
 
-    (You don't need to use the PyRay() class anymore.)
 
 `See all examples here <https://github.com/electronstudio/raylib-python-cffi/tree/master/examples>`_