12
Sto lavorando su un'applicazione che è costantemente riscritta per migliorarlo. Ora, se rinominiamo una determinata classe per catturare meglio la sua intenzione, tutta la documentazione che menziona la classe non viene aggiornata automaticamente, a meno che non si utilizzino collegamenti ({@link ClassName}) per fare riferimento alla classe.Fare JavaDoc robusta contro il refactoring
principi JavaDoc tuttavia affermano che si dovrebbe "Utilizzare i collegamenti in linea economicamente", dal momento che i collegamenti spiccano e attirare l'attenzione dei lettori, che trovo sensato. Inoltre non puoi collegare ai parametri di un metodo.
Esiste un altro modo in JavaDoc di fare commenti più robusto di refactoring che non sono a conoscenza?
Come si esegue il refactoring? Quando si rinomina in Eclipse, è possibile cercare tra i commenti. –
Sì, uso Eclipse e ricordo di averlo visto. Non ho tuttavia l'opzione (usando Ctrl + Alt + R), e non riesco a trovare nulla nelle impostazioni per cambiarlo. Ad ogni modo, ciò funzionerebbe molte volte, ma ovviamente può essere ambiguo. – alexsb
IntelliJ ricerca attraverso commenti, stringhe e file per trovare le cose da rinominare. Offre anche la possibilità di rinominare campi, variabili e parametri. Suppongo che Eclipse faccia lo stesso. –