eclipse-jdt/eclipse.jdt.core

[18] False javadoc warning when using snippets and validate Missing Tag: "Description expected after @snippet"

Open

#1,583 创建于 2023年11月10日

在 GitHub 查看
 (7 评论) (3 反应) (0 负责人)Java (183 fork)auto 404
bughelp wantedjavadoc

仓库指标

Star
 (233 star)
PR 合并指标
 (PR 指标待抓取)

描述

If javadoc validation is turned on and a @snippet tag is used with the below setting JDT will give a warning.

Screen Shot 2023-11-10 at 9 00 28 AM

Description expected after @snippet

Here are the javadoc prefs:

org.eclipse.jdt.core.compiler.problem.invalidJavadoc=warning
org.eclipse.jdt.core.compiler.problem.invalidJavadocTags=enabled
org.eclipse.jdt.core.compiler.problem.invalidJavadocTagsDeprecatedRef=disabled
org.eclipse.jdt.core.compiler.problem.invalidJavadocTagsNotVisibleRef=enabled
org.eclipse.jdt.core.compiler.problem.invalidJavadocTagsVisibility=public
org.eclipse.jdt.core.compiler.problem.missingJavadocComments=warning
org.eclipse.jdt.core.compiler.problem.missingJavadocCommentsOverriding=disabled
org.eclipse.jdt.core.compiler.problem.missingJavadocCommentsVisibility=public
org.eclipse.jdt.core.compiler.problem.missingJavadocTagDescription=all_standard_tags
org.eclipse.jdt.core.compiler.problem.missingJavadocTags=warning
org.eclipse.jdt.core.compiler.problem.missingJavadocTagsMethodTypeParameters=enabled
org.eclipse.jdt.core.compiler.problem.missingJavadocTagsOverriding=disabled
org.eclipse.jdt.core.compiler.problem.missingJavadocTagsVisibility=public

The below is the problematic setting.

org.eclipse.jdt.core.compiler.problem.missingJavadocTagDescription=all_standard_tags

贡献者指南