Community
Participate
Working Groups
Some javadoc contains invalid javadoc tags. I will attach a patch for the API types.
Created attachment 10795 [details] Fix javadocs for API
*** Bug 62758 has been marked as a duplicate of this bug. ***
Created attachment 10809 [details] Apply this patch to fix all problems related to javadoc for JDT/Core API Needs to be verified.
All JDT/Core tests and JDT/UI tests pass with these changes.
We should put this fix in for RC1. Frederic - pls verify patch.
It's ok for me. One thing here: there's now only one warning in ASTMatcher about reference to deprecated method Javadoc#getComment(). Perhaps it would be nice to change the comment to avoid it... Perhaps it would be nice to have an additional option to avoid this kind of warning...?
Buildfile: c:\eclipse\workspaces\head2\org.eclipse.jdt.core\javadoc.xml javadoc: [javadoc] Generating Javadoc [javadoc] Javadoc execution [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\ICompilationUnit.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\CompletionProposal.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\IJavaModelStatusConstants.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\NamingConventions.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\JavaModelException.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\ToolFactory.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\IBuffer.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\Signature.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\IImportContainer.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\IBufferChangedListener.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\IParent.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\antadapter\org\eclipse\jdt\core\CheckDebugAttributes.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\IOpenable.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\IMethod.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\ISourceRange.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\ICodeCompletionRequestor.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\IJavaProject.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\IClassFile.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\IType.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\IJavaModelMarker.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\antadapter\org\eclipse\jdt\core\JDTCompilerAdapter.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\CompletionRequestor.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\ElementChangedEvent.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\IMember.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\Flags.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\IRegion.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\ClasspathVariableInitializer.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\ICorrectionRequestor.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\IProblemRequestor.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\IWorkingCopy.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\IField.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\ITypeHierarchyChangedListener.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\IPackageFragmentRoot.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\WorkingCopyOwner.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\IJavaElementDelta.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\IJavaModelStatus.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\IInitializer.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\IJavaModel.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\ClasspathContainerInitializer.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\IElementChangedListener.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\ILocalVariable.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\IJavaElement.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\IPackageDeclaration.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\IPackageFragment.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\IBufferFactory.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\ISourceReference.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\CorrectionEngine.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\IImportDeclaration.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\BufferChangedEvent.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\CompletionRequestorAdapter.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\JavaCore.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\JavaConventions.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\ITypeHierarchy.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\ICodeFormatter.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\ICodeAssist.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\ISourceManipulation.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\ICompletionRequestor.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\IClasspathEntry.java... [javadoc] Loading source file C:\eclipse\workspaces\head2\org.eclipse.jdt.core\model\org\eclipse\jdt\core\IClasspathContainer.java... [javadoc] Loading source files for package org.eclipse.jdt.core.search... [javadoc] Loading source files for package org.eclipse.jdt.core.compiler... [javadoc] Loading source files for package org.eclipse.jdt.core.dom... [javadoc] Loading source files for package org.eclipse.jdt.core.dom.rewrite... [javadoc] Loading source files for package org.eclipse.jdt.core.eval... [javadoc] Loading source files for package org.eclipse.jdt.core.jdom... [javadoc] Loading source files for package org.eclipse.jdt.core.util... [javadoc] Loading source files for package org.eclipse.jdt.core.formatter... [javadoc] Constructing Javadoc information... [javadoc] Standard Doclet version 1.4.2_04 [javadoc] Building tree for all the packages and classes... [javadoc] Building index for all the packages and classes... [javadoc] Building index for all classes... [javadoc] Generating C:\temp\jdt.core.doc\stylesheet.css... BUILD SUCCESSFUL Total time: 16 seconds Fixed and released in HEAD.
Created attachment 11047 [details] Run with ant after pasting it in the org.eclipse.jdt.core project's root I attached a javadoc.xml to paste in the org.eclipse.jdt.core projects and run with ant to verify this PR.
Verified in 200405281200