Skip to content

Fix the no_std rustdoc links, and build the no_std docs in CI - #1643

Merged
cberner merged 1 commit into
masterfrom
claude/sweet-hypatia-m4vct7-no-std-docs
Nov 9, 2026
Merged

cberner merged 1 commit into
masterfrom
claude/sweet-hypatia-m4vct7-no-std-docs

Conversation

@cberner

@cberner cberner commented Nov 9, 2026 •

Copy link
Copy Markdown
Owner

cargo doc --target thumbv7em-none-eabihf --no-default-features --features experimental-api-5 reported 25 unresolved intra-doc links. No build generated these docs, so the count only grew. This fixes all of them and adds that build to CI with warnings denied.

The 25 links:

  • 17 into std::collections / std::ops. BTreeMap::{entry, lower_bound, upper_bound, ...}, btree_map::{Entry, Cursor, CursorMut} and their methods, and RangeBounds now link into alloc::collections / core::ops. Those exist in both builds, so the std docs keep the same links.
    • 21 links are rewritten in total, including 4 in docs that only exist without experimental-api-5.
    • I used reference-style links ([BTreeMap::entry] in the text, with the target at the end of the doc block), so the prose lines are unchanged. The displayed text drops the std::collections:: prefix.
  • 5 std-only references in 4 places, reworded:
    • StorageBackend docs: the std::io::Error mention links by URL.
    • "cannot represent with BackendError::Io": now "with an error other than BackendError::Unsupported". That is the distinction that matters for fallback, and Io doesn't exist without std.
    • RepairSession::abort: said "the corresponding call to Builder::open or Builder::create", and misspelled "corresponding". It now says the open returns DatabaseError::RepairAborted.
    • set_check_integrity_on_open: now says the check "does not apply to read-only opens", instead of naming open_read_only.
  • 3 links in the file-specific paragraph of open_read_only_with_backend() (open_read_only rules, FileBackend, File::try_clone).
    • The FileBackend / File::try_clone paragraph is removed.
    • The sentence saying open_read_only's locking and concurrency rules also apply is kept, with the method name as plain code instead of a link.

CI and justfile: the no_std step in CI, and just build_no_std, now run that cargo doc with RUSTDOCFLAGS="--deny warnings". On master that command fails with 25 errors.

Checked:

  • cargo doc with zero warnings for no_std, std with all features, and std with default features.
  • cargo fmt.
  • clippy (default, all features, no_std).
  • The doctests.

🤖 Generated with Claude Code

https://claude.ai/code/session_01ALhxet6NP69dCfAUv8TAhR

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Nov 9, 2026 •

Copy link
Copy Markdown
Codex Review Summary: ✅ Completed

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-11-09T04:07:43.456861Z 025e6dd New commits
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 73430e6f0f

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread .github/workflows/ci.yml Resolved
Comment thread src/db.rs Resolved
@cberner
cberner force-pushed the claude/sweet-hypatia-m4vct7-no-std-docs branch from 73430e6 to a9955b0 Compare November 9, 2026 04:06
The docs built without std had 25 unresolved links. Links to BTreeMap,
its cursors and entry, and RangeBounds now point into alloc and core,
which exist in both builds. Links to std-only items are reworded, and
the file-specific details in the docs of open_read_only_with_backend()
are removed.

CI and `just build_no_std` now build the no_std docs with warnings
denied.

Assisted-by: Claude Code
Claude-Session: https://claude.ai/code/session_01ALhxet6NP69dCfAUv8TAhR
@cberner
cberner force-pushed the claude/sweet-hypatia-m4vct7-no-std-docs branch from a9955b0 to 025e6dd Compare November 9, 2026 04:06

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 025e6dd3d3

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread src/db.rs Resolved
@cberner

cberner commented Nov 9, 2026

Copy link
Copy Markdown
Owner Author

lgtm

@cberner
cberner merged commit e33cfd8 into master Nov 9, 2026
5 checks passed
@cberner
cberner deleted the claude/sweet-hypatia-m4vct7-no-std-docs branch November 9, 2026 04:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant