--- old/src/java.compiler/share/classes/javax/tools/DocumentationTool.java	2019-12-20 15:40:44.000000000 +0000
+++ new/src/java.compiler/share/classes/javax/tools/DocumentationTool.java	2019-12-20 15:40:44.000000000 +0000
@@ -53,7 +53,7 @@
      * use {@code System.err} if {@code null}
      *
      * @param fileManager a file manager; if {@code null} use the
-     * tool's standard filemanager
+     * tool's standard file manager
      *
      * @param diagnosticListener a diagnostic listener; if {@code null}
      * use the tool's default method for reporting diagnostics
@@ -113,11 +113,10 @@
         Charset charset);
 
     /**
-     * Interface representing a future for a documentation task.  The
-     * task has not yet started.  To start the task, call
-     * the {@linkplain #call call} method.
+     * Interface representing a future for a documentation task.
+     * To start the task, call the {@linkplain #call call} method.
      *
-     * <p>Before calling the call method, additional aspects of the
+     * <p>Before calling the {@code call} method, additional aspects of the
      * task can be configured, for example, by calling the
      * {@linkplain #setLocale setLocale} method.
      */