summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorStefan Behnel <stefan_ml@behnel.de>2022-02-13 23:16:57 +0100
committerStefan Behnel <stefan_ml@behnel.de>2022-02-13 23:16:57 +0100
commit4370a0bcb1d050b29f12a3949bc5a33043c795ef (patch)
treec7114a3c8aa7173f1fc5208b67da6c869b6ec97a
parentf581ff4f33b9a65a514a580c78fd944e92e83ae2 (diff)
downloadcython-4370a0bcb1d050b29f12a3949bc5a33043c795ef.tar.gz
docs: Fix some issues in the glossary.
-rw-r--r--docs/src/userguide/glossary.rst10
1 files changed, 7 insertions, 3 deletions
diff --git a/docs/src/userguide/glossary.rst b/docs/src/userguide/glossary.rst
index 514139633..74ea4dc28 100644
--- a/docs/src/userguide/glossary.rst
+++ b/docs/src/userguide/glossary.rst
@@ -4,7 +4,9 @@ Glossary
.. glossary::
Extension type
- "Extension type" can refer to either a Cython class defined with ``cdef class`` or more generally to any Python type that is ultimately implemented as a native C struct (including the built-in types like `int` or `dict`).
+ "Extension type" can refer to either a Cython class defined with ``cdef class`` or ``@cclass``,
+ or more generally to any Python type that is ultimately implemented as a
+ native C struct (including the built-in types like `int` or `dict`).
Dynamic allocation or Heap allocation
A C variable allocated with ``malloc`` (in C) or ``new`` (in C++) is
@@ -16,7 +18,8 @@ Glossary
A **pointer** is a variable that stores the address of another variable
(i.e. direct address of the memory location). They allow for
dynamic memory allocation and deallocation. They can be used to build
- dynamic data structures. `Read more <https://en.wikipedia.org/wiki/Pointer_(computer_programming)#C_pointers>`__.
+ dynamic data structures.
+ `Read more <https://en.wikipedia.org/wiki/Pointer_(computer_programming)#C_pointers>`__.
Python object
When using Python, the contents of every variable is a Python object
@@ -40,7 +43,8 @@ Glossary
`buffer protocol`_ (typically "array" types, for example a Numpy array).
The memoryview keeps a reference to that Python object alive
and provides quick access to the memory without needing to go
- through the Python API of the object and its ``__getitem__``/``__setitem__`` methods.
+ through the Python API of the object and its
+ :meth:`__getitem__` / :meth:`__setitem__` methods.
For more information, see :ref:`memoryviews`.
.. _buffer protocol: https://docs.python.org/3/c-api/buffer.html