javadoc工具是否识别方法中的注释?

前端之家收集整理的这篇文章主要介绍了javadoc工具是否识别方法中的注释?前端之家小编觉得挺不错的,现在分享给大家,也给大家做个参考。
我在我的业务逻辑中写了很多评论
/**
 * Do some important stuff.
 * @param pDog
 * @param pAllDogTraining
 * @return
 */
@Overwrite
public Map<DogId,Dog> doEvaluateAllDog(final Dog pDog,final Collection<DogTraining> pAllDogTraining) {
final Map<DogId,Dog> lAllDogBad = new HashMap<DogId,Dog>();
final List<DogTraining> lAllDogTraining = new ArrayList<DogTraining>(pAllDogTraining);

/**
 * Remove deleted entries.
 * Detailed description
 */
removeDeletetTrainings(lAllDogTraining);

/**
 * Set the priority for each training
 *  - bad dogs
 *  - nice dogs
 *  - unknown dogs
 * Detailed description
 */
Collections.sort(lAllDogTraining,new DogTrainingComparator());

// Iterate over training elements and set the conflict state
for(.....

我的问题是,javadoc工具是否识别我的方法块中的文档注释?在不久的将来,我们将提供技术文档,我们项目的JavaDoc将成为其中的一部分.

解决方法

does the javadoc tool recognize the doc comments inside my method blocks too?

没有.

JavaDoc注释是一个以/ **开头的多行注释,紧跟在类声明或类的方法属性之前.

猜你在找的Java相关文章