Kaydet (Commit) ec19ba21 authored tarafından gfyoung's avatar gfyoung Kaydeden (comit) Mariatta

bpo-29596: Improve clinic howto documentation (GH-1710)

Clarify that `two-pass` buffer can only be dumped once, and it prints out all text sent to it during all processing, even from Clinic blocks *after* the dumping point.
üst 53f2af16
......@@ -1407,8 +1407,8 @@ Let's start with defining some terminology:
``two-pass``
A buffer like ``buffer``. However, a two-pass buffer can only
be written once, and it prints out all text sent to it during
all of processing, even from Clinic blocks *after* the
be dumped once, and it prints out all text sent to it during
all processing, even from Clinic blocks *after* the dumping point.
``suppress``
The text is suppressed—thrown away.
......@@ -1471,7 +1471,7 @@ preset configurations, as follows:
The default filename is ``"{dirname}/clinic/{basename}.h"``.
``buffer``
Save up all most of the output from Clinic, to be written into
Save up most of the output from Clinic, to be written into
your file near the end. For Python files implementing modules
or builtin types, it's recommended that you dump the buffer
just above the static structures for your module or
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment