improve docs, make clear different APIs and static/dynamic

Author: electronstudio

BUILDING.rst

@@ -59,8 +59,7 @@ Build and install Raylib from the raylib-c directory.
 
 To update the dynamic libs, download the official release,
 e.g. https://github.com/raysan5/raylib/releases/download/3.7.0/raylib-3.7.0_win64_msvc16.zip
-and extract ``raylib.dll`` into ``raylib/dynamic``. Delete the files for
-other platforms, unless you want them in your distribution.
+and extract ``raylib.dll`` into ``dynamic/raylib``.
 
 To build a binary wheel distribution:
 
@@ -111,7 +110,7 @@ Build and install Raylib from the raylib-c directory.
    sudo make install
 
 .. note:: Optional: Build the Raylib shared libs, if you plan to use
-   ``raylib.dynamic`` binding.
+   ``raylib_dynamic`` binding.
 
    ::
 
@@ -148,8 +147,8 @@ Build
 
     ::
 
-       rm raylib/dynamic/*.so*
-       cp -P /usr/local/lib/libraylib.so* raylib/dynamic/
+       rm dynamic/raylib/*.so*
+       cp -P /usr/local/lib/libraylib.so* dynamic/raylib/
 
 To build a binary wheel distribution:
 
@@ -158,12 +157,6 @@ To build a binary wheel distribution:
    pip3 install wheel
    python3 setup.py bdist_wheel
 
-Alternatively, if you don’t want the static binaries and just want to
-use DLLs with raylib.dynamic:
-
-::
-
-   python3 setup_dynamic.py bdist_wheel
 
 Then install it:
 
@@ -183,8 +176,8 @@ To build a complete set of libs for Python 3.6, 3.7, 3.8 and 3.9:
    ``./raylib/static/build_multi_linux.sh`` )
 
 .. TODO::
-   move the dynamic libs into a separate package rather than include
-   them with every one.
+   Separate the instructions for preparing the dynamic module
+   from the instructions for building the static module!
 
 
 

README.md

@@ -27,24 +27,26 @@ using homebrew, apt, etc.
 
 [If it doesn't work, build from source](BUILDING.md)
 
+There is now a separate dynamic version of this binding:
+
+    python3 -m pip install raylib_dynamic
+
+[Read this before using raylib_dynamic](https://electronstudio.github.io/raylib-python-cffi/dynamic.html)
 
 
 # How to use
 
-There are three different ways of using this binding.  You only need to pick one method, but you
+There are two different ways of using this binding.  You only need to pick one method, but you
 can combine two methods in one program if you want to.
 
 ### 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 [raylib.static](https://electronstudio.github.io/raylib-python-cffi/raylib.html).
+Use [the C API](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
 
-Use [raylib.pyray](https://electronstudio.github.io/raylib-python-cffi/pyray.html).
-
-### If you insist on dynamic bindings and don't care that they are slower and less safe
+Use [the Python API](https://electronstudio.github.io/raylib-python-cffi/pyray.html).
 
-Use [raylib.dynamic](https://electronstudio.github.io/raylib-python-cffi/dynamic.html).