¿Cuál es la mejor manera de documentar de manera adecuada y útil una función de un objeto anónimo? Estoy haciendo algo de programación con Soar (APIaqu), y tiene un código que se parece a esto:

/**
 * 
 * @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;
        }
    };
}

Cuando es importante saber qué hace la función del objeto devuelto, qué espera para los parámetros, etc., no estoy seguro de qué escribir. Eclipse parece ignorar el método de javadoc, y realmente no quiero escribir clases separadas para cada uno de los controladores solo con fines de documentación.