2 files changed, 11 insertions, 32 deletions

diff --git a/src/main/java/com/google/devtools/build/lib/rules/cpp/CcCompilationInfo.java b/src/main/java/com/google/devtools/build/lib/rules/cpp/CcCompilationInfo.java
index 135865f271..42cf3f3e16 100644
--- a/src/main/java/com/google/devtools/build/lib/rules/cpp/CcCompilationInfo.java
+++ b/src/main/java/com/google/devtools/build/lib/rules/cpp/CcCompilationInfo.java
@@ -174,40 +174,24 @@ public final class CcCompilationInfo extends NativeInfo {
   }
 
   /**
-   * Returns the immutable set of declared include directories, relative to a
-   * "-I" or "-iquote" directory" (possibly empty but never null). The returned
-   * collection may contain duplicate elements.
-   *
-   * <p>Note: The iteration order of this list is preserved as ide_build_info
-   * writes these directories and sources out and the ordering will help when
-   * used by consumers.
+   * Returns the immutable set of declared include directories, relative to a "-I" or "-iquote"
+   * directory" (possibly empty but never null).
    */
   public NestedSet<PathFragment> getDeclaredIncludeDirs() {
     return declaredIncludeDirs;
   }
 
   /**
-   * Returns the immutable set of include directories, relative to a "-I" or
-   * "-iquote" directory", from which inclusion will produce a warning (possibly
-   * empty but never null). The returned collection may contain duplicate
-   * elements.
-   *
-   * <p>Note: The iteration order of this list is preserved as ide_build_info
-   * writes these directories and sources out and the ordering will help when
-   * used by consumers.
+   * Returns the immutable set of include directories, relative to a "-I" or "-iquote" directory",
+   * from which inclusion will produce a warning (possibly empty but never null).
    */
   public NestedSet<PathFragment> getDeclaredIncludeWarnDirs() {
     return declaredIncludeWarnDirs;
   }
 
   /**
-   * Returns the immutable set of headers that have been declared in the
-   * {@code src} or {@code headers attribute} (possibly empty but never null).
-   * The returned collection may contain duplicate elements.
-   *
-   * <p>Note: The iteration order of this list is preserved as ide_build_info
-   * writes these directories and sources out and the ordering will help when
-   * used by consumers.
+   * Returns the immutable set of headers that have been declared in the {@code srcs} or {@code
+   * hdrs} attribute (possibly empty but never null).
    */
   public NestedSet<Artifact> getDeclaredIncludeSrcs() {
     return declaredIncludeSrcs;
diff --git a/src/main/java/com/google/devtools/build/lib/rules/cpp/CppCompileAction.java b/src/main/java/com/google/devtools/build/lib/rules/cpp/CppCompileAction.java
index 98209e62d7..406bb8e8d1 100644
--- a/src/main/java/com/google/devtools/build/lib/rules/cpp/CppCompileAction.java
+++ b/src/main/java/com/google/devtools/build/lib/rules/cpp/CppCompileAction.java
@@ -1076,27 +1076,22 @@ public class CppCompileAction extends AbstractAction
   }
 
   /**
-   * Return the directories in which to look for headers (pertains to headers
-   * not specifically listed in {@code declaredIncludeSrcs}). The return value
-   * may contain duplicate elements.
+   * Return the directories in which to look for headers (pertains to headers not specifically
+   * listed in {@code declaredIncludeSrcs}).
    */
   public NestedSet<PathFragment> getDeclaredIncludeDirs() {
     return ccCompilationInfo.getDeclaredIncludeDirs();
   }
 
   /**
-   * Return the directories in which to look for headers and issue a warning.
-   * (pertains to headers not specifically listed in {@code
-   * declaredIncludeSrcs}). The return value may contain duplicate elements.
+   * Return the directories in which to look for headers and issue a warning. (pertains to headers
+   * not specifically listed in {@code declaredIncludeSrcs}).
    */
   public NestedSet<PathFragment> getDeclaredIncludeWarnDirs() {
     return ccCompilationInfo.getDeclaredIncludeWarnDirs();
   }
 
-  /**
-   * Return explicit header files (i.e., header files explicitly listed). The
-   * return value may contain duplicate elements.
-   */
+  /** Return explicitly listed header files. */
   @Override
   public NestedSet<Artifact> getDeclaredIncludeSrcs() {
     if (lipoScannables != null && lipoScannables.iterator().hasNext()) {