31 import java.util.concurrent.Callable;

    31 import java.util.concurrent.Callable;

    32 

    32 

    33 /**

    33 /**

    34  * Interface to invoke Java™ programming language documentation tools from

    34  * Interface to invoke Java™ programming language documentation tools from

    35  * programs.

    35  * programs.

    36  */

    38  */

    37 public interface DocumentationTool extends Tool, OptionChecker {

    39 public interface DocumentationTool extends Tool, OptionChecker {

    38     /**

    40     /**

    39      * Creates a future for a documentation task with the given

    41      * Creates a future for a documentation task with the given

    40      * components and arguments.  The task might not have

    42      * components and arguments.  The task might not have

   128          * or diagnostics to be reported when the task is started.

   130          * or diagnostics to be reported when the task is started.

   129          * @param moduleNames the names of the root modules

   131          * @param moduleNames the names of the root modules

   130          * @throws IllegalArgumentException may be thrown for some

   132          * @throws IllegalArgumentException may be thrown for some

   131          *      invalid module names

   133          *      invalid module names

   132          * @throws IllegalStateException if the task has started

   134          * @throws IllegalStateException if the task has started

   133          */

   136          */

   134         void addModules(Iterable<String> moduleNames);

   137         void addModules(Iterable<String> moduleNames);

   135 

   138 

   136         /**

   139         /**

   137          * Sets the locale to be applied when formatting diagnostics and

   140          * Sets the locale to be applied when formatting diagnostics and