From 8b93f2bb08c45c18f207f61b6691fd13664f8609 Mon Sep 17 00:00:00 2001
From: Jason Madden <jamadden@gmail.com>
Date: Thu, 14 Sep 2017 12:17:35 -0500
Subject: Document proxy.__class__ troubles with isinstance/issubclass

And suggest workarounds, in a prominent new section about proxy troubles.

Link to this from everywhere we talk about proxies.

Fixes #26
---
 src/zope/security/proxy.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

(limited to 'src/zope/security/proxy.py')

diff --git a/src/zope/security/proxy.py b/src/zope/security/proxy.py
index 55f54f6..10f0353 100644
--- a/src/zope/security/proxy.py
+++ b/src/zope/security/proxy.py
@@ -11,7 +11,10 @@
 # FOR A PARTICULAR PURPOSE.
 #
 ##############################################################################
-"""Helper functions for Proxies.
+"""
+Helper functions for proxies.
+
+.. seealso:: :ref:`proxy-known-issues`
 """
 import functools
 import sys
-- 
cgit v1.2.1