Skip to content

docs: fix javadoc grammar in the crypto package - #7

Open
Avicennasis wants to merge 1 commit into
tokopedia:mainfrom
Avicennasis:docs/fix-typos
Open

Avicennasis wants to merge 1 commit into
tokopedia:mainfrom
Avicennasis:docs/fix-typos

Conversation

@Avicennasis

Copy link
Copy Markdown

Summary

Fixes 20 verified javadoc grammar errors across 4 files in sdk/digitalb2bclient/.../crypto/. Javadoc comments only - no code, no identifiers, no @param names touched.

  • crypto/CryptoKey.java (6x): This method to be used to ... -> This method is to be used to ... (missing verb)
  • crypto/encryption/Encryption.java: same missing-verb fix (6x); @param payload is the payload which will be encrypt, -> which will be encrypted, (2x); ... which will be decrypt, -> which will be decrypted, (3x)
  • crypto/signature/impl/DigitalSignatureCorePKCS.java: This method to be used to verify of a signature -> This method is to be used to verify a signature (missing verb + stray of); @return string This return of the signature. -> This returns the signature.
  • crypto/signature/impl/DigitalSignatureCorePSS.java: the same two fixes, plus the missing-verb fix on ... to calculate PSS Salt Length based on public key

Note on scope: This method to be used to appears 6 times in Encryption.java; 4 of those were the ones I set out to fix, but fixing 4 of 6 identical openings in one file would have looked arbitrary, so all 6 were corrected. The @param tag names themselves are untouched, so nothing can drift out of sync with the method signatures.

Deliberately left alone: the terse set connect timeout with time unit HttpClient / keep alive durations phrasing in config/Config.java and config/ConfigBuilder.java, which is used consistently throughout those files and is a wording preference rather than an error.

No functional changes - documentation comments only.

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