RFR: JDK-8305406: Add @spec tags in java.base/java.* (part 2) [v3]

[Ferenc Rakoczi]

On Thu, 8 Jun 2023 20:46:41 GMT, Jonathan Gibbons <jjg at openjdk.org> wrote:

> > I checked out references to `nist.gov`.
> > I found 7 references to 4 documents:
> > ```
> > $ grep -r '*.*href=[^ ]*nist.gov' open/src/java.base | grep -o 'nist.gov[^"]*'
> > nist.gov/nistpubs/FIPS/NIST.FIPS.140-2.pdf
> > nist.gov/publications/fips/fips186-3/fips_186-3.pdf
> > nist.gov/nistpubs/SpecialPublications/NIST.SP.800-90Ar1.pdf
> > nist.gov/nistpubs/SpecialPublications/NIST.SP.800-38F.pdf>
> > nist.gov/nistpubs/SpecialPublications/NIST.SP.800-38F.pdf>
> > nist.gov/nistpubs/SpecialPublications/NIST.SP.800-38F.pdf>
> > nist.gov/nistpubs/SpecialPublications/NIST.SP.800-38F.pdf>
> > ```
> > Of these 4, 1 shows a page that says the spec has been superseded, and one is effectively a 404
> > ```
> > Oops, that's not standard?!
> > Sorry, we cannot find that page.
> > 
> > The page you requested cannot be found at this time.
> > ``` 
> >   
> > I would like to defer these issues to be handled separately, and add `@spec` tags for these pages later, once the appropriate specs have been identified.
> 
> Update, the apparent 404 is explained by a scripting error, due to an unquoted attribute value.

The site name in the  urls has changed to  nvlpubs.nist.gov .

For the DSS, the latest version in which DSA is described is
nvlpubs.nist.gov/nistpubs/FIPS/NIST.FIPS.186-4.pdf . It will be with withdrawn on February 23, 2024, though, and the superseding FIPS 186-5 standard says that it can only be used for signature verification from then on, but for the algorithm description it points back to FIPS 186-4.

-------------

PR Comment: https://git.openjdk.org/jdk/pull/13336#issuecomment-1584332934