summaryrefslogtreecommitdiffstats
path: root/Doc/faq
diff options
context:
space:
mode:
authorjmcb <joelsgp@protonmail.com>2022-11-07 04:55:55 (GMT)
committerGitHub <noreply@github.com>2022-11-07 04:55:55 (GMT)
commit728e42fcf51cbb2108caf1382df224c13b53d024 (patch)
treed44af519444da7fed1a826903a1631fb0e921d97 /Doc/faq
parentd7a00f1e8eee05fc5ae97ea1ef0615feefce887b (diff)
downloadcpython-728e42fcf51cbb2108caf1382df224c13b53d024.zip
cpython-728e42fcf51cbb2108caf1382df224c13b53d024.tar.gz
cpython-728e42fcf51cbb2108caf1382df224c13b53d024.tar.bz2
doc: Formatting and typo fixes (#98974)
Diffstat (limited to 'Doc/faq')
-rw-r--r--Doc/faq/windows.rst10
1 files changed, 5 insertions, 5 deletions
diff --git a/Doc/faq/windows.rst b/Doc/faq/windows.rst
index 7768aaf..c0c92fd 100644
--- a/Doc/faq/windows.rst
+++ b/Doc/faq/windows.rst
@@ -167,7 +167,7 @@ How can I embed Python into a Windows application?
Embedding the Python interpreter in a Windows app can be summarized as follows:
-1. Do _not_ build Python into your .exe file directly. On Windows, Python must
+1. Do **not** build Python into your .exe file directly. On Windows, Python must
be a DLL to handle importing modules that are themselves DLL's. (This is the
first key undocumented fact.) Instead, link to :file:`python{NN}.dll`; it is
typically installed in ``C:\Windows\System``. *NN* is the Python version, a
@@ -191,7 +191,7 @@ Embedding the Python interpreter in a Windows app can be summarized as follows:
2. If you use SWIG, it is easy to create a Python "extension module" that will
make the app's data and methods available to Python. SWIG will handle just
about all the grungy details for you. The result is C code that you link
- *into* your .exe file (!) You do _not_ have to create a DLL file, and this
+ *into* your .exe file (!) You do **not** have to create a DLL file, and this
also simplifies linking.
3. SWIG will create an init function (a C function) whose name depends on the
@@ -218,10 +218,10 @@ Embedding the Python interpreter in a Windows app can be summarized as follows:
5. There are two problems with Python's C API which will become apparent if you
use a compiler other than MSVC, the compiler used to build pythonNN.dll.
- Problem 1: The so-called "Very High Level" functions that take FILE *
+ Problem 1: The so-called "Very High Level" functions that take ``FILE *``
arguments will not work in a multi-compiler environment because each
- compiler's notion of a struct FILE will be different. From an implementation
- standpoint these are very _low_ level functions.
+ compiler's notion of a ``struct FILE`` will be different. From an implementation
+ standpoint these are very low level functions.
Problem 2: SWIG generates the following code when generating wrappers to void
functions: