Skip to content

Commit ad1bb6c

Browse files
[3.14] gh-150285: Fix too long docstrings in the pyexpat module (GH-150294) (GH-150463)
(cherry picked from commit 9da7923)
1 parent 7168b02 commit ad1bb6c

2 files changed

Lines changed: 43 additions & 35 deletions

File tree

Modules/clinic/pyexpat.c.h

Lines changed: 20 additions & 16 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

Modules/pyexpat.c

Lines changed: 23 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1027,13 +1027,14 @@ pyexpat.xmlparser.GetInputContext
10271027
10281028
Return the untranslated text of the input that caused the current event.
10291029
1030-
If the event was generated by a large amount of text (such as a start tag
1031-
for an element with many attributes), not all of the text may be available.
1030+
If the event was generated by a large amount of text (such as
1031+
a start tag for an element with many attributes), not all of the
1032+
text may be available.
10321033
[clinic start generated code]*/
10331034

10341035
static PyObject *
10351036
pyexpat_xmlparser_GetInputContext_impl(xmlparseobject *self)
1036-
/*[clinic end generated code: output=a88026d683fc22cc input=034df8712db68379]*/
1037+
/*[clinic end generated code: output=a88026d683fc22cc input=3ff7cb00783c8f98]*/
10371038
{
10381039
if (self->in_callback) {
10391040
int offset, size;
@@ -1165,15 +1166,16 @@ pyexpat.xmlparser.UseForeignDTD
11651166
11661167
Allows the application to provide an artificial external subset if one is not specified as part of the document instance.
11671168
1168-
This readily allows the use of a 'default' document type controlled by the
1169-
application, while still getting the advantage of providing document type
1170-
information to the parser. 'flag' defaults to True if not provided.
1169+
This readily allows the use of a 'default' document type controlled
1170+
by the application, while still getting the advantage of providing
1171+
document type information to the parser. 'flag' defaults to True if
1172+
not provided.
11711173
[clinic start generated code]*/
11721174

11731175
static PyObject *
11741176
pyexpat_xmlparser_UseForeignDTD_impl(xmlparseobject *self, PyTypeObject *cls,
11751177
int flag)
1176-
/*[clinic end generated code: output=d7d98252bd25a20f input=23440ecb0573fb29]*/
1178+
/*[clinic end generated code: output=d7d98252bd25a20f input=0387bce44fd53d99]*/
11771179
{
11781180
pyexpat_state *state = PyType_GetModuleState(cls);
11791181
enum XML_Error rc;
@@ -1240,14 +1242,15 @@ pyexpat.xmlparser.SetAllocTrackerActivationThreshold
12401242
12411243
Sets the number of allocated bytes of dynamic memory needed to activate protection against disproportionate use of RAM.
12421244
1243-
By default, parser objects have an allocation activation threshold of 64 MiB.
1245+
By default, parser objects have an allocation activation threshold of
1246+
64 MiB.
12441247
[clinic start generated code]*/
12451248

12461249
static PyObject *
12471250
pyexpat_xmlparser_SetAllocTrackerActivationThreshold_impl(xmlparseobject *self,
12481251
PyTypeObject *cls,
12491252
unsigned long long threshold)
1250-
/*[clinic end generated code: output=bed7e93207ba08c5 input=9c706b75c18e4ea1]*/
1253+
/*[clinic end generated code: output=bed7e93207ba08c5 input=a96541ba5ea46747]*/
12511254
{
12521255
return set_activation_threshold(
12531256
self, cls, threshold,
@@ -1266,24 +1269,25 @@ pyexpat.xmlparser.SetAllocTrackerMaximumAmplification
12661269
12671270
Sets the maximum amplification factor between direct input and bytes of dynamic memory allocated.
12681271
1269-
The amplification factor is calculated as "allocated / direct" while parsing,
1270-
where "direct" is the number of bytes read from the primary document in parsing
1271-
and "allocated" is the number of bytes of dynamic memory allocated in the parser
1272-
hierarchy.
1272+
The amplification factor is calculated as "allocated / direct" while
1273+
parsing, where "direct" is the number of bytes read from the primary
1274+
document in parsing and "allocated" is the number of bytes of
1275+
dynamic memory allocated in the parser hierarchy.
12731276
1274-
The 'max_factor' value must be a non-NaN floating point value greater than
1275-
or equal to 1.0. Amplification factors greater than 100.0 can be observed
1276-
near the start of parsing even with benign files in practice. In particular,
1277-
the activation threshold should be carefully chosen to avoid false positives.
1277+
The 'max_factor' value must be a non-NaN floating point value
1278+
greater than or equal to 1.0. Amplification factors greater than
1279+
100.0 can be observed near the start of parsing even with benign
1280+
files in practice. In particular, the activation threshold should
1281+
be carefully chosen to avoid false positives.
12781282
1279-
By default, parser objects have a maximum amplification factor of 100.0.
1283+
By default, parser objects have a maximum amplification factor of 100.
12801284
[clinic start generated code]*/
12811285

12821286
static PyObject *
12831287
pyexpat_xmlparser_SetAllocTrackerMaximumAmplification_impl(xmlparseobject *self,
12841288
PyTypeObject *cls,
12851289
float max_factor)
1286-
/*[clinic end generated code: output=6e44bd48c9b112a0 input=918b9266b490a722]*/
1290+
/*[clinic end generated code: output=6e44bd48c9b112a0 input=9cd13e3ea845dbb4]*/
12871291
{
12881292
return set_maximum_amplification(
12891293
self, cls, max_factor,

0 commit comments

Comments
 (0)