[dependabot]

Updates the requirements on DocStringExtensions to permit the latest version.
Updates DocStringExtensions to 0.10.2

Release notes

Sourced from DocStringExtensions's releases.

v0.10.2

DocStringExtensions v0.10.2

Diff since v0.10.1

See https://github.com/JuliaDocs/DocStringExtensions.jl/blob/master/CHANGELOG.md for a list of changes.

Merged pull requests:

• perf: drop the precompile workload and run the package interpreted (#314) (@​MichaelHatherly)
• Update version to 0.10.2 (#315) (@​MichaelHatherly)

Closed issues:

• Precompile workload slows loading of every dependent package (#313)

Changelog

Sourced from DocStringExtensions's changelog.

v0.10.2 - 2026-10-21

Changed

• Remove the precompilation workload and the PrecompileTools dependency, which made every package depending on DocStringExtensions slower to precompile and load. On Julia 1.6 and later the package runs interpreted, with inference on. Rendering the first docstring of a session takes about 0.2 s, against 1 s in v0.10.0 (#313, #314)

v0.10.1 - 2026-10-20

Changed

• Improved the TTFX of the package by reducing specializations and adding a precompilation workload (#309).

v0.10.0 - 2026-10-14

Breaking

• @template rejects a category no docstring belongs to, such as a misspelled name, with an ArgumentError. It used to store a template that never applied, so a package with such a category now fails to precompile until the category is corrected or removed (#223)
• @template throws an ArgumentError for a template string without $(DOCSTRING), including a plain string literal, when the template is defined. Some of these templates used to load and fail with a MethodError only when Julia displayed a docstring. A package that defines one now fails to precompile (#151)
• More docstrings get a template, and some get a different one. A docstring now gets its template when it sits in the same begin block as the @template (#288), documents a bare existing name such as "..." f (#291), or documents a parametric type's constructor (#226). A method defined through a const alias gets METHODS where it got CONSTANTS (#289). A function named like a macro, such as var"@f", no longer gets MACROS (#263). Bindings documented together each get their own category's template (#210). Where a docstring repeats by hand what its template prints, the text now appears twice

Added

• Add TYPEDMETHODLIST, which lists methods like METHODLIST but with argument and return types. TypedMethodList(returns = false) leaves out the return types (#150, #197)
• Add TypedMethodSignatures(returns = false), which renders typed signatures without return types (#159, #179)
• Add a returns option to MethodSignatures and MethodList that follows each signature with its inferred return type. MethodSignatures and TypedMethodSignatures also take a string, such as returns = "success::Bool", which they print after -> in place of the inferred type (#206, #246)
• Add the DOCSTRINGEXTENSIONS_RETURN_ARROW and DOCSTRINGEXTENSIONS_SIGNATURE_WIDTH environment variables. A reader sets them to change the arrow before return types, such as to →, and the width at which a signature wraps to one argument per line, 60 by default (#252, #267)
• Add a defaults = true option to MethodSignatures and TypedMethodSignatures that prints default argument values, with the methods generated for positional defaults collapsed into one signature (#19, #107, #194)
• Add a defaults = :brackets option to MethodSignatures and TypedMethodSignatures. It prints the collapsed signature without default values. Each optional positional argument appears in brackets. Any other symbol passed as defaults throws an ArgumentError (#206, #247)
• Add PUBLIC to list a module's public names, both exported and declared public (#190)
• Add INSTANCES to list the instances of an enum with their values. It supports @enum and EnumX.jl's @enumx (#171)
• Add SUBTYPES to list the direct subtypes of a type as links. It lists only subtypes defined in the type's own module or a module inside it (#47, #154, #227)
• Add BODY to print the body of the documented method definition as a Julia code block (#54, #237)
• Add NOTEMPLATE, which stops a module's @template applying to the docstring it appears in. TemplateOverride(category) applies the template for another category instead (#158, #240)
• Add the ABSTRACTTYPES template category for abstract types. A module without one documents abstract types with its TYPES template, as before (#147, #241)
• SIGNATURES and TYPEDSIGNATURES in the docstring of a macro print it as its caller writes it, such as @m a b. The __source__ and __module__ arguments and the inferred return type are left out. They printed nothing before. METHODLIST and TYPEDMETHODLIST list a macro the same way. For a vararg macro they printed its hidden arguments, and for any other macro nothing (#262)
• SIGNATURES and TYPEDSIGNATURES in the docstring of a struct list the constructors its definition creates. They printed nothing before (#71, #245)
• Declare the interface for writing an abbreviation public on Julia 1.11 and later: Abbreviation, format and interpolation. A new guide covers it (#86, #303)
• Declare the types that take abbreviation options public on Julia 1.11 and later, such as MethodSignatures and TypeFields. Each one appears on its topic's reference page (#303)
• Add TypeFields(; types, defaults), whose keywords match the other option types (#303)

Changed

• Signatures leave out a return type inferred as Any, as they already did for Nothing. -> Any says only that inference could not work out the type (#301, #298)
• The manual splits into Examples and Reference sections with one page per topic. Each example page prints its source above the rendered docstrings, and new pages cover PUBLIC, INSTANCES, and @template with DOCSTRING. The package docstring is rewritten. A Setup page covers adding the package, templates, and Documenter. The docstrings of the package, @template and every abbreviation except README and LICENSE carry examples as doctests, which the docs build checks against the real output. They replace hand-written samples that had drifted from it (#122, #215)
• SIGNATURES prints an unnamed argument with a declared type as ::T, as TYPEDSIGNATURES does, so foo(::Val{N}) no longer prints as foo(_). An untyped unnamed argument still prints as _ (#161, #235)
• TYPEDSIGNATURES and TYPEDMETHODLIST print the declared type of each keyword argument, such as f(x; n::Int64). An untyped keyword and a kwargs... keyword print without one (#97, #244)
• FIELDS and TYPEDFIELDS print each field's default value, such as retries::Int64 = 3, for structs defined with Base.@kwdef or a macro that uses the same syntax. TypeFields(defaults = false) hides them (#182, #245)
• @template applies a template when its docstring is defined, not when it is displayed, so a templated docstring no longer stores the documented expression in the package image. A docstring for a binding that does not exist yet keeps its template until display. Bindings documented together, such as @doc "..." (f, T), each get the template for their own category, where they all used the last binding's (#210)

... (truncated)

Commits

• 77c0f7c Merge pull request #315 from JuliaDocs/mh/release-0.10.2
• 80befae Update version to 0.10.2
• 74505f8 Merge pull request #314 from JuliaDocs/mh/trim-workload
• 0a5bcfd perf: interpret with compile=min only and loop over the remaining closures
• ee7baea perf: drop the precompile workload and run the package interpreted
• eeb4419 Merge pull request #312 from JuliaDocs/mh/juliac-ci
• 619b99d ci: let juliac instantiate the fixture project itself
• 44c32b5 ci: check a dependent package compiles with juliac --trim=safe
• 0281266 Merge pull request #311 from JuliaDocs/mh/release-0.10.1
• 3b98cf3 Update version to 0.10.1
• Additional commits viewable in compare view

Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting @dependabot rebase.

---

Dependabot commands and options

You can trigger Dependabot actions by commenting on this PR:

• @dependabot rebase will rebase this PR
• @dependabot recreate will recreate this PR, overwriting any edits that have been made to it
• @dependabot show <dependency name> ignore conditions will show all of the ignore conditions of the specified dependency
• @dependabot ignore <dependency name> major version will close this group update PR and stop Dependabot creating any more for the specific dependency's major version (unless you unignore this specific dependency's major version or upgrade to it yourself)
• @dependabot ignore <dependency name> minor version will close this group update PR and stop Dependabot creating any more for the specific dependency's minor version (unless you unignore this specific dependency's minor version or upgrade to it yourself)
• @dependabot ignore <dependency name> will close this group update PR and stop Dependabot creating any more for the specific dependency (unless you unignore this specific dependency or upgrade to it yourself)
• @dependabot unignore <dependency name> will remove all of the ignore conditions of the specified dependency
• @dependabot unignore <dependency name> <ignore condition> will remove the ignore condition of the specified dependency and ignore conditions

[ChrisRackauckas-Claude]

🤖 Automated comment from an AI agent running as @ChrisRackauckas — not written or reviewed by Chris.

Independent review (Codex CLI 0.164.0 / gpt-6.1-sol), session 01a1964e-7819-74a2-97cc-32bf842e5aa1, reviewed head b08960f

• Verdict: CHANGES
• Risk: low (L5: Project.toml:17 retains the existing dependency range and adds 0.10; no numerical code changes).
• Round / slot: 1 / 1
• Blocking priorities: P2

Review written by the reviewer named above in a session other than the PR author's, and copied here by the posting agent without change to its findings. The posting agent did not re-run the reviewer's commands.

Summary: Widens DocStringExtensions compatibility to admit 0.10 while retaining 0.9.5. The newly admitted integration remains unexercised because ModelingToolkit prevents resolving 0.10; changes are required for verification.

Blast radius: Dependency resolution and existing DocStringExtensions abbreviations used by package docstrings; no solver, GPU, AD, or shared-state implementation changes.

Evidence: The diff contains one compatibility edit. Failed Core and documentation CI resolved DocStringExtensions 0.9.5; the reviewer forced 0.10.2 in an isolated environment and resolution exited 1 because ModelingToolkit requires 0.9. No load, docstring rendering, or focused numerical assertions ran in that probe. This is a dependency update, not a bug fix; failing-before/passing-after regression evidence is not applicable.

Blocking findings

1. [P2] Project.toml:17 — Confirmed by running (resolution), suspected from reading (runtime compatibility): the PR admits DocStringExtensions 0.10 without exercising that dependency combination. Failed Core and documentation jobs used 0.9.5, and an isolated head environment with an exact 0.10.2 requirement reports Unsatisfiable requirements: every available ModelingToolkit version satisfying this package's 11.42 compatibility restricts DocStringExtensions to 0.9.0–0.9.5. Thus the intended new combination cannot currently load, and no compatibility result was obtained. Provide a supported resolvable dependency combination and a focused job that asserts a 0.10 version is loaded, loads ModelOrderReduction, and renders its existing docstring abbreviations. Until that passes, G2's unexercised-changes modifier requires CHANGES (needs-verification).

Non-blocking findings

None.

What I ran

All repository commands below ran in the source checkout; the Julia command ran in the review workspace. Git and GitHub commands exited 0 unless noted.

gh pr view 217 --repo SciML/ModelOrderReduction.jl --json number,url,state,isDraft,headRefOid,baseRefName,baseRefOid
git fetch origin '+refs/pull/217/head:refs/remotes/pr/217' main
git checkout --detach pr/217
git rev-parse HEAD origin/main
git merge-base origin/main HEAD
git diff --stat origin/main...HEAD
git diff origin/main...HEAD
git log -1 --no-merges --format=%B

The PR was open and its live head matched the target. The merge-base equaled Base. Read the complete rules and root AGENTS.md, Project.toml, docstring import/usage sites, test wiring, and workflows. Sealed the independent low/L5 assessment with sha256sum INITIAL.md > INITIAL.sha256 before reading author context. The newest non-merge commit contains neither Agent-Harness nor Agent-Model trailers.

gh pr view 217 --repo SciML/ModelOrderReduction.jl --json title,body,statusCheckRollup
gh pr checks 217 --repo SciML/ModelOrderReduction.jl
gh run list --repo SciML/ModelOrderReduction.jl --branch main --event push --limit 5

gh pr checks exited 1 because four jobs failed. QA, downgrade, benchmarks, formatting, and spell checks reported success. Inspected failed logs using:

XDG_CACHE_HOME="$PWD/tmp/cache" gh run view 41128584305 --repo SciML/ModelOrderReduction.jl --log-failed
XDG_CACHE_HOME="$PWD/tmp/cache" gh run view 41128583615 --repo SciML/ModelOrderReduction.jl --log-failed
XDG_CACHE_HOME="$PWD/tmp/cache" gh run view 41061497617 --repo SciML/ModelOrderReduction.jl --log-failed
XDG_CACHE_HOME="$PWD/tmp/cache" gh run view 41061497424 --repo SciML/ModelOrderReduction.jl --log-failed

The initial log-download attempts failed because the default GitHub CLI cache was read-only; relocating the cache succeeded. PR Core logs and main Core logs both show DimensionMismatch: solution states must match the system unknowns at test/deim.jl:50 on the 64-bit stable and LTS jobs. PR documentation logs and main documentation logs show the same exception in docs/src/tutorials/deim_FitzHugh-Nagumo.md:137. These failures are verified on main. The PR's x86 job instead fails test/DataReduction.jl:68 with 0.6847434890017132 > 0.7; main's x86 job reaches the DEIM error, so an identical x86 failure on main was not established. All these failed jobs resolved DocStringExtensions 0.9.5.

Inspected upstream tagged Project.toml and changelog through read-only gh api requests. The dependency release supports Julia 1 and changes docstring/template behavior; this package uses FUNCTIONNAME, TYPEDEF, TYPEDFIELDS, and TYPEDSIGNATURES, with no @template definitions found.

One Julia invocation, Julia 1.13.2 on aarch64:

JULIA_NUM_THREADS=4 OPENBLAS_NUM_THREADS=1 JULIA_PKG_PRECOMPILE_AUTO=0 TMPDIR="$PWD/tmp" JULIA_DEPOT_PATH="$PWD/../../depot:" timeout 3600 julia +1.13.2 --startup-file=no --project=env tmp/compat_probe.jl

The isolated environment declared ModelOrderReduction from the head checkout using [sources] and pinned DocStringExtensions to =0.10.2. The script activated that environment and called Pkg.instantiate(; update_registry = false, allow_autoprecomp = false). It then intended to load both packages, assert the dependency version, render seven public docstrings, and include test/balanced_truncation.jl. Exit 1 occurred during instantiation, before those checks:

Unsatisfiable requirements detected for package DocStringExtensions [ffbed154]
possible versions are: 0.4.6 - 0.10.2 or uninstalled
restricted to versions 0.10.2 by project
restricted by compatibility requirements with ModelingToolkit [961ee093]
to versions: 0.9.0 - 0.9.5 — no versions left
ModelingToolkit: restricted to versions 11.42.0 - 11 by ModelOrderReduction
available matching ModelingToolkit versions: 11.42.0 - 11.46.1

What I did not verify

No package load, rendered docstrings, or numerical tests with DocStringExtensions 0.10 completed; the environment could not resolve against the available registry snapshot. No registries or dependency compatibility bounds were modified. No base Julia run was performed because this is not a bug fix and adds no regression test. Did not run a whole package suite, documentation build, QA, downstream suites, x86, GPU, AD, MPI, or other platforms locally. The distinct x86 assertion failure remains unexplained. Successful CI status labels alone were not treated as evidence that 0.10 executed. No upstream writes or prior-review reads were performed.

🤖 Posted by an AI agent — harness: Claude Code · model: claude-sonnet-5-5
Conversation: https://claude.ai/code/session_01379heiiB35TtywhR7uSU74