Document OutputFormatterCallback#close's fail-fast mode
PiperOrigin-RevId: 319982396
diff --git a/src/main/java/com/google/devtools/build/lib/query2/engine/OutputFormatterCallback.java b/src/main/java/com/google/devtools/build/lib/query2/engine/OutputFormatterCallback.java
index c66eefe..eab73a9 100644
--- a/src/main/java/com/google/devtools/build/lib/query2/engine/OutputFormatterCallback.java
+++ b/src/main/java/com/google/devtools/build/lib/query2/engine/OutputFormatterCallback.java
@@ -32,12 +32,15 @@
}
/**
- * Same as start but for closing resources or writing a footer.
+ * Flushes remaining output and cleans up resources if necessary.
*
- * <p>Will be called even in the case of an error.
+ * <p>This method is called whether or not there was an error.
+ *
+ * @param failFast Indicates whether or not this method is being called after an error. When true
+ * implementations should prefer cleaning up resources and avoiding throwing unnecessary
+ * exceptions over completing the output.
*/
- public void close(boolean failFast) throws InterruptedException, IOException {
- }
+ public void close(boolean failFast) throws InterruptedException, IOException {}
/**
* Note that {@link Callback} interface does not throw IOExceptions. What this implementation does