From d19f5059dbc839d3df046560547b50182e9aae41 Mon Sep 17 00:00:00 2001
From: Even Rouault <even.rouault@spatialys.com>
Date: Thu, 17 Feb 2022 18:43:04 +0100
Subject: Doc: mention Lambert c.e.a, Behrmann, and Gall-Peters projections as
 specializations of cea

Shared credits with @pramsey / PR #3063
---
 docs/source/operations/projections/cea.rst | 27 ++++++++++++++++++++++++++-
 1 file changed, 26 insertions(+), 1 deletion(-)

diff --git a/docs/source/operations/projections/cea.rst b/docs/source/operations/projections/cea.rst
index 3799fbcb..3f8af65f 100644
--- a/docs/source/operations/projections/cea.rst
+++ b/docs/source/operations/projections/cea.rst
@@ -28,6 +28,22 @@ Equal Area Cylindrical
 
    proj-string: ``+proj=cea``
 
+Named specializations
+################################################################################
+
+The Equal Area Cylindrical projection is sometimes known under other names when
+it is instanciated with particular values of the ``lat_ts`` parameter:
+
++----------------------------------+------------+
+| **Name**                         | **lat_ts** |
++----------------------------------+------------+
+| Lambert cylindrical equal-area   |      0     |
++----------------------------------+------------+
+| Behrmann                         |     30     |
++----------------------------------+------------+
+| Gall-Peters                      |     45     |
++----------------------------------+------------+
+
 Parameters
 ################################################################################
 
@@ -51,4 +67,13 @@ Parameters
 
     ``lat_ts`` and ``k_0`` are mutually exclusive. If ``lat_ts``
     is specified, it is equivalent to setting ``k_0`` to
-    :math:`\frac{\cos \phi_{ts}}{\sqrt{1 - e^2 \sin^2 \phi_{ts}}}`
\ No newline at end of file
+    :math:`\frac{\cos \phi_{ts}}{\sqrt{1 - e^2 \sin^2 \phi_{ts}}}`
+
+Further reading
+###############
+
+#. `Wikipedia: Lambert cylindrical equal-area <https://en.wikipedia.org/wiki/Lambert_cylindrical_equal-area_projection>`_
+
+#. `Wikipedia: Gall-Peters <https://en.wikipedia.org/wiki/Gall%E2%80%93Peters_projection>`_
+
+#. `Wikipedia: Behrmann <https://en.wikipedia.org/wiki/Behrmann_projection>`_
-- 
cgit v1.2.3


From 009d9a401bb7c321e1d4c387b9fe2fb4f1645879 Mon Sep 17 00:00:00 2001
From: Even Rouault <even.rouault@spatialys.com>
Date: Thu, 17 Feb 2022 20:41:24 +0100
Subject: Doc: gall.rst: add note that Gall != Gall-Peters

---
 docs/source/operations/projections/gall.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/source/operations/projections/gall.rst b/docs/source/operations/projections/gall.rst
index 8114815a..ba83d450 100644
--- a/docs/source/operations/projections/gall.rst
+++ b/docs/source/operations/projections/gall.rst
@@ -42,6 +42,10 @@ It is used in several British atlases, but seldom in the United States.
 The Gall projection is neither conformal nor equal-area, but has a blend of various features.
 Unlike the Mercator, the Gall shows the poles as lines running across the top and bottom of the map.
 
+.. note::
+
+    The Gall projection must not be confused with the Gall-Peters one, the later
+    being a specialization of :ref:`cea`.
 
 Example using Gall Stereographic  ::
 
-- 
cgit v1.2.3