Avatar ·

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; } ```