Javadoc para método de objeto anônimo
Qual é a melhor maneira de documentar de maneira adequada e útil a função de um objeto anônimo? Estou fazendo alguma programação com Soar (APIaqu) e tenha um código parecido com este:
/**
*
* @return handler that does blah
*/
public static RhsFunctionInterface functionBlah() {
return new Kernel.RhsFunctionInterface() {
/**
* Does blah
*/
@Override
public String rhsFunctionHandler(int eventID, Object data,
String agentName, String functionName, String arguments) {
return null;
}
};
}
Quando é importante saber o que a função do objeto retornado faz, o que ele espera para parâmetros, etc., não tenho certeza do que escrever. O Eclipse parece ignorar o método do javadoc, e eu realmente não quero escrever classes separadas para cada manipulador apenas para fins de documentaçã