Adam Turner
f612565bd3
gh-93738: Disallow pre-v3 syntax in the C domain ( #97962 )
...
Also, disable using invalid sphinx-lint 0.6.2.
2022-10-06 10:11:37 -07:00
Adam Turner
0031e62973
gh-93738: Documentation C syntax (:c:type:<C type> -> :c:expr:<C type>) ( #97768 )
...
:c:type:`<C type>` -> :c:expr:`<C type>`
Co-authored-by: Ćukasz Langa <lukasz@langa.pl>
2022-10-05 11:01:14 -07:00
Mark Shannon
0f733fffe8
GH-95245: Document use of MANAGED flags instead of offsets. (GH-96044)
2022-08-30 16:26:08 +01:00
Ned Batchelder
3440d197a5
Docs: remove redundant "adverb-adjective" hyphens from compound modifiers (GH-94551)
...
Discussion: https://discuss.python.org/t/slight-grammar-fix-throughout-adverbs-dont-need-hyphen/17021
2022-07-05 11:16:10 +02:00
Dmitry Smirnov
454cdb99ab
bpo-45633: Fix newtypes doc typo (GH-29318)
2021-11-02 22:47:06 +08:00
Sam Gross
35e1ff38ee
bpo-28737: Document when tp_dealloc should call PyObject_GC_UnTrack() (GH-29246)
...
Objects that support garbage collection ("container" objects) should
call PyObject_GC_UnTrack() from their destructors before clearing any
fields which may point to other "container" objects.
2021-10-27 21:15:13 +02:00
Steve Dower
87655e2cf5
bpo-42800: Rename AUDIT_READ to PY_AUDIT_READ (GH-25736)
2021-04-30 01:08:55 +01:00
Ryan Hileman
9a2c2a9ec3
bpo-42800: add audit hooks for f_code and tb_frame (GH-24182)
...
Accessing the following attributes will now fire PEP 578 style audit hooks as ("object.__getattr__", obj, name):
* PyTracebackObject: tb_frame
* PyFrameObject: f_code
* PyGenObject: gi_code, gi_frame
* PyCoroObject: cr_code, cr_frame
* PyAsyncGenObject: ag_code, ag_frame
Add an AUDIT_READ attribute flag aliased to READ_RESTRICTED.
Update obsolete flag documentation.
2021-04-30 00:15:55 +01:00
Victor Stinner
a41782cc84
bpo-43774: Document configure options (GH-25283)
...
Add Doc/using/configure.rst documentation to document configure,
preprocessor, compiler and linker options.
Add a new section about the "Python debug build".
2021-04-08 22:32:21 +02:00
Serhiy Storchaka
25fc088607
bpo-38600: Change the mark up of NULL in the C API documentation. (GH-16950)
...
Replace all *NULL* with ``NULL``.
2019-10-30 12:03:20 +02:00
Jeroen Demeyer
7f41c8e0dd
bpo-37493: use _PyObject_CallNoArg in more places (GH-14575)
2019-07-04 19:35:31 +09:00
Stéphane Wirtel
cbb6484573
Doc: Replace the deprecated highlightlang directive by highlight. ( #13377 )
...
highlightlang is deprecated since April 2018 in Sphinx.
See https://github.com/sphinx-doc/sphinx/pull/4845
2019-05-17 15:25:34 +05:30
Eric Snow
9e7c92193c
bpo-17045: Improve C-API doc for PyTypeObject. (gh-7413)
...
The existing doc had a number of info gaps and was a little hard to use. This patch provides several quick-reference tables as well as examples.
2018-06-14 15:46:35 -06:00
Antoine Pitrou
1d80a56173
bpo-33201: Modernize "Extension types" doc (GH-6337)
...
* bpo-33201: Modernize "Extension types" doc
* Split tutorial and other topics
* Some small fixes
* Address some review comments
* Rename noddy* to custom* and shoddy to sublist
* Fix markup
2018-04-07 18:14:03 +02:00
Serhiy Storchaka
5bb0005f9f
Make formatting of some return codes conforming to the general style. ( #5587 )
2018-02-09 13:31:19 +02:00
Emanuele Gaifas
cdfe910e74
Extending Python Doc minor updates (GH-4518)
...
Move footnote markers to be closer to the related terminology:
before the end of the sentence, instead of after.
2017-11-24 00:49:57 -08:00
Stefan Krah
ca72589bfa
bpo-31443: Formulate the type slot initialization rules in terms of C99. ( #3688 )
2017-09-22 17:44:58 +02:00
INADA Naoki
a6296d34a4
bpo-31095: fix potential crash during GC (GH-2974)
2017-08-24 14:55:17 +09:00
UltimateCoder
8856940cf2
bpo-28315: Improve code examples in docs (GH-1372)
...
Replace
File "<stdin>", line 1, in ?
with
File "<stdin>", line 1, in <module>
2017-05-03 09:46:45 -07:00
Serhiy Storchaka
84b8e92e46
bpo-29918: Add missed "const" modifiers in C API documentation. ( #846 )
2017-03-30 10:01:03 +03:00
Serhiy Storchaka
007d7ff73f
Issue #28761 : The fields name and doc of structures PyMemberDef, PyGetSetDef,
...
PyStructSequence_Field, PyStructSequence_Desc, and wrapperbase are now of
type "const char *" rather of "char *".
2016-11-22 07:58:08 +02:00
Serhiy Storchaka
06a8dea46d
Fixed the documentation of the structure PyMethodDef.
...
The fields ml_name and ml_doc are of type "const char *" rather of "char *".
2016-11-21 11:37:18 +02:00
Serhiy Storchaka
de0574bdab
Issue #18287 : PyType_Ready() now checks that tp_name is not NULL.
...
Original patch by Niklas Koep.
2016-10-07 23:24:35 +03:00
Berker Peksag
bed6891c77
Issue #23710 : Update PyObject_HEAD documentation
...
Since PEP 3123, PyObject_HEAD only has one field named ob_base.
Users now need to use the Py_TYPE macro instead of self->ob_type.
Initial patch by Ammar Askar.
2016-08-03 12:58:49 +03:00
Martin Panter
1050d2d0c7
Issue #26462 : Doc: reduce literal_block warnings, fix syntax highlighting.
...
Patch by Julien Palard.
2016-07-26 11:18:21 +02:00
Martin Panter
36f22a2820
Issue #24808 : Merge 3.4 into 3.5; adjust new tp_as_async field
2015-08-25 05:25:21 +00:00
Martin Panter
78d5033337
Issue #24808 : Update the documentation of some PyTypeObject fields
...
Patch by Joseph Weston.
2015-08-25 05:06:39 +00:00
Yury Selivanov
f3e40fac10
Issue 24180: Documentation for PEP 492 changes.
2015-05-21 11:50:30 -04:00
R David Murray
354c7403c5
#17380 : Document tp_init return value in extending docs.
...
Patch by James Powell.
2015-04-12 21:51:36 -04:00
Serhiy Storchaka
df0db49b1b
Issue #22883 : Update PyInt to PyLong in C API example.
2015-02-17 10:18:44 +02:00
Berker Peksag
9c1dba2758
Revert #22251
2014-09-28 00:00:58 +03:00
Berker Peksag
3749404ba5
Issue #22251 : Fix ReST markup to avoid errors building docs.
2014-09-27 23:21:35 +03:00
Serhiy Storchaka
d51f42372b
Issue 19195: Improved cross-references in C API documentation.
2013-10-09 13:26:57 +03:00
Serhiy Storchaka
0b68a2d675
Issue 19195: Improved cross-references in C API documentation.
2013-10-09 13:26:17 +03:00
Antoine Pitrou
a68cbfa556
Issue #18589 : fix hyperlinking of type slots (tp_*)
2013-08-01 21:14:43 +02:00
Antoine Pitrou
39668f57f4
Issue #18589 : fix hyperlinking of type slots (tp_*)
2013-08-01 21:12:45 +02:00
Antoine Pitrou
8547a0e29b
Merge doc fix
2013-07-30 20:09:36 +02:00
Antoine Pitrou
3ab7b0aabb
Simplify example of PyErr_Fetch() use
2013-07-30 20:09:03 +02:00
Antoine Pitrou
796564c27b
Issue #18112 : PEP 442 implementation (safe object finalization).
2013-07-30 19:59:21 +02:00
Andrew Svetlov
59d6d2dbeb
#17688 : fix declaration for richcmp example in the docs.
...
Thanks to Daniel Mullner
2013-04-12 16:08:40 +03:00
Gregory P. Smith
bcd2aa6d06
cleanup references to PyString_ APIs from 2.x in the 3.3 docs.
2013-03-22 13:49:26 -07:00
Gregory P. Smith
4b52ae8f97
Clean up references to the no longer existing PyString_ APIs in our docs.
2013-03-22 13:43:30 -07:00
Chris Jerdonek
bb4e941c6d
Add a str class entry to the "Text Sequence Type" section (issue #16209 ).
...
This commit also moves the documentation for the str built-in function to
the new class entry. Links to :class:`str` now go to the class entry with
the string methods immediately afterwards.
2012-11-28 01:38:40 -08:00
Jesus Cea
494502756e
MERGE: Closes #15953 : Incorrect some fields declaration in the PyTypeObject documentation
2012-09-28 16:35:21 +02:00
Jesus Cea
33b5769db5
Closes #15953 : Incorrect some fields declaration in the PyTypeObject documentation
2012-09-28 16:34:45 +02:00
Antoine Pitrou
a6bc4b4c85
Issue #14933 : fix misleading doc about weakref support in extension types.
2012-06-15 19:12:04 +02:00
Antoine Pitrou
13775221e0
Issue #14933 : fix misleading doc about weakref support in extension types.
2012-06-15 19:11:31 +02:00
Eli Bendersky
49ac6f4492
Some corrections for the Doc/extending documentation. Closes #14129
2012-02-27 19:18:35 +02:00
Eli Bendersky
17e92cf9a6
Merge from 3.2
...
Issue #12672 : remove confusing part of sentence in documentation
2011-08-19 06:31:10 +03:00
Eli Bendersky
729a42f263
Issue #12672 : remove confusing part of sentence in documentation
2011-08-19 06:29:51 +03:00