United StatesChange Country, Oracle Worldwide Web Sites Communities I am a... I want to...
Bug ID: JDK-6875861 javadoc build warning on java.util.Properites from unconventional @see ordering
JDK-6875861 : javadoc build warning on java.util.Properites from unconventional @see ordering

Details
Type:
Bug
Submit Date:
2009-08-26
Status:
Resolved
Updated Date:
2010-04-02
Project Name:
JDK
Resolved Date:
2009-09-11
Component:
core-libs
OS:
generic
Sub-Component:
java.util
CPU:
generic
Priority:
P4
Resolution:
Fixed
Affected Versions:
7
Fixed Versions:

Related Reports
Backport:

Sub Tasks

Description
The javadoc for java.util.Properites has @see tags before the main specification of the class is done.  This causes an arguably spurious warning from javadoc.

                                    

Comments
EVALUATION

Removing warnings is good.
                                     
2009-08-26
SUGGESTED FIX

# HG changeset patch
# User darcy
# Date 1251251906 25200
# Node ID 196c7bb551e76439da733e8a5f0b13a2f3c9c468
# Parent b115cf94685275f6961a4cafb5edc0595dd4c05f
6875861: javadoc build warning on java.util.Properites from unconventional @see ordering
Reviewed-by: martin

--- a/src/share/classes/java/util/Properties.java	Tue Aug 25 15:14:53 2009 -0700
+++ b/src/share/classes/java/util/Properties.java	Tue Aug 25 18:58:26 2009 -0700
@@ -101,11 +101,11 @@ import java.io.BufferedWriter;
  *    <!ATTLIST entry key CDATA #REQUIRED>
  * </pre>
  *
+ * <p>This class is thread-safe: multiple threads can share a single
+ * <tt>Properties</tt> object without the need for external synchronization.
+ *
  * @see <a href="../../../technotes/tools/solaris/native2ascii.html">native2ascii tool for Solaris</a>
  * @see <a href="../../../technotes/tools/windows/native2ascii.html">native2ascii tool for Windows</a>
- *
- * <p>This class is thread-safe: multiple threads can share a single
- * <tt>Properties</tt> object without the need for external synchronization.
  *
  * @author  Arthur van Hoff
  * @author  Michael McCloskey
                                     
2009-08-26



Hardware and Software, Engineered to Work Together