The documentation contains many links to other websites, to other documents and to places within the same document. External websites change, and editorial changes to the documentation can affect link anchors.
This page contains information about link glitches that can be picked up programmatically.
How to help?§
Click on the web page where the link is located (a click button is provided).
Identify which link is not working by clicking on the link. An erroneous link will take you to a non-existent web page (404 error), or to the top of a file when a place inside the file is expected, or some other error.
Click on the edit button at the top of the source webpage, which takes you to the documentation source (a file with the extension
.pod6). Locate theL<link label|link target>that corresponds to the erroneous link.Work out what the mistake is, e.g., a typo, or even the absence of a previously existing site.
Change the
L<...>code to one that will cure the glitch.Create a PR in the
raku/docrepo. Make sure that the name of the PR contains something likecure link glitch. In the comment to the PR include information about how the error occurs and the suggested cure.
Types of error§
The following types of error are common (the examples are illustrations ONLY)
external the link is to an external website, e.g.
L<See this blog| https://someones.xyzzzz.org/wierd_math>local the link is to another page in the Documentation, e.g.
L<... operator | type/operators#... >internal the link is to another place in the same web-page, e.g.
L< see funky stuff | #funky_stuff >
Glitches found§
Error tests run at 00:10 UTC on 2025-10-30
Remote http/s links with bad host or 404
| Remote link test skipped | Link-error-test plugin has option no-remote set to True |
|---|
Links to non-existent interior targets
| Document with glitch | Displayed text | Document containing anchor | Attempted anchor name (variants tried) |
|---|---|---|---|
| language/contexts | |||
| that is a method inherited from <code>Mu</code> | /type/Mu | ||
| method_item | |||
| language/control | |||
| <code>with</code> | /language/control | ||
| with | |||
| take-rw | /type/Mu | ||
| routine_take-rw | |||
| <code>emit method</code> | /type/Mu | ||
| method_emit | |||
| language/faq | |||
| (-) infix | /language/operators | ||
| infix_(-),_infix_%E2%88%96 | |||
| infix_(-),_infix_%E2%88%96 | |||
| language/intro | |||
| help | /language/unicode | ||
| Entering_unicode_codepoints_and_codepoint_sequences | |||
| language/operators | |||
| <code>$*COLLATION</code> | /language/variables | ||
| index-entry-%24*COLLATION | |||
| index-entry-$*COLLATION | |||
| language/quoting | |||
| unicode name | /language/unicode | ||
| Entering_unicode_codepoints_and_codepoint_sequences | |||
| language/signatures | |||
| plus sign | language/signatures | ||
| Single_argument_rule_slurpy | |||
| language/traps | |||
| <code>say</code> | /routine/say | ||
| (Mu)_method_say | |||
| type/Any | |||
| <code>$*COLLATION</code> | /language/variables | ||
| index-entry-$*COLLATION | |||
| type/Baggy | |||
| does | /type/Mu | ||
| routine_does | |||
| type/Collation | |||
| <code>$*COLLATION</code> | /language/variables | ||
| index-entry-%24*COLLATION | |||
| index-entry-$*COLLATION | |||
| type/DateTime | |||
| <code>$*TZ</code> variable | /language/variables | ||
| index-entry-%24*TZ | |||
| index-entry-$*TZ | |||
| type/Distro | |||
| $*DISTRO | /language/variables | ||
| index-entry-%24*DISTRO | |||
| index-entry-$*DISTRO | |||
| type/Raku | |||
| $*RAKU | /language/variables | ||
| index-entry-%24*RAKU | |||
| index-entry-$*RAKU | |||
| type/Rat | |||
| <code>$*RAT-OVERFLOW</code> | /language/variables | ||
| index-entry-%24*RAT-OVERFLOW | |||
| index-entry-$*RAT-OVERFLOW | |||
| type/Scalar | |||
| flattening | /language/subscripts | ||
| index-entry-flattening_ | |||
| type/VM | |||
| $*VM | /language/variables | ||
| index-entry-%24*VM | |||
| index-entry-$*VM | |||
| type/independent-routines | |||
| <code>&*EXIT</code> | /language/variables | ||
| index-entry-%26*EXIT | |||
| index-entry-&*EXIT |
Links to missing files
| Document with glitch | Displayed text | Non-Existent target file |
|---|---|---|
| language/signatures | ||
| double semicolon <code>;;</code> | /language/Signatures | |
| multiple dispatch | /language/Functions | |
| language/typesystem | ||
| <code>X::Comp::AdHoc</code> | /type/X/Comp/AdHoc | |
| type/Baggy | ||
| <code>X::Immutable</code> | /type/X/Immutable | |
| type/Blob | ||
| <code>X::Buf::AsStr</code> | /type/X/Buf/AsStr | |
| type/IO/Handle | ||
| <code>X::IO::Flush</code> | /type/X/IO/Flush | |
| <code>X::IO::Lock</code> | /type/X/IO/Lock | |
| type/Mu | ||
| <code>does</code> | /method/does | |
| <code>isa</code> | /method/isa | |
| type/Version | ||
| <code>X::Cannot::Capture</code> | /type/X/Cannot/Capture |