Есть ли Java-аннотация для создания документации по параметрам?

Question

Проекты вроде hadoop имеют тонну parameters, но вся эта документация создается вручную из xml, а не из code.

Есть ли способ сделать что-то с аннотацией, которая может сгенерировать эту документацию?

public static final String MAP_SORT_SPILL_PERCENT = "mapreduce.map.sort.spill.percent"; 

    <name>mapreduce.map.sort.spill.percent</name> 
    <value>0.80</value> 
    <description>The soft limit in the serialization buffer. Once reached, a 
    thread will begin to spill the contents to disk in the background. Note that 
    collection will not block if this threshold is exceeded while a spill is 
    already in progress, so spills may be larger than this threshold when it is 
    set to less than .5</description> 

Answer 1

Вы можете использовать @param JavaDoc тег для создания информации о параметрах в коде, например, this example from the wikipedia page:

/** 
* Short one line description.       
* 
* @param variable Description text text text.   
* @return Description text text text. 
*/  
public int methodName (...) { 
    // method body with a return statement 
} 

Вот как Oracle создает официальный документ для Java (example)