DOC: document out handling of MACOSX_DEPLOYMENT_TARGET

FFY00 · FFY00 · commit b96ddb21f7c6 · 2022-09-29T23:26:46.000+01:00
Signed-off-by: Filipe Laíns &lt;lains@riseup.net&gt;
diff --git a/docs/index.rst b/docs/index.rst
@@ -148,6 +148,7 @@ If you really need the data to be installed where it was previously (eg.
 
    usage/start
    usage/build-options
+   usage/specific-behaviors
 
 
 .. toctree::
diff --git a/docs/usage/specific-behaviors.rst b/docs/usage/specific-behaviors.rst
@@ -0,0 +1,17 @@
+******************
+Specific Behaviors
+******************
+
+This page documents how our backend handles certain situations.
+
+
+``MACOSX_DEPLOYMENT_TARGET``
+============================
+
+
+The target macOS version can by changed by setting the
+``MACOSX_DEPLOYMENT_TARGET`` environment variable.
+
+If ``MACOSX_DEPLOYMENT_TARGET`` is set, we will use the selected version for the
+wheel tag, otherwise ``platform.mac_ver()`` (i.e., the current macOS version on
+the build machine) will be used instead.
