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 the L<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/doc repo. Make sure that the name of the PR contains something like cure 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-09

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/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
type/Any
<code>$*COLLATION</code>/language/variables
index-entry-$*COLLATION
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>&amp;*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
multiple dispatch/language/Functions
double semicolon <code>;;</code>/language/Signatures
parameterized Roles/language/Typesystem
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::Lock</code>/type/X/IO/Lock
<code>X::IO::Flush</code>/type/X/IO/Flush
type/Signature
<code>X::Cannot::Capture</code>/type/X/Cannot/Capture