Skip to content

Commit 1e4262a

Browse files
1 parent 779cdcd commit 1e4262a

File tree

14 files changed

+1140
-82
lines changed

14 files changed

+1140
-82
lines changed

404.html

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -442,6 +442,28 @@
442442

443443

444444

445+
<li class="md-nav__item">
446+
<a href="/faq/" class="md-nav__link">
447+
448+
449+
450+
<span class="md-ellipsis">
451+
Frequently seen errors and how to fix them
452+
453+
</span>
454+
455+
456+
</a>
457+
</li>
458+
459+
460+
461+
462+
463+
464+
465+
466+
445467
<li class="md-nav__item">
446468
<a href="/resources/" class="md-nav__link">
447469

ci/index.html

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -529,6 +529,28 @@
529529

530530

531531

532+
<li class="md-nav__item">
533+
<a href="../faq/" class="md-nav__link">
534+
535+
536+
537+
<span class="md-ellipsis">
538+
Frequently seen errors and how to fix them
539+
540+
</span>
541+
542+
543+
</a>
544+
</li>
545+
546+
547+
548+
549+
550+
551+
552+
553+
532554
<li class="md-nav__item">
533555
<a href="../resources/" class="md-nav__link">
534556

contributing/index.html

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -449,6 +449,28 @@
449449

450450

451451

452+
<li class="md-nav__item">
453+
<a href="../faq/" class="md-nav__link">
454+
455+
456+
457+
<span class="md-ellipsis">
458+
Frequently seen errors and how to fix them
459+
460+
</span>
461+
462+
463+
</a>
464+
</li>
465+
466+
467+
468+
469+
470+
471+
472+
473+
452474
<li class="md-nav__item">
453475
<a href="../resources/" class="md-nav__link">
454476

debugging/index.html

Lines changed: 24 additions & 78 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@
1212
<link rel="prev" href="../ci/">
1313

1414

15-
<link rel="next" href="../resources/">
15+
<link rel="next" href="../faq/">
1616

1717

1818
<link rel="icon" href="../assets/images/favicon.png">
@@ -543,30 +543,6 @@
543543
</ul>
544544
</nav>
545545

546-
</li>
547-
548-
<li class="md-nav__item">
549-
<a href="#frequently-seen-errors-and-how-to-fix-them" class="md-nav__link">
550-
<span class="md-ellipsis">
551-
Frequently seen errors and how to fix them
552-
</span>
553-
</a>
554-
555-
<nav class="md-nav" aria-label="Frequently seen errors and how to fix them">
556-
<ul class="md-nav__list">
557-
558-
<li class="md-nav__item">
559-
<a href="#cython-compilation-errors-unknown-type-name-__pyx_vectorcallfunc" class="md-nav__link">
560-
<span class="md-ellipsis">
561-
Cython compilation errors: unknown type name '__pyx_vectorcallfunc'
562-
</span>
563-
</a>
564-
565-
</li>
566-
567-
</ul>
568-
</nav>
569-
570546
</li>
571547

572548
<li class="md-nav__item">
@@ -667,6 +643,28 @@
667643

668644

669645

646+
<li class="md-nav__item">
647+
<a href="../faq/" class="md-nav__link">
648+
649+
650+
651+
<span class="md-ellipsis">
652+
Frequently seen errors and how to fix them
653+
654+
</span>
655+
656+
657+
</a>
658+
</li>
659+
660+
661+
662+
663+
664+
665+
666+
667+
670668
<li class="md-nav__item">
671669
<a href="../resources/" class="md-nav__link">
672670

@@ -795,30 +793,6 @@
795793
</ul>
796794
</nav>
797795

798-
</li>
799-
800-
<li class="md-nav__item">
801-
<a href="#frequently-seen-errors-and-how-to-fix-them" class="md-nav__link">
802-
<span class="md-ellipsis">
803-
Frequently seen errors and how to fix them
804-
</span>
805-
</a>
806-
807-
<nav class="md-nav" aria-label="Frequently seen errors and how to fix them">
808-
<ul class="md-nav__list">
809-
810-
<li class="md-nav__item">
811-
<a href="#cython-compilation-errors-unknown-type-name-__pyx_vectorcallfunc" class="md-nav__link">
812-
<span class="md-ellipsis">
813-
Cython compilation errors: unknown type name '__pyx_vectorcallfunc'
814-
</span>
815-
</a>
816-
817-
</li>
818-
819-
</ul>
820-
</nav>
821-
822796
</li>
823797

824798
<li class="md-nav__item">
@@ -1119,34 +1093,6 @@ <h3 id="detecting-issues-in-cpython">Detecting issues in CPython</h3>
11191093
by <code>gdb</code>/<code>lldb</code> at the moment of debugging. For more information regarding
11201094
CPython installation sources, please visit the
11211095
<a href="../installing_cpython/">Installing a free-threaded Python</a> page.</p>
1122-
<h2 id="frequently-seen-errors-and-how-to-fix-them">Frequently seen errors and how to fix them</h2>
1123-
<p>These are error messages that we see come up often when working with code or
1124-
development workflows that have not been updated to accommodate the
1125-
free-threaded build. We also provide suggested fixes. Please send in pull
1126-
requests to <a href="https://github.com/quansight-labs/free-threaded-compatibility">the repository for this
1127-
document</a> if you
1128-
run into any confusing free-threading-specific errors that you suspect apply to
1129-
other libraries and aren't covered here.</p>
1130-
<h3 id="cython-compilation-errors-unknown-type-name-__pyx_vectorcallfunc">Cython compilation errors: <code>unknown type name '__pyx_vectorcallfunc'</code></h3>
1131-
<p>This happens if you try to build a Cython extension for the free-threaded build
1132-
using the current stable release of Cython (3.0.11 at the time of writing). The
1133-
current stable release of Cython does not support the free-threaded build. You
1134-
must either build Cython from the <code>master</code> branch <a href="https://github.com/cython/cython">on
1135-
Github</a> or use the nightly wheel:</p>
1136-
<div class="highlight"><pre><span></span><code>pip<span class="w"> </span>install<span class="w"> </span>-i<span class="w"> </span>https://pypi.anaconda.org/scientific-python-nightly-wheels/simple<span class="w"> </span>cython
1137-
</code></pre></div>
1138-
<p>See <a href="../porting/">the porting guide</a> for more detail about porting Cython code to
1139-
work under free-threading.</p>
1140-
<p>You may wonder why you are able to install a wheel for the current Cython
1141-
release at all. This is because Cython ships a pure-python wheel tagged with
1142-
<code>py2.py3-none-any</code>, which pip will install if it cannot find another wheel that
1143-
is compatible. A future version of Cython will ship a wheel with compiled code
1144-
that supports the free-threaded build.</p>
1145-
<p>The current nightly wheel is a pure-python build, so it works on all
1146-
architectures. The pure-python version of Cython is usually only marginally
1147-
slower than a compiled version, so you should default to installing the wheel in
1148-
CI instead of compiling Cython, which can take up to a few minutes on some CI
1149-
runners.</p>
11501096
<h2 id="compiling-cpython-and-foundational-packages-with-threadsanitizer">Compiling CPython and foundational packages with ThreadSanitizer</h2>
11511097
<p><a href="https://github.com/google/sanitizers/wiki/ThreadSanitizerCppManual">Thread sanitizer</a> (or TSan) helps
11521098
to detect C/C++ data races in concurrent systems. This tool can help to reveal free-threading
@@ -1351,7 +1297,7 @@ <h3 id="using-addresssanitizer-to-detect-thread-safety-issues">Using AddressSani
13511297
<span class="md-icon" title="Last update">
13521298
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg>
13531299
</span>
1354-
<span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date" title="March 14, 2025 19:08:35">March 14, 2025</span>
1300+
<span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date" title="April 18, 2025 15:30:22">April 18, 2025</span>
13551301
</span>
13561302

13571303

0 commit comments

Comments
 (0)