From 6db771871ee3ad65109cd9791cc3ef339618f086 Mon Sep 17 00:00:00 2001
From: Guido van Rossum <guido@python.org>
Date: Wed, 9 Apr 2003 18:02:23 +0000
Subject: Try to discourage use of PyObject_Type().

---
 Doc/api/abstract.tex | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/Doc/api/abstract.tex b/Doc/api/abstract.tex
index 0822f62..a8bcc15 100644
--- a/Doc/api/abstract.tex
+++ b/Doc/api/abstract.tex
@@ -319,6 +319,11 @@ determination.
   the object type of object \var{o}. On failure, raises
   \exception{SystemError} and returns \NULL.  This is equivalent to
   the Python expression \code{type(\var{o})}.
+  This function increments the reference count of the return value.
+  There's really no reason to use this function instead of the
+  common expression \code{\var{o}->ob_type}, which returns a pointer
+  of type \code{PyTypeObject *}, except when the incremented reference
+  count is needed.
   \bifuncindex{type}
 \end{cfuncdesc}
 
-- 
cgit v0.12