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 17:15 UTC on 2026-04-01

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/101-basics
quote-words/language/operators
index-entry-qw-quote-words-quote-words
language/contexts
that is a method inherited from <code>Mu</code>/type/Mu
method_item
language/control
<code>with</code>/language/control
with
<code>emit method</code>/type/Mu
method_emit
take-rw/type/Mu
routine_take-rw
language/faq
allomorph/language/glossary
Allomorph
the default value/type/Attribute
Trait_is_default
(-) infix/language/operators
infix_(-),_infix_%E2%88%96
infix_(-),_infix_%E2%88%96
DEFINITE/language/classtut
index-entry-type_object-DEFINITE-A_word_on_types
language/hashmap
allomorphs/language/glossary
Allomorph
language/intro
help/language/unicode
Entering_unicode_codepoints_and_codepoint_sequences
language/io-guide
a list indexing operation/language/operators
index-entry-array_indexing_operator-array_subscript_operator-array_indexing_operator
language/js-nutshell
« »/language/quoting
Word_quoting_with_interpolation_and_quote_protection:_«_»
language/numerics
Allomorphs/language/glossary
Allomorph
language/operators
<code>$*COLLATION</code>/language/variables
index-entry-%24*COLLATION
index-entry-$*COLLATION
interpolating quote-words operator/language/quoting
Word_quoting_with_interpolation_and_quote_protection:_«_»
language/quoting
allomorphs/language/glossary
Allomorph
unicode name/language/unicode
Entering_unicode_codepoints_and_codepoint_sequences
language/signatures
plus signlanguage/signatures
Single_argument_rule_slurpy
language/testing
<code>exits-ok</code>/type/Test
sub_exits-ok
language/traps
<code>say</code>/routine/say
(Mu)_method_say
allomorph/language/glossary
Allomorph
language/typesystem
allomorph/language/glossary
Allomorph
require/language/modules
require
language/variables
allomorphs/language/glossary
Allomorph
type/Allomorph
allomorphs/language/glossary
Allomorph
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/Str
allomorph/language/glossary
Allomorph
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/distributions/configuration-structure
<code>$?RESOURCES</code>/syntax/$?RESOURCES
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/Mu
<code>isa</code>/method/isa
<code>does</code>/method/does
type/Signature
<code>X::Cannot::Capture</code>/type/X/Cannot/Capture