Upstream merge

2019-06-19 22:35:23 +02:00 · 2019-06-19 22:35:23 +02:00 · 1cf1d214fc
commit 1cf1d214fc
parent ffb34367c4
11 changed files with 829 additions and 714 deletions
--- a/c-api/object.po
+++ b/c-api/object.po
@ -5,7 +5,7 @@ msgid ""
 msgstr "" 
 "Project-Id-Version: Python 3.6\n" 
 "Report-Msgid-Bugs-To: \n" 
-"POT-Creation-Date: 2018-12-21 09:48+0100\n" 
+"POT-Creation-Date: 2019-06-19 22:32+0200\n" 
 "PO-Revision-Date: 2019-06-08 15:22+0200\n" 
 "Last-Translator: Julien Palard <julien@palard.fr>\n" 
 "Language-Team: FRENCH <traductions@lists.afpy.org>\n" 
@ -392,21 +392,24 @@ msgstr ""
 "argument n'est nécessaire. Si aucun argument nommé n'est nécessaire, " 
 "*kwargs* peut être égal à *NULL*." 
  
-#: ../Doc/c-api/object.rst:264 ../Doc/c-api/object.rst:275 
-#: ../Doc/c-api/object.rst:286 ../Doc/c-api/object.rst:305 
-#: ../Doc/c-api/object.rst:323 
-msgid "Returns the result of the call on success, or *NULL* on failure." 
+#: ../Doc/c-api/object.rst:264 ../Doc/c-api/object.rst:276 
+#: ../Doc/c-api/object.rst:288 ../Doc/c-api/object.rst:308 
+#: ../Doc/c-api/object.rst:327 ../Doc/c-api/object.rst:341 
+#, fuzzy 
+msgid "" 
+"Return the result of the call on success, or raise an exception and return " 
+"*NULL* on failure." 
 msgstr "" 
 "Renvoie le résultat de l'appel en cas de succès, ou *NULL* en cas d'échec." 
  
-#: ../Doc/c-api/object.rst:266 
+#: ../Doc/c-api/object.rst:267 
 msgid "" 
 "This is the equivalent of the Python expression: ``callable(*args, " 
 "**kwargs)``." 
 msgstr "" 
 "Ceci est l'équivalent de l'expression Python : ``callable(*args, **kwargs)``." 
  
-#: ../Doc/c-api/object.rst:272 
+#: ../Doc/c-api/object.rst:273 
 msgid "" 
 "Call a callable Python object *callable*, with arguments given by the tuple " 
 "*args*. If no arguments are needed, then *args* can be *NULL*." 
@ -415,11 +418,11 @@ msgstr ""
 "le tuple *args*. Si aucun argument n'est nécessaire, alors *args* peut être " 
 "égal à *NULL*." 
  
-#: ../Doc/c-api/object.rst:277 ../Doc/c-api/object.rst:288 
+#: ../Doc/c-api/object.rst:279 ../Doc/c-api/object.rst:291 
 msgid "This is the equivalent of the Python expression: ``callable(*args)``." 
 msgstr "Ceci est l'équivalent de l'expression Python : ``callable(*args)``." 
  
-#: ../Doc/c-api/object.rst:282 
+#: ../Doc/c-api/object.rst:284 
 msgid "" 
 "Call a callable Python object *callable*, with a variable number of C " 
 "arguments. The C arguments are described using a :c:func:`Py_BuildValue` " 
@ -431,78 +434,77 @@ msgstr ""
 "c:func:`Py_BuildValue`. Le format peut être *NULL*, indiquant qu'aucun " 
 "argument n'est donné." 
  
-#: ../Doc/c-api/object.rst:290 
+#: ../Doc/c-api/object.rst:293 
 msgid "" 
 "Note that if you only pass :c:type:`PyObject \\*` args, :c:func:" 
 "`PyObject_CallFunctionObjArgs` is a faster alternative." 
 msgstr "" 
  
-#: ../Doc/c-api/object.rst:293 
+#: ../Doc/c-api/object.rst:296 
 msgid "The type of *format* was changed from ``char *``." 
 msgstr "" 
  
-#: ../Doc/c-api/object.rst:299 
+#: ../Doc/c-api/object.rst:302 
 msgid "" 
 "Call the method named *name* of object *obj* with a variable number of C " 
 "arguments. The C arguments are described by a :c:func:`Py_BuildValue` " 
 "format string that should produce a tuple." 
 msgstr "" 
  
-#: ../Doc/c-api/object.rst:303 
+#: ../Doc/c-api/object.rst:306 
 msgid "The format can be *NULL*, indicating that no arguments are provided." 
 msgstr "" 
  
-#: ../Doc/c-api/object.rst:307 
+#: ../Doc/c-api/object.rst:311 
 msgid "" 
 "This is the equivalent of the Python expression: ``obj.name(arg1, " 
 "arg2, ...)``." 
 msgstr "" 
  
-#: ../Doc/c-api/object.rst:310 
+#: ../Doc/c-api/object.rst:314 
 msgid "" 
 "Note that if you only pass :c:type:`PyObject \\*` args, :c:func:" 
 "`PyObject_CallMethodObjArgs` is a faster alternative." 
 msgstr "" 
  
-#: ../Doc/c-api/object.rst:313 
+#: ../Doc/c-api/object.rst:317 
 msgid "The types of *name* and *format* were changed from ``char *``." 
 msgstr "" 
  
-#: ../Doc/c-api/object.rst:319 
+#: ../Doc/c-api/object.rst:323 
 msgid "" 
 "Call a callable Python object *callable*, with a variable number of :c:type:" 
 "`PyObject\\*` arguments. The arguments are provided as a variable number of " 
 "parameters followed by *NULL*." 
 msgstr "" 
  
-#: ../Doc/c-api/object.rst:325 
+#: ../Doc/c-api/object.rst:330 
 msgid "" 
 "This is the equivalent of the Python expression: ``callable(arg1, " 
 "arg2, ...)``." 
 msgstr "" 
  
-#: ../Doc/c-api/object.rst:331 
+#: ../Doc/c-api/object.rst:336 
 msgid "" 
 "Calls a method of the Python object *obj*, where the name of the method is " 
 "given as a Python string object in *name*. It is called with a variable " 
 "number of :c:type:`PyObject\\*` arguments. The arguments are provided as a " 
-"variable number of parameters followed by *NULL*. Returns the result of the " 
-"call on success, or *NULL* on failure." 
+"variable number of parameters followed by *NULL*." 
 msgstr "" 
  
-#: ../Doc/c-api/object.rst:342 
+#: ../Doc/c-api/object.rst:349 
 msgid "" 
 "Compute and return the hash value of an object *o*. On failure, return " 
 "``-1``. This is the equivalent of the Python expression ``hash(o)``." 
 msgstr "" 
  
-#: ../Doc/c-api/object.rst:345 
+#: ../Doc/c-api/object.rst:352 
 msgid "" 
 "The return type is now Py_hash_t. This is a signed integer the same size as " 
 "Py_ssize_t." 
 msgstr "" 
  
-#: ../Doc/c-api/object.rst:352 
+#: ../Doc/c-api/object.rst:359 
 msgid "" 
 "Set a :exc:`TypeError` indicating that ``type(o)`` is not hashable and " 
 "return ``-1``. This function receives special treatment when stored in a " 
@ -510,21 +512,21 @@ msgid ""
 "that it is not hashable." 
 msgstr "" 
  
-#: ../Doc/c-api/object.rst:360 
+#: ../Doc/c-api/object.rst:367 
 msgid "" 
 "Returns ``1`` if the object *o* is considered to be true, and ``0`` " 
 "otherwise. This is equivalent to the Python expression ``not not o``. On " 
 "failure, return ``-1``." 
 msgstr "" 
  
-#: ../Doc/c-api/object.rst:367 
+#: ../Doc/c-api/object.rst:374 
 msgid "" 
 "Returns ``0`` if the object *o* is considered to be true, and ``1`` " 
 "otherwise. This is equivalent to the Python expression ``not o``. On " 
 "failure, return ``-1``." 
 msgstr "" 
  
-#: ../Doc/c-api/object.rst:376 
+#: ../Doc/c-api/object.rst:383 
 msgid "" 
 "When *o* is non-*NULL*, returns a type object corresponding to the object " 
 "type of object *o*. On failure, raises :exc:`SystemError` and returns " 
@ -535,13 +537,13 @@ msgid ""
 "except when the incremented reference count is needed." 
 msgstr "" 
  
-#: ../Doc/c-api/object.rst:387 
+#: ../Doc/c-api/object.rst:394 
 msgid "" 
 "Return true if the object *o* is of type *type* or a subtype of *type*. " 
 "Both parameters must be non-*NULL*." 
 msgstr "" 
  
-#: ../Doc/c-api/object.rst:396 
+#: ../Doc/c-api/object.rst:403 
 msgid "" 
 "Return the length of object *o*. If the object *o* provides either the " 
 "sequence and mapping protocols, the sequence length is returned. On error, " 
@ -549,7 +551,7 @@ msgid ""
 "``len(o)``." 
 msgstr "" 
  
-#: ../Doc/c-api/object.rst:403 
+#: ../Doc/c-api/object.rst:410 
 msgid "" 
 "Return an estimated length for the object *o*. First try to return its " 
 "actual length, then an estimate using :meth:`~object.__length_hint__`, and " 
@ -557,26 +559,26 @@ msgid ""
 "equivalent to the Python expression ``operator.length_hint(o, default)``." 
 msgstr "" 
  
-#: ../Doc/c-api/object.rst:413 
+#: ../Doc/c-api/object.rst:420 
 msgid "" 
 "Return element of *o* corresponding to the object *key* or *NULL* on " 
 "failure. This is the equivalent of the Python expression ``o[key]``." 
 msgstr "" 
  
-#: ../Doc/c-api/object.rst:419 
+#: ../Doc/c-api/object.rst:426 
 msgid "" 
 "Map the object *key* to the value *v*. Raise an exception and return ``-1`` " 
 "on failure; return ``0`` on success. This is the equivalent of the Python " 
 "statement ``o[key] = v``." 
 msgstr "" 
  
-#: ../Doc/c-api/object.rst:426 
+#: ../Doc/c-api/object.rst:433 
 msgid "" 
 "Remove the mapping for the object *key* from the object *o*. Return ``-1`` " 
 "on failure. This is equivalent to the Python statement ``del o[key]``." 
 msgstr "" 
  
-#: ../Doc/c-api/object.rst:432 
+#: ../Doc/c-api/object.rst:439 
 msgid "" 
 "This is equivalent to the Python expression ``dir(o)``, returning a " 
 "(possibly empty) list of strings appropriate for the object argument, or " 
@ -586,7 +588,7 @@ msgid ""
 "`PyErr_Occurred` will return false." 
 msgstr "" 
  
-#: ../Doc/c-api/object.rst:441 
+#: ../Doc/c-api/object.rst:448 
 msgid "" 
 "This is equivalent to the Python expression ``iter(o)``. It returns a new " 
 "iterator for the object argument, or the object itself if the object is " 
--- a/c-api/structures.po
+++ b/c-api/structures.po
@ -5,7 +5,7 @@ msgid ""
 msgstr "" 
 "Project-Id-Version: Python 3.6\n" 
 "Report-Msgid-Bugs-To: \n" 
-"POT-Creation-Date: 2018-12-17 21:38+0100\n" 
+"POT-Creation-Date: 2019-06-19 22:32+0200\n" 
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" 
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" 
 "Language-Team: FRENCH <traductions@lists.afpy.org>\n" 
@ -117,82 +117,92 @@ msgstr ""
  
 #: ../Doc/c-api/structures.rst:117 
 msgid "" 
-"Type of the functions used to implement Python callables in C that take " 
-"keyword arguments: they take three :c:type:`PyObject\\*` parameters and " 
-"return one such value. See :c:type:`PyCFunction` above for the meaning of " 
-"the return value." 
+"Type of the functions used to implement Python callables in C with " 
+"signature :const:`METH_VARARGS | METH_KEYWORDS`." 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:125 
+#: ../Doc/c-api/structures.rst:123 
+msgid "" 
+"Type of the functions used to implement Python callables in C with " 
+"signature :const:`METH_FASTCALL`." 
+msgstr "" 
+  
+#: ../Doc/c-api/structures.rst:129 
+msgid "" 
+"Type of the functions used to implement Python callables in C with " 
+"signature :const:`METH_FASTCALL | METH_KEYWORDS`." 
+msgstr "" 
+  
+#: ../Doc/c-api/structures.rst:135 
 msgid "" 
 "Structure used to describe a method of an extension type. This structure " 
 "has four fields:" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:129 ../Doc/c-api/structures.rst:240 
-#: ../Doc/c-api/structures.rst:306 
+#: ../Doc/c-api/structures.rst:139 ../Doc/c-api/structures.rst:279 
+#: ../Doc/c-api/structures.rst:345 
 msgid "Field" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:129 ../Doc/c-api/structures.rst:240 
-#: ../Doc/c-api/structures.rst:306 
+#: ../Doc/c-api/structures.rst:139 ../Doc/c-api/structures.rst:279 
+#: ../Doc/c-api/structures.rst:345 
 msgid "C Type" 
 msgstr "Type C" 
  
-#: ../Doc/c-api/structures.rst:129 ../Doc/c-api/structures.rst:240 
-#: ../Doc/c-api/structures.rst:306 
+#: ../Doc/c-api/structures.rst:139 ../Doc/c-api/structures.rst:279 
+#: ../Doc/c-api/structures.rst:345 
 msgid "Meaning" 
 msgstr "Signification" 
  
-#: ../Doc/c-api/structures.rst:131 
+#: ../Doc/c-api/structures.rst:141 
 msgid ":attr:`ml_name`" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:131 ../Doc/c-api/structures.rst:139 
-#: ../Doc/c-api/structures.rst:242 ../Doc/c-api/structures.rst:255 
-#: ../Doc/c-api/structures.rst:271 ../Doc/c-api/structures.rst:308 
-#: ../Doc/c-api/structures.rst:316 
+#: ../Doc/c-api/structures.rst:141 ../Doc/c-api/structures.rst:149 
+#: ../Doc/c-api/structures.rst:281 ../Doc/c-api/structures.rst:294 
+#: ../Doc/c-api/structures.rst:310 ../Doc/c-api/structures.rst:347 
+#: ../Doc/c-api/structures.rst:355 
 msgid "const char \\*" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:131 
+#: ../Doc/c-api/structures.rst:141 
 msgid "name of the method" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:133 
+#: ../Doc/c-api/structures.rst:143 
 msgid ":attr:`ml_meth`" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:133 
+#: ../Doc/c-api/structures.rst:143 
 msgid "PyCFunction" 
 msgstr "PyCFunction" 
  
-#: ../Doc/c-api/structures.rst:133 
+#: ../Doc/c-api/structures.rst:143 
 msgid "pointer to the C implementation" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:136 
+#: ../Doc/c-api/structures.rst:146 
 msgid ":attr:`ml_flags`" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:136 ../Doc/c-api/structures.rst:244 
-#: ../Doc/c-api/structures.rst:251 ../Doc/c-api/structures.rst:267 
+#: ../Doc/c-api/structures.rst:146 ../Doc/c-api/structures.rst:283 
+#: ../Doc/c-api/structures.rst:290 ../Doc/c-api/structures.rst:306 
 msgid "int" 
 msgstr "*int*" 
  
-#: ../Doc/c-api/structures.rst:136 
+#: ../Doc/c-api/structures.rst:146 
 msgid "flag bits indicating how the call should be constructed" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:139 
+#: ../Doc/c-api/structures.rst:149 
 msgid ":attr:`ml_doc`" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:139 ../Doc/c-api/structures.rst:255 
+#: ../Doc/c-api/structures.rst:149 ../Doc/c-api/structures.rst:294 
 msgid "points to the contents of the docstring" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:143 
+#: ../Doc/c-api/structures.rst:153 
 msgid "" 
 "The :attr:`ml_meth` is a C function pointer. The functions may be of " 
 "different types, but they always return :c:type:`PyObject\\*`. If the " 
@ -202,16 +212,21 @@ msgid ""
 "implementation uses the specific C type of the *self* object." 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:150 
+#: ../Doc/c-api/structures.rst:160 
 msgid "" 
 "The :attr:`ml_flags` field is a bitfield which can include the following " 
 "flags. The individual flags indicate either a calling convention or a " 
-"binding convention. Of the calling convention flags, only :const:" 
-"`METH_VARARGS` and :const:`METH_KEYWORDS` can be combined. Any of the " 
-"calling convention flags can be combined with a binding flag." 
+"binding convention." 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:159 
+#: ../Doc/c-api/structures.rst:164 
+msgid "" 
+"There are four basic calling conventions for positional arguments and two of " 
+"them can be combined with :const:`METH_KEYWORDS` to support also keyword " 
+"arguments. So there are a total of 6 calling conventions:" 
+msgstr "" 
+  
+#: ../Doc/c-api/structures.rst:170 
 msgid "" 
 "This is the typical calling convention, where the methods have the type :c:" 
 "type:`PyCFunction`. The function expects two :c:type:`PyObject\\*` values. " 
@ -221,16 +236,40 @@ msgid ""
 "using :c:func:`PyArg_ParseTuple` or :c:func:`PyArg_UnpackTuple`." 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:169 
+#: ../Doc/c-api/structures.rst:180 
 msgid "" 
 "Methods with these flags must be of type :c:type:`PyCFunctionWithKeywords`. " 
-"The function expects three parameters: *self*, *args*, and a dictionary of " 
-"all the keyword arguments. The flag must be combined with :const:" 
-"`METH_VARARGS`, and the parameters are typically processed using :c:func:" 
-"`PyArg_ParseTupleAndKeywords`." 
+"The function expects three parameters: *self*, *args*, *kwargs* where " 
+"*kwargs* is a dictionary of all the keyword arguments or possibly *NULL* if " 
+"there are no keyword arguments. The parameters are typically processed " 
+"using :c:func:`PyArg_ParseTupleAndKeywords`." 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:178 
+#: ../Doc/c-api/structures.rst:189 
+msgid "" 
+"Fast calling convention supporting only positional arguments. The methods " 
+"have the type :c:type:`_PyCFunctionFast`. The first parameter is *self*, the " 
+"second parameter is a C array of :c:type:`PyObject\\*` values indicating the " 
+"arguments and the third parameter is the number of arguments (the length of " 
+"the array)." 
+msgstr "" 
+  
+#: ../Doc/c-api/structures.rst:195 ../Doc/c-api/structures.rst:210 
+msgid "This is not part of the :ref:`limited API <stable>`." 
+msgstr "" 
+  
+#: ../Doc/c-api/structures.rst:202 
+msgid "" 
+"Extension of :const:`METH_FASTCALL` supporting also keyword arguments, with " 
+"methods of type :c:type:`_PyCFunctionFastWithKeywords`. Keyword arguments " 
+"are passed the same way as in the vectorcall protocol: there is an " 
+"additional fourth :c:type:`PyObject\\*` parameter which is a tuple " 
+"representing the names of the keyword arguments or possibly *NULL* if there " 
+"are no keywords. The values of the keyword arguments are stored in the " 
+"*args* array, after the positional arguments." 
+msgstr "" 
+  
+#: ../Doc/c-api/structures.rst:217 
 msgid "" 
 "Methods without parameters don't need to check whether arguments are given " 
 "if they are listed with the :const:`METH_NOARGS` flag. They need to be of " 
@ -239,7 +278,7 @@ msgid ""
 "the second parameter will be *NULL*." 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:187 
+#: ../Doc/c-api/structures.rst:226 
 msgid "" 
 "Methods with a single object argument can be listed with the :const:`METH_O` " 
 "flag, instead of invoking :c:func:`PyArg_ParseTuple` with a ``\"O\"`` " 
@ -248,7 +287,7 @@ msgid ""
 "argument." 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:193 
+#: ../Doc/c-api/structures.rst:232 
 msgid "" 
 "These two constants are not used to indicate the calling convention but the " 
 "binding when use with methods of classes. These may not be used for " 
@ -256,27 +295,27 @@ msgid ""
 "any given method." 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:203 
+#: ../Doc/c-api/structures.rst:242 
 msgid "" 
 "The method will be passed the type object as the first parameter rather than " 
 "an instance of the type. This is used to create *class methods*, similar to " 
 "what is created when using the :func:`classmethod` built-in function." 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:213 
+#: ../Doc/c-api/structures.rst:252 
 msgid "" 
 "The method will be passed *NULL* as the first parameter rather than an " 
 "instance of the type. This is used to create *static methods*, similar to " 
 "what is created when using the :func:`staticmethod` built-in function." 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:217 
+#: ../Doc/c-api/structures.rst:256 
 msgid "" 
 "One other constant controls whether a method is loaded in place of another " 
 "definition with the same method name." 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:223 
+#: ../Doc/c-api/structures.rst:262 
 msgid "" 
 "The method will be loaded in place of existing definitions. Without " 
 "*METH_COEXIST*, the default is to skip repeated definitions. Since slot " 
@ -289,190 +328,190 @@ msgid ""
 "calls." 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:236 
+#: ../Doc/c-api/structures.rst:275 
 msgid "" 
 "Structure which describes an attribute of a type which corresponds to a C " 
 "struct member. Its fields are:" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:242 
+#: ../Doc/c-api/structures.rst:281 
 msgid ":attr:`name`" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:242 
+#: ../Doc/c-api/structures.rst:281 
 msgid "name of the member" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:244 
+#: ../Doc/c-api/structures.rst:283 
 msgid ":attr:`!type`" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:244 
+#: ../Doc/c-api/structures.rst:283 
 msgid "the type of the member in the C struct" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:247 
+#: ../Doc/c-api/structures.rst:286 
 msgid ":attr:`offset`" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:247 ../Doc/c-api/structures.rst:283 
+#: ../Doc/c-api/structures.rst:286 ../Doc/c-api/structures.rst:322 
 msgid "Py_ssize_t" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:247 
+#: ../Doc/c-api/structures.rst:286 
 msgid "" 
 "the offset in bytes that the member is located on the type's object struct" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:251 
+#: ../Doc/c-api/structures.rst:290 
 msgid ":attr:`flags`" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:251 
+#: ../Doc/c-api/structures.rst:290 
 msgid "flag bits indicating if the field should be read-only or writable" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:255 
+#: ../Doc/c-api/structures.rst:294 
 msgid ":attr:`doc`" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:259 
+#: ../Doc/c-api/structures.rst:298 
 msgid "" 
 ":attr:`!type` can be one of many ``T_`` macros corresponding to various C " 
 "types. When the member is accessed in Python, it will be converted to the " 
 "equivalent Python type." 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:264 
+#: ../Doc/c-api/structures.rst:303 
 msgid "Macro name" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:264 
+#: ../Doc/c-api/structures.rst:303 
 msgid "C type" 
 msgstr "Type C" 
  
-#: ../Doc/c-api/structures.rst:266 
+#: ../Doc/c-api/structures.rst:305 
 msgid "T_SHORT" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:266 
+#: ../Doc/c-api/structures.rst:305 
 msgid "short" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:267 
+#: ../Doc/c-api/structures.rst:306 
 msgid "T_INT" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:268 
+#: ../Doc/c-api/structures.rst:307 
 msgid "T_LONG" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:268 
+#: ../Doc/c-api/structures.rst:307 
 msgid "long" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:269 
+#: ../Doc/c-api/structures.rst:308 
 msgid "T_FLOAT" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:269 
+#: ../Doc/c-api/structures.rst:308 
 msgid "float" 
 msgstr "*float*" 
  
-#: ../Doc/c-api/structures.rst:270 
+#: ../Doc/c-api/structures.rst:309 
 msgid "T_DOUBLE" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:270 
+#: ../Doc/c-api/structures.rst:309 
 msgid "double" 
 msgstr "double" 
  
-#: ../Doc/c-api/structures.rst:271 
+#: ../Doc/c-api/structures.rst:310 
 msgid "T_STRING" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:272 
+#: ../Doc/c-api/structures.rst:311 
 msgid "T_OBJECT" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:272 ../Doc/c-api/structures.rst:273 
+#: ../Doc/c-api/structures.rst:311 ../Doc/c-api/structures.rst:312 
 msgid "PyObject \\*" 
 msgstr "PyObject \\*" 
  
-#: ../Doc/c-api/structures.rst:273 
+#: ../Doc/c-api/structures.rst:312 
 msgid "T_OBJECT_EX" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:274 
+#: ../Doc/c-api/structures.rst:313 
 msgid "T_CHAR" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:274 ../Doc/c-api/structures.rst:275 
-#: ../Doc/c-api/structures.rst:280 
+#: ../Doc/c-api/structures.rst:313 ../Doc/c-api/structures.rst:314 
+#: ../Doc/c-api/structures.rst:319 
 msgid "char" 
 msgstr "char" 
  
-#: ../Doc/c-api/structures.rst:275 
+#: ../Doc/c-api/structures.rst:314 
 msgid "T_BYTE" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:276 
+#: ../Doc/c-api/structures.rst:315 
 msgid "T_UBYTE" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:276 
+#: ../Doc/c-api/structures.rst:315 
 msgid "unsigned char" 
 msgstr "``unsigned char``" 
  
-#: ../Doc/c-api/structures.rst:277 
+#: ../Doc/c-api/structures.rst:316 
 msgid "T_UINT" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:277 
+#: ../Doc/c-api/structures.rst:316 
 msgid "unsigned int" 
 msgstr "``unsigned int``" 
  
-#: ../Doc/c-api/structures.rst:278 
+#: ../Doc/c-api/structures.rst:317 
 msgid "T_USHORT" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:278 
+#: ../Doc/c-api/structures.rst:317 
 msgid "unsigned short" 
 msgstr "``unsigned short``" 
  
-#: ../Doc/c-api/structures.rst:279 
+#: ../Doc/c-api/structures.rst:318 
 msgid "T_ULONG" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:279 
+#: ../Doc/c-api/structures.rst:318 
 msgid "unsigned long" 
 msgstr "``unsigned long``" 
  
-#: ../Doc/c-api/structures.rst:280 
+#: ../Doc/c-api/structures.rst:319 
 msgid "T_BOOL" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:281 
+#: ../Doc/c-api/structures.rst:320 
 msgid "T_LONGLONG" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:281 
+#: ../Doc/c-api/structures.rst:320 
 msgid "long long" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:282 
+#: ../Doc/c-api/structures.rst:321 
 msgid "T_ULONGLONG" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:282 
+#: ../Doc/c-api/structures.rst:321 
 msgid "unsigned long long" 
 msgstr "``unsigned long long``" 
  
-#: ../Doc/c-api/structures.rst:283 
+#: ../Doc/c-api/structures.rst:322 
 msgid "T_PYSSIZET" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:286 
+#: ../Doc/c-api/structures.rst:325 
 msgid "" 
 ":c:macro:`T_OBJECT` and :c:macro:`T_OBJECT_EX` differ in that :c:macro:" 
 "`T_OBJECT` returns ``None`` if the member is *NULL* and :c:macro:" 
@ -482,7 +521,7 @@ msgid ""
 "than :c:macro:`T_OBJECT`." 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:293 
+#: ../Doc/c-api/structures.rst:332 
 msgid "" 
 ":attr:`flags` can be ``0`` for write and read access or :c:macro:`READONLY` " 
 "for read-only access. Using :c:macro:`T_STRING` for :attr:`type` implies :c:" 
@ -491,87 +530,87 @@ msgid ""
 "are set to *NULL*)." 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:302 
+#: ../Doc/c-api/structures.rst:341 
 msgid "" 
 "Structure to define property-like access for a type. See also description of " 
 "the :c:member:`PyTypeObject.tp_getset` slot." 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:308 
+#: ../Doc/c-api/structures.rst:347 
 msgid "name" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:308 
+#: ../Doc/c-api/structures.rst:347 
 msgid "attribute name" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:310 
+#: ../Doc/c-api/structures.rst:349 
 msgid "get" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:310 
+#: ../Doc/c-api/structures.rst:349 
 msgid "getter" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:310 
+#: ../Doc/c-api/structures.rst:349 
 msgid "C Function to get the attribute" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:312 
+#: ../Doc/c-api/structures.rst:351 
 msgid "set" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:312 
+#: ../Doc/c-api/structures.rst:351 
 msgid "setter" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:312 
+#: ../Doc/c-api/structures.rst:351 
 msgid "" 
 "optional C function to set or delete the attribute, if omitted the attribute " 
 "is readonly" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:316 
+#: ../Doc/c-api/structures.rst:355 
 msgid "doc" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:316 
+#: ../Doc/c-api/structures.rst:355 
 msgid "optional docstring" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:318 
+#: ../Doc/c-api/structures.rst:357 
 msgid "closure" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:318 
+#: ../Doc/c-api/structures.rst:357 
 msgid "void \\*" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:318 
+#: ../Doc/c-api/structures.rst:357 
 msgid "" 
 "optional function pointer, providing additional data for getter and setter" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:323 
+#: ../Doc/c-api/structures.rst:362 
 msgid "" 
 "The ``get`` function takes one :c:type:`PyObject\\*` parameter (the " 
 "instance) and a function pointer (the associated ``closure``)::" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:328 
+#: ../Doc/c-api/structures.rst:367 
 msgid "" 
 "It should return a new reference on success or *NULL* with a set exception " 
 "on failure." 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:331 
+#: ../Doc/c-api/structures.rst:370 
 msgid "" 
 "``set`` functions take two :c:type:`PyObject\\*` parameters (the instance " 
 "and the value to be set) and a function pointer (the associated " 
 "``closure``)::" 
 msgstr "" 
  
-#: ../Doc/c-api/structures.rst:336 
+#: ../Doc/c-api/structures.rst:375 
 msgid "" 
 "In case the attribute should be deleted the second parameter is *NULL*. " 
 "Should return ``0`` on success or ``-1`` with a set exception on failure."