Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Commit 357ed2e

Browse files
committed
Change double hyphens (en dashes) to em (longer) dashes
1 parent b24569a commit 357ed2e

6 files changed

Lines changed: 20 additions & 20 deletions

File tree

Doc/howto/clinic.rst

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ Argument Clinic's primary goal
3030
is to take over responsibility for all argument parsing code
3131
inside CPython. This means that, when you convert a function
3232
to work with Argument Clinic, that function should no longer
33-
do any of its own argument parsing--the code generated by
33+
do any of its own argument parsingthe code generated by
3434
Argument Clinic should be a "black box" to you, where CPython
3535
calls in at the top, and your code gets called at the bottom,
3636
with ``PyObject *args`` (and maybe ``PyObject *kwargs``)
@@ -43,12 +43,12 @@ redundant information in a surprising number of places.
4343
When you use Argument Clinic, you don't have to repeat yourself.
4444

4545
Obviously, no one would want to use Argument Clinic unless
46-
it's solving their problem--and without creating new problems of
46+
it's solving their problemand without creating new problems of
4747
its own.
4848
So it's paramount that Argument Clinic generate correct code.
4949
It'd be nice if the code was faster, too, but at the very least
5050
it should not introduce a major speed regression. (Eventually Argument
51-
Clinic *should* make a major speedup possible--we could
51+
Clinic *should* make a major speedup possiblewe could
5252
rewrite its code generator to produce tailor-made argument
5353
parsing code, rather than calling the general-purpose CPython
5454
argument parsing library. That would make for the fastest
@@ -113,7 +113,7 @@ line. However, if the input hasn't changed, the output won't change either.
113113

114114
You should never modify the output portion of an Argument Clinic block. Instead,
115115
change the input until it produces the output you want. (That's the purpose of the
116-
checksum--to detect if someone changed the output, as these edits would be lost
116+
checksumto detect if someone changed the output, as these edits would be lost
117117
the next time Argument Clinic writes out fresh output.)
118118

119119
For the sake of clarity, here's the terminology we'll use with Argument Clinic:
@@ -166,7 +166,7 @@ Let's dive in!
166166
or if it has multiple calls to :c:func:`PyArg_ParseTuple`,
167167
you should choose a different function. Argument Clinic *does*
168168
support all of these scenarios. But these are advanced
169-
topics--let's do something simpler for your first function.
169+
topicslet's do something simpler for your first function.
170170

171171
Also, if the function has multiple calls to :c:func:`PyArg_ParseTuple`
172172
or :c:func:`PyArg_ParseTupleAndKeywords` where it supports different
@@ -188,7 +188,7 @@ Let's dive in!
188188

189189
If the old docstring had a first line that looked like a function
190190
signature, throw that line away. (The docstring doesn't need it
191-
anymore--when you use ``help()`` on your builtin in the future,
191+
anymorewhen you use ``help()`` on your builtin in the future,
192192
the first line will be built automatically based on the function's
193193
signature.)
194194

@@ -209,7 +209,7 @@ Let's dive in!
209209
6. Above the docstring, enter the name of the function, followed
210210
by a blank line. This should be the Python name of the function,
211211
and should be the full dotted path
212-
to the function--it should start with the name of the module,
212+
to the functionit should start with the name of the module,
213213
include any sub-modules, and if the function is a method on
214214
a class it should include the class name too.
215215

@@ -275,7 +275,7 @@ Let's dive in!
275275
What's a "converter"? It establishes both the type
276276
of the variable used in C, and the method to convert the Python
277277
value into a C value at runtime.
278-
For now you're going to use what's called a "legacy converter"--a
278+
For now you're going to use what's called a "legacy converter"a
279279
convenience syntax intended to make porting old code into Argument
280280
Clinic easier.
281281

@@ -424,7 +424,7 @@ Let's dive in!
424424
(Argument Clinic always generates its format strings
425425
with a ``:`` followed by the name of the function. If the
426426
existing code's format string ends with ``;``, to provide
427-
usage help, this change is harmless--don't worry about it.)
427+
usage help, this change is harmlessdon't worry about it.)
428428

429429
Third, for parameters whose format units require two arguments
430430
(like a length variable, or an encoding string, or a pointer
@@ -637,7 +637,7 @@ an optional argument on the *left* side of its required argument!
637637
Another example is ``curses.window.addch()``, which has a group of two
638638
arguments that must always be specified together. (The arguments are
639639
called ``x`` and ``y``; if you call the function passing in ``x``,
640-
you must also pass in ``y``--and if you don't pass in ``x`` you may not
640+
you must also pass in ``y``and if you don't pass in ``x`` you may not
641641
pass in ``y`` either.)
642642

643643
In any case, the goal of Argument Clinic is to support argument parsing
@@ -888,7 +888,7 @@ Advanced converters
888888
Remember those format units you skipped for your first
889889
time because they were advanced? Here's how to handle those too.
890890

891-
The trick is, all those format units take arguments--either
891+
The trick is, all those format units take argumentseither
892892
conversion functions, or types, or strings specifying an encoding.
893893
(But "legacy converters" don't support arguments. That's why we
894894
skipped them for your first function.) The argument you specified
@@ -1002,7 +1002,7 @@ Using a return converter
10021002
By default the impl function Argument Clinic generates for you returns ``PyObject *``.
10031003
But your C function often computes some C type, then converts it into the ``PyObject *``
10041004
at the last moment. Argument Clinic handles converting your inputs from Python types
1005-
into native C types--why not have it convert your return value from a native C type
1005+
into native C typeswhy not have it convert your return value from a native C type
10061006
into a Python type too?
10071007

10081008
That's what a "return converter" does. It changes your impl function to return
@@ -1184,7 +1184,7 @@ Writing a custom converter
11841184
As we hinted at in the previous section... you can write your own converters!
11851185
A converter is simply a Python class that inherits from ``CConverter``.
11861186
The main purpose of a custom converter is if you have a parameter using
1187-
the ``O&`` format unit--parsing this parameter means calling
1187+
the ``O&`` format unitparsing this parameter means calling
11881188
a :c:func:`PyArg_ParseTuple` "converter function".
11891189

11901190
Your converter class should be named ``*something*_converter``.
@@ -1226,7 +1226,7 @@ to specify in your subclass. Here's the current list:
12261226
The default value used to initialize the C variable when
12271227
there is no default, but not specifying a default may
12281228
result in an "uninitialized variable" warning. This can
1229-
easily happen when using option groups--although
1229+
easily happen when using option groupsalthough
12301230
properly-written code will never actually use this value,
12311231
the variable does get passed in to the impl, and the
12321232
C compiler will complain about the "use" of the
@@ -1402,7 +1402,7 @@ Let's start with defining some terminology:
14021402
all of processing, even from Clinic blocks *after* the
14031403

14041404
``suppress``
1405-
The text is suppressed--thrown away.
1405+
The text is suppressedthrown away.
14061406

14071407

14081408
Clinic defines five new directives that let you reconfigure its output.

Doc/howto/cporting.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -95,7 +95,7 @@ long/int Unification
9595
--------------------
9696

9797
Python 3 has only one integer type, :func:`int`. But it actually
98-
corresponds to Python 2's :func:`long` type--the :func:`int` type
98+
corresponds to Python 2's :func:`long` typethe :func:`int` type
9999
used in Python 2 was removed. In the C-API, ``PyInt_*`` functions
100100
are replaced by their ``PyLong_*`` equivalents.
101101

Doc/library/functions.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -949,7 +949,7 @@ are always available. They are listed here in alphabetical order.
949949
the list of supported encodings.
950950

951951
*errors* is an optional string that specifies how encoding and decoding
952-
errors are to be handled--this cannot be used in binary mode.
952+
errors are to be handledthis cannot be used in binary mode.
953953
A variety of standard error handlers are available
954954
(listed under :ref:`error-handlers`), though any
955955
error handling name that has been registered with

Doc/library/hmac.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -111,7 +111,7 @@ This module also provides the following helper function:
111111

112112
If *a* and *b* are of different lengths, or if an error occurs,
113113
a timing attack could theoretically reveal information about the
114-
types and lengths of *a* and *b*--but not their values.
114+
types and lengths of *a* and *b*but not their values.
115115

116116

117117
.. versionadded:: 3.3

Doc/library/pdb.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -328,7 +328,7 @@ by the local file.
328328
return, jump, quit and their abbreviations) terminates the command list (as if
329329
that command was immediately followed by end). This is because any time you
330330
resume execution (even with a simple next or step), you may encounter another
331-
breakpoint--which could have its own command list, leading to ambiguities about
331+
breakpointwhich could have its own command list, leading to ambiguities about
332332
which list to execute.
333333

334334
If you use the 'silent' command in the command list, the usual message about

Doc/library/shutil.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -107,7 +107,7 @@ Directory and files operations
107107
If *follow_symlinks* is false, and *src* and *dst* both
108108
refer to symbolic links, :func:`copystat` will operate on
109109
the symbolic links themselves rather than the files the
110-
symbolic links refer to--reading the information from the
110+
symbolic links refer toreading the information from the
111111
*src* symbolic link, and writing the information to the
112112
*dst* symbolic link.
113113

0 commit comments

Comments
 (0)