Skip to content

Fix Kernel.SpecialForms references in Macro.Env docs - #15712

Merged
josevalim merged 1 commit into
elixir-lang:mainfrom
makoto-developer:docs/macro-env-special-forms-typo
Aug 3, 2026
Merged

Fix Kernel.SpecialForms references in Macro.Env docs#15712
josevalim merged 1 commit into
elixir-lang:mainfrom
makoto-developer:docs/macro-env-special-forms-typo

Conversation

@makoto-developer

Copy link
Copy Markdown
Contributor

The docs for Macro.Env.define_require/4, Macro.Env.define_import/4, and
Macro.Env.define_alias/4 refer to Kernel.SpecialForm.require/2,
Kernel.SpecialForm.import/2 (twice), and Kernel.SpecialForm.alias/2 — the
module name is missing the trailing "s". Since the module is called
Kernel.SpecialForms, ExDoc cannot resolve these references, so they render as
plain code spans instead of links (see e.g. the current
define_import/4 docs).

This fixes the four occurrences in lib/elixir/lib/macro/env.ex.

Found by mechanically verifying that every Mod.fun/arity reference in the
docs resolves to an existing function, macro, callback, or type.

The docs for Macro.Env.define_require/4, define_import/4, and
define_alias/4 refer to `Kernel.SpecialForm.require/2`,
`Kernel.SpecialForm.import/2`, and `Kernel.SpecialForm.alias/2`
(singular). The module is called Kernel.SpecialForms, so ExDoc
cannot resolve these references into links.

Assisted-by: Claude Code:claude-fable-5
Signed-off-by: makoto-developer <72484465+makoto-developer@users.noreply.github.com>
@josevalim
josevalim marked this pull request as ready for review August 3, 2026 08:38
@josevalim
josevalim merged commit d5f4d49 into elixir-lang:main Aug 3, 2026
@josevalim

Copy link
Copy Markdown
Member

💚 💙 💜 💛 ❤️

@makoto-developer

Copy link
Copy Markdown
Contributor Author

Thank you

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

2 participants