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

Fixed docs(rs) #365

Merged
merged 2 commits into from
Jan 7, 2022
Merged

Fixed docs(rs) #365

merged 2 commits into from
Jan 7, 2022

Conversation

Kixunil
Copy link
Collaborator

@Kixunil Kixunil commented Jan 7, 2022

Sadly, I missed two details in #353: features missing in docs.rs configuration and global-context being a bit confusing.
This PR fixes those, see commit messages for details.

These features were previously forgotten and without them the docs.rs
doc is not that great. :(
Previously only `global-context-less-secure` was shown in the doc even
though `global-context` may also work. This was strictly correct because
`global-context` implies `global-context-less-secure` which is also
documented but people could miss it or forget about it and then worry
about security or worse, enable less secure feature.

Calling out both fetures seems useful, even important and thankfully
doesn't seem to cause too much noise in the docs.
Copy link
Member

@tcharding tcharding left a comment

Choose a reason for hiding this comment

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

I built the docs with --all-features and had a brief look around. Looks good to me.

I did this ridiculously trivial patch after reviewing this PR :)

@Kixunil
Copy link
Collaborator Author

Kixunil commented Jan 7, 2022

@tcharding not sure if you know, to look how it'll be rendered on docsrs you need to set RUSTDOCFLAGS: RUSTDOCFLAGS="--cfg docsrs" cargo +nightly doc --all-features

Copy link
Member

@apoelstra apoelstra left a comment

Choose a reason for hiding this comment

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

ACK 314e875

@apoelstra apoelstra merged commit d068fd7 into rust-bitcoin:master Jan 7, 2022
@tcharding
Copy link
Member

@tcharding not sure if you know, to look how it'll be rendered on docsrs you need to set RUSTDOCFLAGS: RUSTDOCFLAGS="--cfg docsrs" cargo +nightly doc --all-features

I did not know this, thanks.

@Kixunil Kixunil deleted the fix-docsrs branch January 10, 2022 09:56
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.

3 participants