summaryrefslogtreecommitdiffstats
path: root/Include
diff options
context:
space:
mode:
authorTim Peters <tim.peters@gmail.com>2004-07-15 04:05:59 (GMT)
committerTim Peters <tim.peters@gmail.com>2004-07-15 04:05:59 (GMT)
commiteda29306b34303af2b79366c12f54a223029c165 (patch)
tree1215e26d073dba84614c4355d3335b852a3f0bf6 /Include
parent89ba1fff170f9e5de6f8c9c4ad598931c69492e8 (diff)
downloadcpython-eda29306b34303af2b79366c12f54a223029c165.zip
cpython-eda29306b34303af2b79366c12f54a223029c165.tar.gz
cpython-eda29306b34303af2b79366c12f54a223029c165.tar.bz2
Formalize that the Py_VISIT macro requires that the tp_traverse
implementation it's used in must give its arguments specific names.
Diffstat (limited to 'Include')
-rw-r--r--Include/objimpl.h6
1 files changed, 5 insertions, 1 deletions
diff --git a/Include/objimpl.h b/Include/objimpl.h
index 649d1bc..5707e50 100644
--- a/Include/objimpl.h
+++ b/Include/objimpl.h
@@ -302,7 +302,11 @@ PyAPI_FUNC(void) PyObject_GC_Del(void *);
( (type *) _PyObject_GC_NewVar((typeobj), (n)) )
-/* Utility macro to help write tp_traverse functions */
+/* Utility macro to help write tp_traverse functions.
+ * To use this macro, the tp_traverse function must name its arguments
+ * "visit" and "arg". This is intended to keep tp_traverse functions
+ * looking as much alike as possible.
+ */
#define Py_VISIT(op) \
do { \
if (op) { \