Skip to content

Docs: Add reST directives to c-api/intro#Include_Files #14698

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
benjaminp merged 6 commits into from
Sep 10, 2019
+9 −7
Merged

Docs: Add reST directives to c-api/intro#Include_Files #14698

Changes from 1 commit
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
3e4e456
Merge pull request #1 from python/master
aeros Jul 4, 2019
60df01a
Merge remote-tracking branch 'upstream/master'
aeros Jul 9, 2019
42c11cf
Docs: Add RST directives to c-api/intro#Include_Files
aeros Jul 11, 2019
5924d1d
Remove trailing whitespace
aeros Jul 11, 2019
5997dd1
Apply suggestions
aeros Sep 10, 2019
e378f3e
Fix words per line
aeros Sep 10, 2019
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Apply suggestions
  • Loading branch information
@aeros
aeros authored Sep 10, 2019
commit 5997dd1695081186effb0a0ef6d45110a39a6f3a
14 changes: 5 additions & 9 deletions Doc/c-api/intro.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -46,9 +46,7 @@ Include Files
=============

All function, type and macro definitions needed to use the Python/C API are
included in your code by the following line:

.. code:: c
included in your code by the following line::

#define PY_SSIZE_T_CLEAN
#include <Python.h>
Expand All @@ -71,7 +69,7 @@ standard headers) have one of the prefixes ``Py`` or ``_Py``. Names beginning
with ``_Py`` are for internal use by the Python implementation and should not be
used by extension writers. Structure member names do not have a reserved prefix.

.. important::
.. note::

User code should never define names that begin with ``Py`` or
Comment thread
aeros marked this conversation as resolved.
Outdated
``_Py``. This confuses the reader, and jeopardizes the portability of the user
Expand All @@ -94,11 +92,9 @@ multi-platform builds since the platform independent headers under
:envvar:`prefix` include the platform specific headers from
:envvar:`exec_prefix`.

.. note::

C++ users should note that although the API is defined entirely using C, the
header files properly declare the entry points to be ``extern "C"``. As a result,
there is no need to do anything special to use the API from C++.
C++ users should note that although the API is defined entirely using C, the
header files properly declare the entry points to be ``extern "C"``. As a result,
there is no need to do anything special to use the API from C++.


Useful macros
Expand Down