Skip to content

Add missing rustdoc comments; enable missing_docs lint - #216

Merged
tarcieri merged 1 commit into
masterfrom
fix-missing-docs-and-add-lint
Oct 31, 2022
Merged

Add missing rustdoc comments; enable missing_docs lint#216
tarcieri merged 1 commit into
masterfrom
fix-missing-docs-and-add-lint

Conversation

@tarcieri

@tarcieritarcieri commented Oct 29, 2022

Copy link
Copy Markdown
Member

Several types and methods were missing documentation.

This commit adds document and enables warnings for missing_docs.

Additionally it updates all references to PKCS#1 RFCs to use RFC8017, which documents the latest version of PKCS#1.

cc @lumag

Comment threadsrc/errors.rs
Comment threadsrc/lib.rs
Comment on lines +187 to +199
//! [`pkcs8::DecodePublicKey`]: https://docs.rs/pkcs8/latest/pkcs8/trait.DecodePublicKey.html
//! [`pkcs8::EncodePublicKey`]: https://docs.rs/pkcs8/latest/pkcs8/trait.EncodePublicKey.html

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

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

For some reason rustdoc is failing to link these. Not sure why, but this at least works around the bug.

See: https://docs.rs/rsa/latest/rsa/#pkcs8-rsa-key-encoding

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Strange. This works for me with the local cargo doc.

Comment threadsrc/lib.rs
Comment threadsrc/lib.rs Outdated
Several types and methods were missing documentation.
This commit adds document and enables warnings for `missing_docs`.
Additionally it updates all references to PKCS#1 RFCs to use RFC8017,
which documents the latest version of PKCS#1.
@tarcieri
tarcieriforce-pushed the fix-missing-docs-and-add-lint branch from 81d1ee7 to 29be278CompareOctober 29, 2022 18:03
@lumag

lumag commented Oct 29, 2022 via email

Copy link
Copy Markdown
Contributor

@tarcieri
tarcieri merged commit eeb18ee into masterOct 31, 2022
@tarcieri
tarcieri deleted the fix-missing-docs-and-add-lint branch October 31, 2022 20:15
@tarcieritarcieri mentioned this pull request Oct 31, 2022
Merged
takumi-earth pushed a commit to earthlings-dev/RSA that referenced this pull request Jan 27, 2026
)
Several types and methods were missing documentation.
This commit adds document and enables warnings for `missing_docs`.
Additionally it updates all references to PKCS#1 RFCs to use RFC8017,
which documents the latest version of PKCS#1.
Sign up for freeto 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.

2 participants

@tarcieri@lumag