JDK-5008142 : Javadoc for X509Certificate using denigrated instead of deprecated
  • Type: Bug
  • Component: security-libs
  • Sub-Component: java.security
  • Affected Version: 5.0
  • Priority: P3
  • Status: Closed
  • Resolution: Not an Issue
  • OS: windows_2000
  • CPU: x86
  • Submitted: 2004-03-04
  • Updated: 2004-03-05
  • Resolved: 2004-03-05
Description

Name: jl125535			Date: 03/04/2004


URL OF PROBLEM DOCUMENTATION :
http://java.sun.com/j2se/1.5.0/docs/api/java/security/cert/X509Certificate.html#getIssuerDN()
http://java.sun.com/j2se/1.5.0/docs/api/java/security/cert/X509Certificate.html#getSubjectDN()
http://java.sun.com/j2se/1.5.0/docs/api/java/security/cert/X509CRL.html#getIssuerDN()

A DESCRIPTION OF THE PROBLEM :
Javadoc for X509Certificate.getSubjectDN() and getIssuerDN() is using "denigrated" instead of "deprecated"
Javadoc for X509CRL.getSubjectDN() is using "denigrated" instead of "deprecated"

The wording is incorrect and the methods do not appear in the Deprecated list (http://java.sun.com/j2se/1.5.0/docs/api/deprecated-list.html#method)


EXPECTED VERSUS ACTUAL BEHAVIOR :
EXPECTED -
"Deprecated" instead of "Denigrated".
The tag @deprecated must be used in the original source instead.

ACTUAL -
"Denigrated"
(Incident Review ID: 241819) 
======================================================================

Comments
EVALUATION ###@###.### 2004-03-04 This isn't a bug. "Deprecated" is meant to be used only in serious cases.
2004-03-04