From 4e36a3213c5f588bac31f800b091de27cb236ef1 Mon Sep 17 00:00:00 2001
From: "Alan D. Snow" <alansnow21@gmail.com>
Date: Fri, 1 May 2020 19:03:23 -0500
Subject: [PATCH] DOC: Add gotcha section for SQLite exceptions (#609)

---
 docs/gotchas.rst | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/docs/gotchas.rst b/docs/gotchas.rst
index d145b7ebc..cabb631d0 100644
--- a/docs/gotchas.rst
+++ b/docs/gotchas.rst
@@ -232,6 +232,18 @@ Here is an example of that:
     >>> crs_epsg == crs_deprecated
     False
 
+
+SQLite error on SELECT
+----------------------
+
+The PROJ database is based on the EPSG database. With each release,
+there is a good chance that there are database updates. If you have multiple
+versions of PROJ installed on your systems and the search path for
+the data directory becomes mixed up, you may see an error message like:
+`SQLite error on SELECT`. This is likely due to a version of PROJ
+attempting to use an incompatible database.
+
+
 .. _upgrade_transformer:
 
 Upgrading to pyproj 2 from pyproj 1