### Eclipse Workspace Patch 1.0
#P org.eclipse.jdt.doc.user
Index: reference/preferences/java/compiler/ref-preferences-javadoc.htm
===================================================================
RCS file: /cvsroot/eclipse/org.eclipse.jdt.doc.user/reference/preferences/java/compiler/ref-preferences-javadoc.htm,v
retrieving revision 1.5
diff -u -r1.5 ref-preferences-javadoc.htm
--- reference/preferences/java/compiler/ref-preferences-javadoc.htm 6 Apr 2009 14:09:24 -0000 1.5
+++ reference/preferences/java/compiler/ref-preferences-javadoc.htm 5 Oct 2010 15:46:43 -0000
@@ -55,7 +55,7 @@
Only consider members as visible as
- The compiler does only check members with the specified or a broader visibility.
+ The compiler only checks members with the specified or a broader visibility.
|
Public
@@ -122,7 +122,7 @@
Only consider members as visible as
|
- The compiler does only check members with the specified or a broader visibility.
+ The compiler only checks members with the specified or a broader visibility.
|
Public
@@ -130,13 +130,24 @@
|
- Check overriding and implementing methods
+ Ignore in overriding and implementing methods
|
- When enabled, also overriding and implementing methods are checked for missing Javadoc tags.
+ When enabled, methods that override or implement another method are not checked for missing Javadoc tags.
|
- Off
+ On
+ |
+
+
+
+ Ignore method type parameters
+ |
+
+ When enabled, missing Javadoc tags are not reported for method type parameters.
+ |
+
+ On
|
@@ -155,7 +166,7 @@
Only consider members as visible as
- The compiler does only check members with the specified or a broader visibility.
+ The compiler only checks members with the specified or a broader visibility.
|
Public
@@ -163,13 +174,13 @@
|
- Check overriding and implementing methods
+ Ignore in overriding and implementing methods
|
- When enabled, also overriding and implementing methods are checked for missing Javadoc comments.
+ When enabled, methods that override or implement another method are not checked for missing Javadoc comments.
|
- Off
+ On
|
#P org.eclipse.jdt.ui
Index: ui/org/eclipse/jdt/internal/ui/preferences/JavadocProblemsConfigurationBlock.java
===================================================================
RCS file: /cvsroot/eclipse/org.eclipse.jdt.ui/ui/org/eclipse/jdt/internal/ui/preferences/JavadocProblemsConfigurationBlock.java,v
retrieving revision 1.18
diff -u -r1.18 JavadocProblemsConfigurationBlock.java
--- ui/org/eclipse/jdt/internal/ui/preferences/JavadocProblemsConfigurationBlock.java 18 Jan 2010 13:31:16 -0000 1.18
+++ ui/org/eclipse/jdt/internal/ui/preferences/JavadocProblemsConfigurationBlock.java 5 Oct 2010 15:46:44 -0000
@@ -48,6 +48,7 @@
private static final Key PREF_PB_MISSING_JAVADOC_TAGS= getJDTCoreKey(JavaCore.COMPILER_PB_MISSING_JAVADOC_TAGS);
private static final Key PREF_PB_MISSING_JAVADOC_TAGS_VISIBILITY= getJDTCoreKey(JavaCore.COMPILER_PB_MISSING_JAVADOC_TAGS_VISIBILITY);
private static final Key PREF_PB_MISSING_JAVADOC_TAGS_OVERRIDING= getJDTCoreKey(JavaCore.COMPILER_PB_MISSING_JAVADOC_TAGS_OVERRIDING);
+ private static final Key PREF_PB_MISSING_JAVADOC_TAGS_METHOD_TYPE_PARAMETERS= getJDTCoreKey(JavaCore.COMPILER_PB_MISSING_JAVADOC_TAGS_METHOD_TYPE_PARAMETERS);
private static final Key PREF_PB_MISSING_JAVADOC_TAG_DESCRIPTION= getJDTCoreKey(JavaCore.COMPILER_PB_MISSING_JAVADOC_TAG_DESCRIPTION);
@@ -91,6 +92,7 @@
PREF_PB_INVALID_JAVADOC_TAGS_VISIBILITY,
PREF_PB_INVALID_JAVADOC_TAGS_NOT_VISIBLE_REF, PREF_PB_INVALID_JAVADOC_TAGS_DEPRECATED_REF,
PREF_PB_MISSING_JAVADOC_TAGS, PREF_PB_MISSING_JAVADOC_TAGS_VISIBILITY, PREF_PB_MISSING_JAVADOC_TAGS_OVERRIDING,
+ PREF_PB_MISSING_JAVADOC_TAGS_METHOD_TYPE_PARAMETERS,
PREF_PB_MISSING_JAVADOC_COMMENTS, PREF_PB_MISSING_JAVADOC_COMMENTS_VISIBILITY, PREF_PB_MISSING_JAVADOC_COMMENTS_OVERRIDING,
PREF_PB_MISSING_JAVADOC_TAG_DESCRIPTION,
};
@@ -186,7 +188,10 @@
gd.horizontalSpan= nColumns;
description.setLayoutData(gd);
- int indent= fPixelConverter.convertWidthInCharsToPixels(2);
+ int indent= fPixelConverter.convertWidthInCharsToPixels(4);
+
+ spacer= new Composite(composite, SWT.NONE);
+ GridDataFactory.fillDefaults().span(nColumns, 1).hint(1, 5).applyTo(spacer);
label = PreferencesMessages.JavadocProblemsConfigurationBlock_pb_invalid_javadoc_label;
addComboBox(composite, label, PREF_PB_INVALID_JAVADOC, errorWarningIgnore, errorWarningIgnoreLabels, 0);
@@ -216,6 +221,10 @@
label= PreferencesMessages.JavadocProblemsConfigurationBlock_pb_missing_tag_description;
addComboBox(composite, label, PREF_PB_MISSING_JAVADOC_TAG_DESCRIPTION, missingTagValues, missingTagLabels, indent);
+
+ spacer= new Composite(composite, SWT.NONE);
+ GridDataFactory.fillDefaults().span(nColumns, 1).hint(1, 5).applyTo(spacer);
+
label = PreferencesMessages.JavadocProblemsConfigurationBlock_pb_missing_javadoc_label;
addComboBox(composite, label, PREF_PB_MISSING_JAVADOC_TAGS, errorWarningIgnore, errorWarningIgnoreLabels, 0);
@@ -225,6 +234,13 @@
label= PreferencesMessages.JavadocProblemsConfigurationBlock_pb_missing_javadoc_tags_overriding_label;
addCheckBox(composite, label, PREF_PB_MISSING_JAVADOC_TAGS_OVERRIDING, disabledEnabled, indent);
+ label= PreferencesMessages.JavadocProblemsConfigurationBlock_pb_missing_comments_method_type_parameter_label;
+ addCheckBox(composite, label, PREF_PB_MISSING_JAVADOC_TAGS_METHOD_TYPE_PARAMETERS, disabledEnabled, indent);
+
+
+ spacer= new Composite(composite, SWT.NONE);
+ GridDataFactory.fillDefaults().span(nColumns, 1).hint(1, 5).applyTo(spacer);
+
label = PreferencesMessages.JavadocProblemsConfigurationBlock_pb_missing_comments_label;
addComboBox(composite, label, PREF_PB_MISSING_JAVADOC_COMMENTS, errorWarningIgnore, errorWarningIgnoreLabels, 0);
@@ -279,6 +295,7 @@
boolean enableMissingTagsErrors= !checkValue(PREF_PB_MISSING_JAVADOC_TAGS, IGNORE);
getCheckBox(PREF_PB_MISSING_JAVADOC_TAGS_OVERRIDING).setEnabled(enableMissingTagsErrors);
+ getCheckBox(PREF_PB_MISSING_JAVADOC_TAGS_METHOD_TYPE_PARAMETERS).setEnabled(enableMissingTagsErrors);
setComboEnabled(PREF_PB_MISSING_JAVADOC_TAGS_VISIBILITY, enableMissingTagsErrors);
boolean enableMissingCommentsErrors= !checkValue(PREF_PB_MISSING_JAVADOC_COMMENTS, IGNORE);
Index: ui/org/eclipse/jdt/internal/ui/preferences/PreferencesMessages.java
===================================================================
RCS file: /cvsroot/eclipse/org.eclipse.jdt.ui/ui/org/eclipse/jdt/internal/ui/preferences/PreferencesMessages.java,v
retrieving revision 1.132
diff -u -r1.132 PreferencesMessages.java
--- ui/org/eclipse/jdt/internal/ui/preferences/PreferencesMessages.java 30 Sep 2010 14:33:32 -0000 1.132
+++ ui/org/eclipse/jdt/internal/ui/preferences/PreferencesMessages.java 5 Oct 2010 15:46:44 -0000
@@ -438,6 +438,7 @@
public static String JavadocProblemsConfigurationBlock_pb_missing_javadoc_tags_visibility_label;
public static String JavadocProblemsConfigurationBlock_pb_missing_javadoc_tags_overriding_label;
public static String JavadocProblemsConfigurationBlock_pb_missing_comments_label;
+ public static String JavadocProblemsConfigurationBlock_pb_missing_comments_method_type_parameter_label;
public static String JavadocProblemsConfigurationBlock_pb_missing_comments_visibility_label;
public static String JavadocProblemsConfigurationBlock_pb_missing_comments_overriding_label;
public static String JavadocProblemsConfigurationBlock_pb_missing_tag_description;
Index: ui/org/eclipse/jdt/internal/ui/preferences/PreferencesMessages.properties
===================================================================
RCS file: /cvsroot/eclipse/org.eclipse.jdt.ui/ui/org/eclipse/jdt/internal/ui/preferences/PreferencesMessages.properties,v
retrieving revision 1.515
diff -u -r1.515 PreferencesMessages.properties
--- ui/org/eclipse/jdt/internal/ui/preferences/PreferencesMessages.properties 30 Sep 2010 14:33:32 -0000 1.515
+++ ui/org/eclipse/jdt/internal/ui/preferences/PreferencesMessages.properties 5 Oct 2010 15:46:44 -0000
@@ -468,7 +468,7 @@
JavadocProblemsConfigurationBlock_needsfullbuild_message=The Javadoc settings have changed. A full rebuild is required for changes to take effect. Do the full build now?
JavadocProblemsConfigurationBlock_needsprojectbuild_message=The Javadoc settings have changed. A rebuild of the project is required for changes to take effect. Build the project now?
-JavadocProblemsConfigurationBlock_javadoc_description=Severity level for problems in Javadoc comments:
+JavadocProblemsConfigurationBlock_javadoc_description=Severity levels for problems in Javadoc comments:
JavadocProblemsConfigurationBlock_pb_javadoc_support_label=Proc&ess Javadoc comments
JavadocProblemsConfigurationBlock_pb_invalid_javadoc_label=Mal&formed Javadoc comments:
@@ -482,6 +482,7 @@
JavadocProblemsConfigurationBlock_pb_missing_comments_label=Missing &Javadoc comments:
JavadocProblemsConfigurationBlock_pb_missing_comments_visibility_label=Only &consider members as visible as:
JavadocProblemsConfigurationBlock_pb_missing_comments_overriding_label=I&gnore in overriding and implementing methods
+JavadocProblemsConfigurationBlock_pb_missing_comments_method_type_parameter_label=Ignore met&hod type parameters
JavadocProblemsConfigurationBlock_pb_missing_tag_description=&Missing tag descriptions:
JavadocProblemsConfigurationBlock_returnTag=Validate @return tags