@@ -24,17 +24,17 @@ msgstr ""
2424#: c-api/arg.rst:8
2525msgid ""
2626"These functions are useful when creating your own extensions functions and "
27- "methods. Additional information and examples are available "
28- "in :ref: `extending-index`."
27+ "methods. Additional information and examples are available in :ref: "
28+ "`extending-index`."
2929msgstr ""
3030
3131#: c-api/arg.rst:12
3232msgid ""
33- "The first three of these functions "
34- "described, :c: func:`PyArg_ParseTuple `, :c:func:`PyArg_ParseTupleAndKeywords`, "
35- "and :c:func:`PyArg_Parse`, all use *format strings* which are used to tell "
36- "the function about the expected arguments. The format strings use the same "
37- "syntax for each of these functions."
33+ "The first three of these functions described, :c:func:`PyArg_ParseTuple`, :c: "
34+ "func:`PyArg_ParseTupleAndKeywords `, and :c:func:`PyArg_Parse`, all use "
35+ "*format strings* which are used to tell the function about the expected "
36+ "arguments. The format strings use the same syntax for each of these "
37+ "functions."
3838msgstr ""
3939
4040#: c-api/arg.rst:19
@@ -99,10 +99,10 @@ msgstr ""
9999
100100#: c-api/arg.rst:61
101101msgid ""
102- "To ensure that the underlying buffer may be safely borrowed, the "
103- "object's :c: member:`PyBufferProcs.bf_releasebuffer` field must be ``NULL``. "
104- "This disallows common mutable objects such as :class:`bytearray`, but also "
105- "some read-only objects such as :class:`memoryview` of :class:`bytes`."
102+ "To ensure that the underlying buffer may be safely borrowed, the object's :c: "
103+ "member:`PyBufferProcs.bf_releasebuffer` field must be ``NULL``. This "
104+ "disallows common mutable objects such as :class:`bytearray`, but also some "
105+ "read-only objects such as :class:`memoryview` of :class:`bytes`."
106106msgstr ""
107107
108108#: c-api/arg.rst:67
@@ -114,11 +114,11 @@ msgstr ""
114114
115115#: c-api/arg.rst:73
116116msgid ""
117- "For all ``#`` variants of formats (``s#``, ``y#``, etc.), the "
118- "macro :c:macro: `PY_SSIZE_T_CLEAN` must be defined before "
119- "including :file:` Python.h`. On Python 3.9 and older, the type of the length "
120- "argument is :c:type: `Py_ssize_t` if the :c:macro:`PY_SSIZE_T_CLEAN` macro is "
121- "defined, or int otherwise."
117+ "For all ``#`` variants of formats (``s#``, ``y#``, etc.), the macro :c:macro: "
118+ "`PY_SSIZE_T_CLEAN` must be defined before including :file:`Python.h`. On "
119+ "Python 3.9 and older, the type of the length argument is :c:type: "
120+ "`Py_ssize_t` if the :c:macro:`PY_SSIZE_T_CLEAN` macro is defined, or int "
121+ "otherwise."
122122msgstr ""
123123
124124#: c-api/arg.rst:80
@@ -139,8 +139,8 @@ msgstr ""
139139msgid ""
140140"This format does not accept :term:`bytes-like objects <bytes-like object>`. "
141141"If you want to accept filesystem paths and convert them to C character "
142- "strings, it is preferable to use the ``O&`` format "
143- "with :c:func: `PyUnicode_FSConverter` as *converter*."
142+ "strings, it is preferable to use the ``O&`` format with :c:func: "
143+ "`PyUnicode_FSConverter` as *converter*."
144144msgstr ""
145145
146146#: c-api/arg.rst:96
@@ -163,8 +163,8 @@ msgstr ""
163163
164164#: c-api/arg.rst:106
165165msgid ""
166- "``s#`` (:class:`str`, read-only :term:`bytes-like object`) [const char "
167- "\\ *, : c:type:`Py_ssize_t`]"
166+ "``s#`` (:class:`str`, read-only :term:`bytes-like object`) [const char \\ *, : "
167+ "c:type:`Py_ssize_t`]"
168168msgstr ""
169169
170170#: c-api/arg.rst:107
@@ -239,8 +239,8 @@ msgstr ""
239239
240240#: c-api/arg.rst:141
241241msgid ""
242- "``y#`` (read-only :term:`bytes-like object`) [const char "
243- "\\ *, :c:type: `Py_ssize_t`]"
242+ "``y#`` (read-only :term:`bytes-like object`) [const char \\ *, :c:type: "
243+ "`Py_ssize_t`]"
244244msgstr ""
245245
246246#: c-api/arg.rst:142
@@ -267,9 +267,9 @@ msgstr ""
267267#: c-api/arg.rst:151
268268msgid ""
269269"Requires that the Python object is a :class:`bytearray` object, without "
270- "attempting any conversion. Raises :exc:`TypeError` if the object is not "
271- "a : class:`bytearray` object. The C variable may also be declared "
272- "as :c:expr: `PyObject*`."
270+ "attempting any conversion. Raises :exc:`TypeError` if the object is not a : "
271+ "class:`bytearray` object. The C variable may also be declared as :c:expr: "
272+ "`PyObject*`."
273273msgstr ""
274274
275275#: c-api/arg.rst:155
@@ -291,8 +291,8 @@ msgstr ""
291291msgid ""
292292"This format accepts any object which implements the read-write buffer "
293293"interface. It fills a :c:type:`Py_buffer` structure provided by the caller. "
294- "The buffer may contain embedded null bytes. The caller have to "
295- "call :c:func: `PyBuffer_Release` when it is done with the buffer."
294+ "The buffer may contain embedded null bytes. The caller have to call :c:func: "
295+ "`PyBuffer_Release` when it is done with the buffer."
296296msgstr ""
297297
298298#: c-api/arg.rst:166
@@ -320,8 +320,8 @@ msgstr ""
320320msgid ""
321321":c:func:`PyArg_ParseTuple` will allocate a buffer of the needed size, copy "
322322"the encoded data into this buffer and adjust *\\ *buffer* to reference the "
323- "newly allocated storage. The caller is responsible for "
324- "calling :c:func: `PyMem_Free` to free the allocated buffer after use."
323+ "newly allocated storage. The caller is responsible for calling :c:func: "
324+ "`PyMem_Free` to free the allocated buffer after use."
325325msgstr ""
326326
327327#: c-api/arg.rst:183
@@ -339,8 +339,8 @@ msgstr ""
339339
340340#: c-api/arg.rst:188
341341msgid ""
342- "``es#`` (:class:`str`) [const char \\ *encoding, char "
343- "\\ * \\ *buffer, :c:type: `Py_ssize_t` \\ *buffer_length]"
342+ "``es#`` (:class:`str`) [const char \\ *encoding, char \\ * \\ *buffer, :c:type: "
343+ "`Py_ssize_t` \\ *buffer_length]"
344344msgstr ""
345345
346346#: c-api/arg.rst:189
@@ -417,11 +417,10 @@ msgstr ""
417417#: c-api/arg.rst:232
418418msgid ""
419419"These formats allow representing Python numbers or single characters as C "
420- "numbers. Formats that require :class:`int`, :class:`float` "
421- "or :class:`complex` can also use the corresponding special "
422- "methods :meth:`~object.__index__`, :meth:`~object.__float__` "
423- "or :meth:`~object.__complex__` to convert the Python object to the required "
424- "type."
420+ "numbers. Formats that require :class:`int`, :class:`float` or :class:"
421+ "`complex` can also use the corresponding special methods :meth:`~object."
422+ "__index__`, :meth:`~object.__float__` or :meth:`~object.__complex__` to "
423+ "convert the Python object to the required type."
425424msgstr ""
426425
427426#: c-api/arg.rst:238
@@ -591,9 +590,9 @@ msgstr ""
591590#: c-api/arg.rst:307
592591msgid ""
593592"Store a Python object (without any conversion) in a C object pointer. The C "
594- "program thus receives the actual object that was passed. A "
595- "new :term: `strong reference` to the object is not created (i.e. its "
596- "reference count is not increased). The pointer stored is not ``NULL``."
593+ "program thus receives the actual object that was passed. A new :term: "
594+ "`strong reference` to the object is not created (i.e. its reference count is "
595+ "not increased). The pointer stored is not ``NULL``."
597596msgstr ""
598597
599598#: c-api/arg.rst:313
@@ -627,12 +626,12 @@ msgstr ""
627626
628627#: c-api/arg.rst:330
629628msgid ""
630- "where *object* is the Python object to be converted and *address* is "
631- "the :c: expr:`void*` argument that was passed to the ``PyArg_Parse*`` "
632- "function. The returned *status* should be ``1`` for a successful conversion "
633- "and ``0`` if the conversion has failed. When the conversion fails, the "
634- "*converter* function should raise an exception and leave the content of "
635- "*address* unmodified."
629+ "where *object* is the Python object to be converted and *address* is the :c: "
630+ "expr:`void*` argument that was passed to the ``PyArg_Parse*`` function. The "
631+ "returned *status* should be ``1`` for a successful conversion and ``0`` if "
632+ "the conversion has failed. When the conversion fails, the *converter* "
633+ "function should raise an exception and leave the content of *address* "
634+ "unmodified."
636635msgstr ""
637636
638637#: c-api/arg.rst:339
@@ -646,8 +645,8 @@ msgstr ""
646645
647646#: c-api/arg.rst:345
648647msgid ""
649- "Examples of converters: :c:func:`PyUnicode_FSConverter` "
650- "and :c:func: `PyUnicode_FSDecoder`."
648+ "Examples of converters: :c:func:`PyUnicode_FSConverter` and :c:func: "
649+ "`PyUnicode_FSDecoder`."
651650msgstr ""
652651
653652#: c-api/arg.rst:348
@@ -727,8 +726,8 @@ msgstr ""
727726#: c-api/arg.rst:390
728727msgid ""
729728"The list of format units ends here; the string after the semicolon is used "
730- "as the error message *instead* of the default error message. ``:`` and "
731- "``;`` mutually exclude each other."
729+ "as the error message *instead* of the default error message. ``:`` and ``; "
730+ "`` mutually exclude each other."
732731msgstr ""
733732
734733#: c-api/arg.rst:394
@@ -779,10 +778,9 @@ msgstr ""
779778msgid ""
780779"Parse the parameters of a function that takes both positional and keyword "
781780"parameters into local variables. The *keywords* argument is a ``NULL``-"
782- "terminated array of keyword parameter names. Empty names "
783- "denote :ref:`positional-only parameters <positional-only_parameter>`. "
784- "Returns true on success; on failure, it returns false and raises the "
785- "appropriate exception."
781+ "terminated array of keyword parameter names. Empty names denote :ref:"
782+ "`positional-only parameters <positional-only_parameter>`. Returns true on "
783+ "success; on failure, it returns false and raises the appropriate exception."
786784msgstr ""
787785
788786#: c-api/arg.rst:437
@@ -891,10 +889,10 @@ msgid ""
891889"When memory buffers are passed as parameters to supply data to build "
892890"objects, as for the ``s`` and ``s#`` formats, the required data is copied. "
893891"Buffers provided by the caller are never referenced by the objects created "
894- "by :c:func:`Py_BuildValue`. In other words, if your code "
895- "invokes :c:func: `malloc` and passes the allocated memory "
896- "to :c:func:`Py_BuildValue`, your code is responsible for "
897- "calling :c:func:`free` for that memory once :c:func: `Py_BuildValue` returns."
892+ "by :c:func:`Py_BuildValue`. In other words, if your code invokes :c:func: "
893+ "`malloc` and passes the allocated memory to :c:func:`Py_BuildValue`, your "
894+ "code is responsible for calling :c:func:`free` for that memory once :c:func: "
895+ "`Py_BuildValue` returns."
898896msgstr ""
899897
900898#: c-api/arg.rst:533
@@ -1083,9 +1081,9 @@ msgid ""
10831081"Pass a Python object untouched but create a new :term:`strong reference` to "
10841082"it (i.e. its reference count is incremented by one). If the object passed in "
10851083"is a ``NULL`` pointer, it is assumed that this was caused because the call "
1086- "producing the argument found an error and set an exception. "
1087- "Therefore, :c: func:`Py_BuildValue` will return ``NULL`` but won't raise an "
1088- "exception. If no exception has been raised yet, :exc:`SystemError` is set."
1084+ "producing the argument found an error and set an exception. Therefore, :c: "
1085+ "func:`Py_BuildValue` will return ``NULL`` but won't raise an exception. If "
1086+ "no exception has been raised yet, :exc:`SystemError` is set."
10891087msgstr ""
10901088
10911089#: c-api/arg.rst:640
@@ -1114,9 +1112,9 @@ msgstr ""
11141112#: c-api/arg.rst:649
11151113msgid ""
11161114"Convert *anything* to a Python object through a *converter* function. The "
1117- "function is called with *anything* (which should be compatible "
1118- "with :c:expr: `void*`) as its argument and should return a \" new\" Python "
1119- "object, or ``NULL`` if an error occurred."
1115+ "function is called with *anything* (which should be compatible with :c:expr: "
1116+ "`void*`) as its argument and should return a \" new\" Python object, or "
1117+ "``NULL`` if an error occurred."
11201118msgstr ""
11211119
11221120#: c-api/arg.rst:655
0 commit comments