From 5b5041f32089cae42f7f3c5a174ff55c335cd30e Mon Sep 17 00:00:00 2001
From: Paul Ganssle <paul@ganssle.io>
Date: Sun, 17 May 2020 12:47:31 -0400
Subject: [PATCH] Document that available_timezones is not comprehensive

---
 docs/zoneinfo.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/zoneinfo.rst b/docs/zoneinfo.rst
index ffeef6bd..b60c5f2f 100644
--- a/docs/zoneinfo.rst
+++ b/docs/zoneinfo.rst
@@ -347,6 +347,10 @@ Functions
     anywhere on the time zone path. This is recalculated on every call to the
     function.
 
+    This function only includes canonical zone names and does not include
+    "special" zones such as those under the ``posix/`` and ``right/``
+    directories, or the ``posixrules`` zone.
+
     .. caution::
 
         This function may open a large number of files, as the best way to