tidy logging/docs

Author: aSemy

modules/bcv-gradle-plugin/src/main/kotlin/BCVProjectPlugin.kt

@@ -165,7 +165,7 @@ constructor(
     project.tasks.withType<BCVDefaultTask>().configureEach {
       bcvEnabled.convention(extension.enabled)
 
-      onlyIf("BCV is disabled") { bcvEnabled.get() }
+      onlyIf("BCV is enabled") { bcvEnabled.get() }
     }
 
     project.tasks.withType<BCVApiGeneratePreparationTask>().configureEach {

modules/bcv-gradle-plugin/src/main/kotlin/tasks/BCVApiCheckTask.kt

@@ -124,7 +124,7 @@ constructor(
           |
           |$diffText
           |
-          |You can run '$apiDumpTaskPath' task to overwrite API declarations
+          |You can run '$apiDumpTaskPath' task to overwrite API declarations.
         """.trimMargin()
       )
     }

modules/bcv-gradle-plugin/src/main/kotlin/workers/KLibInferSignaturesWorker.kt

@@ -17,6 +17,21 @@ import org.gradle.api.provider.Property
 import org.gradle.workers.WorkAction
 import org.gradle.workers.WorkParameters
 
+/**
+ * Infers a possible KLib ABI dump for an unsupported target.
+ *
+ * To infer a dump, walk up the default targets hierarchy tree starting from the unsupported
+ * target until it finds a node corresponding to a group containing least one supported target.
+ *
+ * After that, dumps generated for such supported targets are merged and declarations that are
+ * common to all of them are considered as a common ABI that most likely will be shared by the
+ * unsupported target.
+ *
+ * At the next step, if a project contains an old dump, declarations specific to the unsupported
+ * target are copied from it and merged into the common ABI extracted previously.
+ *
+ * The resulting dump is then used as an inferred dump for the unsupported target.
+ */
 @BCVInternalApi
 @BCVExperimentalApi
 @OptIn(ExperimentalBCVApi::class)
@@ -38,6 +53,8 @@ abstract class KLibInferSignaturesWorker : WorkAction<KLibInferSignaturesWorker.
     val taskPath: Property<String>
   }
 
+  private val taskPath: String = parameters.taskPath.get()
+
   override fun execute() {
     // Find a set of supported targets that are closer to unsupported target in the hierarchy.
     // Note that dumps are stored using configurable name, but grouped by the canonical target name.
@@ -60,7 +77,7 @@ abstract class KLibInferSignaturesWorker : WorkAction<KLibInferSignaturesWorker.
       }
     if (extantImage == null) {
       logger.warn(
-        "Project's ABI file exists, but empty: ${extantApiDumpFile}. " +
+        "[$taskPath] Project's ABI file exists, but empty: ${extantApiDumpFile}. " +
             "The file will be ignored during ABI dump inference for the unsupported target "
 //            +  target.get()
       )