Bug #4840: [build] Предупреждения при генерировании javadoc-документации - Fortress - Open-Source Projects

Actions

Copy link

Bug #4840

closed

[build] Предупреждения при генерировании javadoc-документации

Added by Igor Melnichenko over 10 years ago. Updated over 10 years ago.

Status:

Closed

Priority:

Normal

Assignee:

Andrei Tatarnikov

Category:

Target version:

0.3

Start date:

04/07/2014

Due date:

% Done:

100%

Estimated time:

Detected in build:

svn

Platform:

Published in build:

140915

Description

Сейчас генерировал документацию, были выданы следующие предупреждения:
\src\main\java\ru\ispras\fortress\transform\Transform.java:40: warning - @param argument "calculator" is not a parameter name.
\src\main\java\ru\ispras\fortress\solver\xml\XMLConstraintSaver.java:93: warning - @param argument "fileName" is not a parameter name.
\src\main\java\ru\ispras\fortress\solver\xml\XMLConstraintSaver.java:93: warning - @param argument "constraint" is not a parameter name.
\src\main\java\ru\ispras\fortress\solver\constraint\Constraint.java:32: warning - @authors is an unknown tag.
\src\main\java\ru\ispras\fortress\solver\constraint\Formulas.java:50: warning - @param argument "expr" is not a parameter name.
\src\main\java\ru\ispras\fortress\calculator\CalculatorEngine.java:38: warning - @param argument "operationId" is not a parameter name.
\src\main\java\ru\ispras\fortress\calculator\CalculatorEngine.java:50: warning - @param argument "operationId" is not a parameter name.

Actions

Copy link

Updated by Alexander Kamkin over 10 years ago

Subject changed from Предупреждения при генерировании javadoc-документации to [build] Предупреждения при генерировании javadoc-документации
Target version set to 0.3

Что с этой задачей?

Actions

Copy link

Updated by Andrei Tatarnikov over 10 years ago

Status changed from New to Resolved
% Done changed from 0 to 100

Исправлено в r522.

Помимо указанных предупреждений были предупреждения, связанные с классами в пакете jaxb. Например:

[javadoc] /home/andrewt/Documents/ISPRAS/src/solver-api/trunk/fortress/src/main/java/ru/ispras/fortress/jaxb/JaxbData.java:31: warning - Tag @Андрей Тапехин: reference not found: Data

Замечание: Если используется тэг @Андрей Тапехин и класс, на который указывает ссылка, не импортируется, то необходимо указывать его полное имя: {@link ru.ispras.fortress.data.Data}. Иначе JavaDoc не может понять, о каком именно классе идёт речь, и генерирует предупреждение.

Actions

Copy link