Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Support
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
C
cpython
Project overview
Project overview
Details
Activity
Releases
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Issues
0
Issues
0
List
Boards
Labels
Milestones
Merge Requests
0
Merge Requests
0
Analytics
Analytics
Repository
Value Stream
Wiki
Wiki
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Create a new issue
Commits
Issue Boards
Open sidebar
Kirill Smelkov
cpython
Commits
b4a2b36c
Commit
b4a2b36c
authored
Aug 12, 2016
by
Martin Panter
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Issue #27745: Fix some typos in Argument Clinic howto, by Lele Gaifax
parent
3cf0b251
Changes
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
4 additions
and
4 deletions
+4
-4
Doc/howto/clinic.rst
Doc/howto/clinic.rst
+4
-4
No files found.
Doc/howto/clinic.rst
View file @
b4a2b36c
...
...
@@ -653,7 +653,7 @@ can *only* be used with positional-only parameters.
Functions that use *any* other approach for parsing arguments
should *almost never* be converted to Argument Clinic using
optional groups. Functions using optional groups currently
cannot have accurate sig
an
tures in Python, because Python just
cannot have accurate sig
na
tures in Python, because Python just
doesn't understand the concept. Please avoid using optional
groups wherever possible.
...
...
@@ -1337,7 +1337,7 @@ every line of Clinic's generated output.
While changing Clinic's output in this manner can be a boon to readability,
it may result in Clinic code using types before they are defined, or
your code attempting to use Clinic-generated code bef
i
re it is defined.
your code attempting to use Clinic-generated code bef
o
re it is defined.
These problems can be easily solved by rearranging the declarations in your file,
or moving where Clinic's generated code goes. (This is why the default behavior
of Clinic is to output everything into the current block; while many people
...
...
@@ -1381,7 +1381,7 @@ Let's start with defining some terminology:
``buffer``
A text buffer where you can save text for later. Text sent
here is appended to the end of any ex
si
ting text. It's an
here is appended to the end of any ex
is
ting text. It's an
error to have any text left in the buffer when Clinic finishes
processing a file.
...
...
@@ -1653,7 +1653,7 @@ undefined, this turns into nothing.
However, this causes one ticklish problem: where should Argument Clinic put this
extra code when using the "block" output preset? It can't go in the output block,
because that could be de
ca
tivated by the ``#ifdef``. (That's the whole point!)
because that could be de
ac
tivated by the ``#ifdef``. (That's the whole point!)
In this situation, Argument Clinic writes the extra code to the "buffer" destination.
This may mean that you get a complaint from Argument Clinic::
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment