Document '-paths-for-coverage.txt' for code coverage

[d-haxton]

Description of the problem / feature request:

There is no documentation for -paths-for-coverage.txt.

Feature requests: what underlying problem are you trying to solve with this feature?

In the process of using this 'feature' in bazel-contrib/rules_scala#1006 we just want to get some level of guarentee that this is not a hack and won't be broken anytime in the foreseeable future (or at least some level of transition plan to an alternative)

For reference the two places where this matters to us are:

bazel/src/java_tools/junitrunner/java/com/google/testing/coverage/JacocoCoverageRunner.java

Line 411 in 567ca63

} else if (jarEntryName.endsWith("-paths-for-coverage.txt")) {

For parsing.

bazel/src/java_tools/junitrunner/java/com/google/testing/coverage/JacocoLCOVFormatter.java

Line 70 in 567ca63

if (execPathsOfUninstrumentedFiles.isEmpty()) {

For using the set to find the source file.