@@ -23,17 +23,17 @@ msgstr ""
2323#: c-api/arg.rst:8
2424msgid ""
2525"These functions are useful when creating your own extensions functions and "
26- "methods. Additional information and examples are available in :ref: "
27- "`extending-index`."
26+ "methods. Additional information and examples are available "
27+ "in :ref: `extending-index`."
2828msgstr ""
2929
3030#: c-api/arg.rst:12
3131msgid ""
32- "The first three of these functions described, :c:func:`PyArg_ParseTuple`, :c: "
33- "func:`PyArg_ParseTupleAndKeywords `, and :c:func:`PyArg_Parse`, all use "
34- "*format strings* which are used to tell the function about the expected "
35- "arguments. The format strings use the same syntax for each of these "
36- "functions."
32+ "The first three of these functions "
33+ "described, :c: func:`PyArg_ParseTuple `, :c:func:`PyArg_ParseTupleAndKeywords`, "
34+ "and :c:func:`PyArg_Parse`, all use *format strings* which are used to tell "
35+ "the function about the expected arguments. The format strings use the same "
36+ "syntax for each of these functions."
3737msgstr ""
3838
3939#: c-api/arg.rst:19
@@ -98,10 +98,10 @@ msgstr ""
9898
9999#: c-api/arg.rst:61
100100msgid ""
101- "To ensure that the underlying buffer may be safely borrowed, the object's :c: "
102- "member:`PyBufferProcs.bf_releasebuffer` field must be ``NULL``. This "
103- "disallows common mutable objects such as :class:`bytearray`, but also some "
104- "read-only objects such as :class:`memoryview` of :class:`bytes`."
101+ "To ensure that the underlying buffer may be safely borrowed, the "
102+ "object's :c: member:`PyBufferProcs.bf_releasebuffer` field must be ``NULL``. "
103+ "This disallows common mutable objects such as :class:`bytearray`, but also "
104+ "some read-only objects such as :class:`memoryview` of :class:`bytes`."
105105msgstr ""
106106
107107#: c-api/arg.rst:67
@@ -113,11 +113,11 @@ msgstr ""
113113
114114#: c-api/arg.rst:73
115115msgid ""
116- "For all ``#`` variants of formats (``s#``, ``y#``, etc.), the macro :c:macro: "
117- "`PY_SSIZE_T_CLEAN` must be defined before including :file:`Python.h`. On "
118- "Python 3.9 and older, the type of the length argument is :c:type: "
119- "`Py_ssize_t` if the :c:macro:`PY_SSIZE_T_CLEAN` macro is defined, or int "
120- "otherwise."
116+ "For all ``#`` variants of formats (``s#``, ``y#``, etc.), the "
117+ "macro :c:macro: `PY_SSIZE_T_CLEAN` must be defined before "
118+ "including :file:` Python.h`. On Python 3.9 and older, the type of the length "
119+ "argument is :c:type: `Py_ssize_t` if the :c:macro:`PY_SSIZE_T_CLEAN` macro is "
120+ "defined, or int otherwise."
121121msgstr ""
122122
123123#: c-api/arg.rst:80
@@ -138,8 +138,8 @@ msgstr ""
138138msgid ""
139139"This format does not accept :term:`bytes-like objects <bytes-like object>`. "
140140"If you want to accept filesystem paths and convert them to C character "
141- "strings, it is preferable to use the ``O&`` format with :c:func: "
142- "`PyUnicode_FSConverter` as *converter*."
141+ "strings, it is preferable to use the ``O&`` format "
142+ "with :c:func: `PyUnicode_FSConverter` as *converter*."
143143msgstr ""
144144
145145#: c-api/arg.rst:96
@@ -162,8 +162,8 @@ msgstr ""
162162
163163#: c-api/arg.rst:106
164164msgid ""
165- "``s#`` (:class:`str`, read-only :term:`bytes-like object`) [const char \\ *, : "
166- "c:type:`Py_ssize_t`]"
165+ "``s#`` (:class:`str`, read-only :term:`bytes-like object`) [const char "
166+ "\\ *, : c:type:`Py_ssize_t`]"
167167msgstr ""
168168
169169#: c-api/arg.rst:107
@@ -238,8 +238,8 @@ msgstr ""
238238
239239#: c-api/arg.rst:141
240240msgid ""
241- "``y#`` (read-only :term:`bytes-like object`) [const char \\ *, :c:type: "
242- "`Py_ssize_t`]"
241+ "``y#`` (read-only :term:`bytes-like object`) [const char "
242+ "\\ *, :c:type: `Py_ssize_t`]"
243243msgstr ""
244244
245245#: c-api/arg.rst:142
@@ -266,9 +266,9 @@ msgstr ""
266266#: c-api/arg.rst:151
267267msgid ""
268268"Requires that the Python object is a :class:`bytearray` object, without "
269- "attempting any conversion. Raises :exc:`TypeError` if the object is not a : "
270- "class:`bytearray` object. The C variable may also be declared as :c:expr: "
271- "`PyObject*`."
269+ "attempting any conversion. Raises :exc:`TypeError` if the object is not "
270+ "a : class:`bytearray` object. The C variable may also be declared "
271+ "as :c:expr: `PyObject*`."
272272msgstr ""
273273
274274#: c-api/arg.rst:155
@@ -290,8 +290,8 @@ msgstr ""
290290msgid ""
291291"This format accepts any object which implements the read-write buffer "
292292"interface. It fills a :c:type:`Py_buffer` structure provided by the caller. "
293- "The buffer may contain embedded null bytes. The caller have to call :c:func: "
294- "`PyBuffer_Release` when it is done with the buffer."
293+ "The buffer may contain embedded null bytes. The caller have to "
294+ "call :c:func: `PyBuffer_Release` when it is done with the buffer."
295295msgstr ""
296296
297297#: c-api/arg.rst:166
@@ -319,8 +319,8 @@ msgstr ""
319319msgid ""
320320":c:func:`PyArg_ParseTuple` will allocate a buffer of the needed size, copy "
321321"the encoded data into this buffer and adjust *\\ *buffer* to reference the "
322- "newly allocated storage. The caller is responsible for calling :c:func: "
323- "`PyMem_Free` to free the allocated buffer after use."
322+ "newly allocated storage. The caller is responsible for "
323+ "calling :c:func: `PyMem_Free` to free the allocated buffer after use."
324324msgstr ""
325325
326326#: c-api/arg.rst:183
@@ -338,8 +338,8 @@ msgstr ""
338338
339339#: c-api/arg.rst:188
340340msgid ""
341- "``es#`` (:class:`str`) [const char \\ *encoding, char \\ * \\ *buffer, :c:type: "
342- "`Py_ssize_t` \\ *buffer_length]"
341+ "``es#`` (:class:`str`) [const char \\ *encoding, char "
342+ "\\ * \\ *buffer, :c:type: `Py_ssize_t` \\ *buffer_length]"
343343msgstr ""
344344
345345#: c-api/arg.rst:189
@@ -419,8 +419,8 @@ msgstr ""
419419
420420#: c-api/arg.rst:233
421421msgid ""
422- "Convert a nonnegative Python integer to an unsigned tiny int, stored in a C : "
423- "c:expr:`unsigned char`."
422+ "Convert a nonnegative Python integer to an unsigned tiny int, stored in a "
423+ "C : c:expr:`unsigned char`."
424424msgstr ""
425425
426426#: c-api/arg.rst:580
@@ -572,9 +572,9 @@ msgstr ""
572572#: c-api/arg.rst:295
573573msgid ""
574574"Store a Python object (without any conversion) in a C object pointer. The C "
575- "program thus receives the actual object that was passed. A new :term: "
576- "`strong reference` to the object is not created (i.e. its reference count is "
577- "not increased). The pointer stored is not ``NULL``."
575+ "program thus receives the actual object that was passed. A "
576+ "new :term: `strong reference` to the object is not created (i.e. its "
577+ "reference count is not increased). The pointer stored is not ``NULL``."
578578msgstr ""
579579
580580#: c-api/arg.rst:301
@@ -608,12 +608,12 @@ msgstr ""
608608
609609#: c-api/arg.rst:318
610610msgid ""
611- "where *object* is the Python object to be converted and *address* is the :c: "
612- "expr:`void*` argument that was passed to the ``PyArg_Parse*`` function. The "
613- "returned *status* should be ``1`` for a successful conversion and ``0`` if "
614- "the conversion has failed. When the conversion fails, the *converter* "
615- "function should raise an exception and leave the content of *address* "
616- "unmodified."
611+ "where *object* is the Python object to be converted and *address* is "
612+ "the :c: expr:`void*` argument that was passed to the ``PyArg_Parse*`` "
613+ "function. The returned *status* should be ``1`` for a successful conversion "
614+ "and ``0`` if the conversion has failed. When the conversion fails, the "
615+ "*converter* function should raise an exception and leave the content of "
616+ "*address* unmodified."
617617msgstr ""
618618
619619#: c-api/arg.rst:324
@@ -711,8 +711,8 @@ msgstr ""
711711#: c-api/arg.rst:378
712712msgid ""
713713"The list of format units ends here; the string after the semicolon is used "
714- "as the error message *instead* of the default error message. ``:`` and ``; "
715- "`` mutually exclude each other."
714+ "as the error message *instead* of the default error message. ``:`` and "
715+ "``;`` mutually exclude each other."
716716msgstr ""
717717
718718#: c-api/arg.rst:382
@@ -763,9 +763,10 @@ msgstr ""
763763msgid ""
764764"Parse the parameters of a function that takes both positional and keyword "
765765"parameters into local variables. The *keywords* argument is a ``NULL``-"
766- "terminated array of keyword parameter names. Empty names denote :ref:"
767- "`positional-only parameters <positional-only_parameter>`. Returns true on "
768- "success; on failure, it returns false and raises the appropriate exception."
766+ "terminated array of keyword parameter names. Empty names "
767+ "denote :ref:`positional-only parameters <positional-only_parameter>`. "
768+ "Returns true on success; on failure, it returns false and raises the "
769+ "appropriate exception."
769770msgstr ""
770771
771772#: c-api/arg.rst:425
@@ -874,10 +875,10 @@ msgid ""
874875"When memory buffers are passed as parameters to supply data to build "
875876"objects, as for the ``s`` and ``s#`` formats, the required data is copied. "
876877"Buffers provided by the caller are never referenced by the objects created "
877- "by :c:func:`Py_BuildValue`. In other words, if your code invokes :c:func: "
878- "`malloc` and passes the allocated memory to :c:func:`Py_BuildValue`, your "
879- "code is responsible for calling :c:func:`free` for that memory once :c:func: "
880- "`Py_BuildValue` returns."
878+ "by :c:func:`Py_BuildValue`. In other words, if your code "
879+ "invokes :c:func: `malloc` and passes the allocated memory "
880+ "to :c:func:`Py_BuildValue`, your code is responsible for "
881+ "calling :c:func:`free` for that memory once :c:func: `Py_BuildValue` returns."
881882msgstr ""
882883
883884#: c-api/arg.rst:521
@@ -1066,9 +1067,9 @@ msgid ""
10661067"Pass a Python object untouched but create a new :term:`strong reference` to "
10671068"it (i.e. its reference count is incremented by one). If the object passed in "
10681069"is a ``NULL`` pointer, it is assumed that this was caused because the call "
1069- "producing the argument found an error and set an exception. Therefore, :c: "
1070- "func:`Py_BuildValue` will return ``NULL`` but won't raise an exception. If "
1071- "no exception has been raised yet, :exc:`SystemError` is set."
1070+ "producing the argument found an error and set an exception. "
1071+ "Therefore, :c: func:`Py_BuildValue` will return ``NULL`` but won't raise an "
1072+ "exception. If no exception has been raised yet, :exc:`SystemError` is set."
10721073msgstr ""
10731074
10741075#: c-api/arg.rst:628
@@ -1093,9 +1094,9 @@ msgstr ""
10931094#: c-api/arg.rst:637
10941095msgid ""
10951096"Convert *anything* to a Python object through a *converter* function. The "
1096- "function is called with *anything* (which should be compatible with :c:expr: "
1097- "`void*`) as its argument and should return a \" new\" Python object, or "
1098- "``NULL`` if an error occurred."
1097+ "function is called with *anything* (which should be compatible "
1098+ "with :c:expr: `void*`) as its argument and should return a \" new\" Python "
1099+ "object, or ``NULL`` if an error occurred."
10991100msgstr ""
11001101
11011102#: c-api/arg.rst:643
0 commit comments