Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update docs and verify infrastructure #55

Merged
merged 12 commits into from
Feb 11, 2025

Conversation

tcharding
Copy link
Member

For Core versions 19 - 25 inclusive update the rustdocs in types/src/vxy/mod.rs to match the style we introduced in v17 and v18 already. And add support to the verify` tool to check the work.

This is all version upto the latest 3.

@tcharding
Copy link
Member Author

Ha! 4,000 line diff. This is unreviewable. I rekon you should just trust me that its all docs and tooling related.

@tcharding
Copy link
Member Author

I pulled #56 out of this, they were unrelated.

Fix cut'n'pasta mistake - used v17 instead of v18.
This is a bug, I noticed the name was wrong. I don't know how we could
have caught it mechanically though.
We accidentally called `method::all_methods` twice instead of calling
`versioned::all_methods`. This means that the rustdocs method list was
not being checked for either missing or additional methods.

Fix the bug, luckily for v17 and v18 this introduces no new warnings.
Currently we naively match on `Foo` to see if the re-export exists but
this can give a false possitive if eg, `FooBar` exists.

Observe that re-exports are always followed by either a `,` or a `}` so
we can append these to the regex string.
When I added new methods for v18 I was lazy and put the at the bottom
- bad Tobin no biscuit.
Update the `types::v19` rustdocs (the SSOT for the status of v19
support). Add `Version::V19` to the `verify` crate.

Verify with `verify v19`.
Update the `types::v20` rustdocs (the SSOT for the status of v20
support). Add `Version::V20` to the `verify` crate.

Verify with `verify v20`.
Update the `types::v21` rustdocs (the SSOT for the status of v21
support). Add `Version::V21` to the `verify` crate.

Verify with `verify v21`.
Update the `types::v22` rustdocs (the SSOT for the status of v22
support). Add `Version::V22` to the `verify` crate.

Verify with `verify v22`.
Update the `types::v23` rustdocs (the SSOT for the status of v23
support). Add `Version::V23` to the `verify` crate.

Verify with `verify v23`.
Update the `types::v24` rustdocs (the SSOT for the status of v24
support). Add `Version::V24` to the `verify` crate.

Verify with `verify v24`.
Update the `types::v25` rustdocs (the SSOT for the status of v25
support). Add `Version::V25` to the `verify` crate.

Verify with `verify v25`.
@tcharding
Copy link
Member Author

I rekon you should just trust me that its all docs and tooling related.

Ooph, that's not good - this claim is false. The PR also fixes the re-exports in version specific modules e.g., types/src/v20/mod.rs. And had a random formatting change - goodness me.

I cleaned up and rebased on master. Going to merge now once CI passes.

@tcharding tcharding merged commit 74a6b44 into rust-bitcoin:master Feb 11, 2025
27 checks passed
@tcharding tcharding deleted the 02-10-verify branch February 12, 2025 21:52
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