From aa2785cc7a429d2d6c7f4b1df7ac527c0b07d0e1 Mon Sep 17 00:00:00 2001
From: Fedor Isakov <fisakov@gmail.com>
Date: Thu, 7 May 2020 08:40:28 +0200
Subject: [PATCH] Document procedure to diagnose gradle build failure.

---
 build.gradle | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/build.gradle b/build.gradle
index 08594083..1c46d3f6 100644
--- a/build.gradle
+++ b/build.gradle
@@ -1,6 +1,17 @@
 import groovy.xml.MarkupBuilder
 import java.util.regex.*
 
+// In case gradle build fails to execute any of the tasks imported from
+// buid.xml, try the following steps: 
+//
+// 1. Uncomment the following section importing the task-tree plugin
+// 2. Run `./gradlew assemble taskTree --no-repeat`
+//
+// If the above command generates suspiciously-looking output and never
+// finishes, the most likely cause is that the target definitions in Ant
+// build.xml file have cyclic dependencies. This needs to be fixed in build
+// script, and build.xml regenerated.
+
 //plugins {
 //  id "com.dorongold.task-tree" version "1.5"
 //}