From 96b2221a204639cabc1be39be10c29feaceaae3e Mon Sep 17 00:00:00 2001 From: Bartosz Sokorski Date: Tue, 3 Feb 2026 22:01:01 +0100 Subject: [PATCH] PEP 583: Fix Sphinx warnings --- peps/pep-0583.rst | 17 ++--------------- 1 file changed, 2 insertions(+), 15 deletions(-) diff --git a/peps/pep-0583.rst b/peps/pep-0583.rst index 1cf0b07134a..ce8fcd51fef 100644 --- a/peps/pep-0583.rst +++ b/peps/pep-0583.rst @@ -312,7 +312,7 @@ implementers. A happens-before race that's not a sequentially-consistent race --------------------------------------------------------------- -From the POPL paper about the Java memory model [#JMM-popl]. +From the POPL paper about the Java memory model [#JMM-popl]_. Initially, ``x == y == 0``. @@ -552,7 +552,7 @@ that, and Python may not need those security guarantees anyway. Restrict reorderings instead of defining happens-before -------------------------------------------------------- -The .NET [#CLR-msdn] and x86 [#x86-model] memory models are based on +The .NET [#CLR-msdn]_ and x86 [#x86-model]_ memory models are based on defining which reorderings compilers may allow. I think that it's easier to program to a happens-before model than to reason about all of the possible reorderings of a program, and it's easier to insert @@ -784,10 +784,6 @@ References lots of examples of compiler/processor optimizations and the strange program behaviors they can produce. -.. [#Cpp0x-memory-model] N2480: A Less Formal Explanation of the - Proposed C++ Concurrency Memory Model, Hans Boehm - (http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2007/n2480.html) - .. [#CLR-msdn] Memory Models: Understand the Impact of Low-Lock Techniques in Multithreaded Apps, Vance Morrison (http://msdn2.microsoft.com/en-us/magazine/cc163715.aspx) @@ -804,15 +800,6 @@ References .. [#slots] __slots__ (http://docs.python.org/ref/slots.html) -.. [#] Alternatives to SC, a thread on the cpp-threads mailing list, - which includes lots of good examples. - (http://www.decadentplace.org.uk/pipermail/cpp-threads/2007-January/001287.html) - -.. [#safethread] python-safethread, a patch by Adam Olsen for CPython - that removes the GIL and statically guarantees that all objects - shared between threads are consistently - locked. (http://code.google.com/p/python-safethread/) - Acknowledgements ================