On 2017-05-06 02:22, Brad R. Wetmore wrote:
I applied the patch to the jdk workspace and verified that all of the instances were updated to {@docRoot}/../specs/security/standard-names.html, and that no links remain to the old StandardNames.html.

Sean wrote:

> General: change the text of all of the links from "Java Cryptography
> Architecture Standard Algorithm Name Documentation" (the old name) to
> "Java Security Standard Algorithm Names Specification".

+1

I've updated the name in all places that I could find.

Can you add similar wording to that effect in DrbgParameters.java?

I'm sorry, that instruction is too unclear for me. :-( The main purpose of this patch is to prepare for the markdown based specification, not fixing the entire content. I'll leave modification of the actual documentation to the component owners.


jdk/src/java.base/share/classes/java/security/cert/CertPathValidator.java

155-156, 193-194:  extra spaces at beginning of line.
Fixed.


jdk/src/java.base/share/classes/javax/crypto/Cipher.java

153: Why did you choose to use "Cipher Algorithm Names" instead of Cipher Algorithms? None of the other sections use "Names".

I did not choose that, that's what the section is called in the document (and has been since at least JDK 8). The difference here is that the anchor links are named after the actual headings in the document, not arbitrarily named anchors (for better and for worse).


Can you add a link in the JSSE KeyManagerFactory class description to the standard names sections for KeyManagerFactory's? Even though we don't require any currently, we should probably point to the names anyway.

I'll give you the same reply here as for DrbgParameters.java: I don't know enough about the domain to be able to do this job properly. Please file a follow-up bug and fix it yourself, or assign to someone who knows.

Updated webrev: (contains whitespace fixes and rename of document, but only the jdk repo)

http://cr.openjdk.java.net/~ihse/JDK-8178278-standard-names-spec-as-markdown/webrev.02

/Magnus


/Magnus



Thanks,

Brad





On 5/5/2017 6:17 AM, Magnus Ihse Bursie wrote:
The Security Standard Names document will be moved to a new location, so
all links needs to be updated. Also, a minor fix to the build system was
needed.

Bug: https://bugs.openjdk.java.net/browse/JDK-8178278
WebRev:
http://cr.openjdk.java.net/~ihse/JDK-8178278-standard-names-spec-as-markdown/webrev.01

/Magnus


Reply via email to