Como referenciar corretamente métodos em Javadoc e o que é {@link}?
Olá a todos! Comecei a estudar Java recentemente e estou escrevendo documentação para meu projeto. Encontrei um problema: quero fazer referência a outro método nos comentários Javadoc para facilitar a leitura da documentação. Por exemplo, tenho uma classe `Calculator` com os métodos `add()` e `sumAndPrint()`. No segundo método, quero indicar na descrição que ele chama `add()`.
Tentei escrever apenas `#add` ou `{@link add}`, mas não funcionou — o link não aparece na documentação HTML gerada. Na documentação oficial, há algo sobre `{@link #methodName}`, mas não entendo como especificar o caminho completo se o método está em outra classe ou tem parâmetros.
Aqui está um exemplo do meu código:
```java
/**
* Calculadora para operações aritméticas simples.
*/
public class Calculator {
/**
* Soma dois números.
* @param a primeiro número
* @param b segundo número
* @return soma de a e b
*/
public int add(int a, int b) {
return a + b;
}
```