diff --git a/docs/src/userguide/special_methods.rst b/docs/src/userguide/special_methods.rst
index 510d85e6eccb19a2d25391953cd11256a5e551b4..bde0b61b4b4325b0088e08c41acd0605e68ed1f8 100644
--- a/docs/src/userguide/special_methods.rst
+++ b/docs/src/userguide/special_methods.rst
@@ -215,13 +215,13 @@ https://docs.python.org/3/reference/datamodel.html#special-method-names
 +-----------------------+---------------------------------------+-------------+-----------------------------------------------------+
 | __dealloc__           |self 	                                |             | Basic deallocation (no direct Python equivalent)    |
 +-----------------------+---------------------------------------+-------------+-----------------------------------------------------+
-| __cmp__               |x, y 	                                | int         | 3-way comparison                                    |
+| __cmp__               |x, y 	                                | int         | 3-way comparison (Python 2 only)                    |
 +-----------------------+---------------------------------------+-------------+-----------------------------------------------------+
 | __str__               |self 	                                | object      | str(self)                                           |
 +-----------------------+---------------------------------------+-------------+-----------------------------------------------------+
 | __repr__              |self 	                                | object      | repr(self)                                          |
 +-----------------------+---------------------------------------+-------------+-----------------------------------------------------+
-| __hash__              |self 	                                | int         | Hash function                                       |
+| __hash__              |self 	                                | Py_hash_t   | Hash function (returns 32/64 bit integer)           |
 +-----------------------+---------------------------------------+-------------+-----------------------------------------------------+
 | __call__              |self, ...                              | object      | self(...)                                           |
 +-----------------------+---------------------------------------+-------------+-----------------------------------------------------+
@@ -375,7 +375,7 @@ https://docs.python.org/3/reference/datamodel.html#emulating-container-types
 +-----------------------+---------------------------------------+-------------+-----------------------------------------------------+
 | Name 	                | Parameters                            | Return type | 	Description                                 |
 +=======================+=======================================+=============+=====================================================+
-| __len__               | self                                  | int         | len(self)                                           |
+| __len__               | self                                  | Py_ssize_t  | len(self)                                           |
 +-----------------------+---------------------------------------+-------------+-----------------------------------------------------+
 | __getitem__ 	        | self, x 	                        | object      | self[x]                                             |
 +-----------------------+---------------------------------------+-------------+-----------------------------------------------------+