Flank · jan-goral · May 1, 2020 · Apr 30, 2020 · Apr 30, 2020 · Apr 30, 2020
diff --git a/release_notes.md b/release_notes.md
@@ -1,4 +1,5 @@
 ## next (unreleased)
+- [#755](https://github.com/Flank/flank/pull/755) Remove ascii doc generated section header. ([jan-gogo](https://github.com/jan-gogo))
 - [#731](https://github.com/Flank/flank/pull/731) Refactor jUnit HTML report. ([Writhe](https://github.com/Writhe))
 - [#754](https://github.com/Flank/flank/pull/754) Sync README.md flank.yml flank.ios.yml. ([jan-gogo](https://github.com/jan-gogo))
 - [#746](https://github.com/Flank/flank/pull/746) Ignore apk with filtered out tests instead of failing. ([pawelpasterz](https://github.com/pawelpasterz))

diff --git a/test_runner/build.gradle.kts b/test_runner/build.gradle.kts
@@ -237,7 +237,7 @@ tasks.create("updateFlank", Exec::class.java) {
 }
 
 // begin --- ASCII doc generation ---
-val generateManpageAsciiDoc by tasks.registering(JavaExec::class) {
+val generateCliAsciiDoc by tasks.registering(JavaExec::class) {
     dependsOn(tasks.classes)
     classpath(
         configurations.compile,
@@ -254,7 +254,27 @@ val generateManpageAsciiDoc by tasks.registering(JavaExec::class) {
     )
 }
 
+val processCliAsciiDoc by tasks.registering {
+    dependsOn(generateCliAsciiDoc)
+    group = "Documentation"
+    doLast {
+        File("${project.rootDir}/docs/ascii").listFiles()?.forEach { file ->
+            file.apply {
+                readLines().run {
+                    val toRemove = IntRange(
+                        indexOf("// tag::picocli-generated-man-section-header[]"),
+                        indexOf("// end::picocli-generated-man-section-header[]")
+                    )
+                    filterIndexed { index, _ -> index !in toRemove }
+                }.joinToString("\n").let { text ->
+                    writeText(text)
+                }
+            }
+        }
+    }
+}
+
 tasks.assemble {
-    dependsOn(generateManpageAsciiDoc)
+    dependsOn(processCliAsciiDoc)
 }
 // end --- ASCII doc generation ---
diff --git a/test_runner/docs/ascii/flank.jar_-android-doctor.adoc b/test_runner/docs/ascii/flank.jar_-android-doctor.adoc
@@ -1,15 +1,4 @@
 // tag::picocli-generated-full-manpage[]
-// tag::picocli-generated-man-section-header[]
-:doctype: manpage
-:revnumber: 
-:manmanual: Flank.jar
- Manual
-:mansource: 
-:man-linkstyle: pass:[blue R < >]
-= flank.jar
--android-doctor(1)
-
-// end::picocli-generated-man-section-header[]
 
 // tag::picocli-generated-man-section-name[]
 == Name
@@ -49,4 +38,4 @@ Validates Android Flank YAML.
 
 // end::picocli-generated-man-section-options[]
 
-// end::picocli-generated-full-manpage[]
+// end::picocli-generated-full-manpage[]
diff --git a/test_runner/docs/ascii/flank.jar_-android-run.adoc b/test_runner/docs/ascii/flank.jar_-android-run.adoc
@@ -1,15 +1,4 @@
 // tag::picocli-generated-full-manpage[]
-// tag::picocli-generated-man-section-header[]
-:doctype: manpage
-:revnumber: 
-:manmanual: Flank.jar
- Manual
-:mansource: 
-:man-linkstyle: pass:[blue R < >]
-= flank.jar
--android-run(1)
-
-// end::picocli-generated-man-section-header[]
 
 // tag::picocli-generated-man-section-name[]
 == Name
@@ -235,4 +224,4 @@ Learn more at https://firebase.google.com/docs/test-lab/robo-ux-test#scripting.
 
 // end::picocli-generated-man-section-options[]
 
-// end::picocli-generated-full-manpage[]
+// end::picocli-generated-full-manpage[]
diff --git a/test_runner/docs/ascii/flank.jar_-android.adoc b/test_runner/docs/ascii/flank.jar_-android.adoc
@@ -1,15 +1,4 @@
 // tag::picocli-generated-full-manpage[]
-// tag::picocli-generated-man-section-header[]
-:doctype: manpage
-:revnumber: 
-:manmanual: Flank.jar
- Manual
-:mansource: 
-:man-linkstyle: pass:[blue R < >]
-= flank.jar
--android(1)
-
-// end::picocli-generated-man-section-header[]
 
 // tag::picocli-generated-man-section-name[]
 == Name
@@ -45,4 +34,4 @@ flank.jar
 
 // end::picocli-generated-man-section-commands[]
 
-// end::picocli-generated-full-manpage[]
+// end::picocli-generated-full-manpage[]
diff --git a/test_runner/docs/ascii/flank.jar_-auth-login.adoc b/test_runner/docs/ascii/flank.jar_-auth-login.adoc
@@ -1,15 +1,4 @@
 // tag::picocli-generated-full-manpage[]
-// tag::picocli-generated-man-section-header[]
-:doctype: manpage
-:revnumber: 
-:manmanual: Flank.jar
- Manual
-:mansource: 
-:man-linkstyle: pass:[blue R < >]
-= flank.jar
--auth-login(1)
-
-// end::picocli-generated-man-section-header[]
 
 // tag::picocli-generated-man-section-name[]
 == Name
@@ -42,4 +31,4 @@ Authenticates using your user account. For CI, a service account is recommended.
 
 // end::picocli-generated-man-section-options[]
 
-// end::picocli-generated-full-manpage[]
+// end::picocli-generated-full-manpage[]
diff --git a/test_runner/docs/ascii/flank.jar_-auth.adoc b/test_runner/docs/ascii/flank.jar_-auth.adoc
@@ -1,15 +1,4 @@
 // tag::picocli-generated-full-manpage[]
-// tag::picocli-generated-man-section-header[]
-:doctype: manpage
-:revnumber: 
-:manmanual: Flank.jar
- Manual
-:mansource: 
-:man-linkstyle: pass:[blue R < >]
-= flank.jar
--auth(1)
-
-// end::picocli-generated-man-section-header[]
 
 // tag::picocli-generated-man-section-name[]
 == Name
@@ -42,4 +31,4 @@ flank.jar
 
 // end::picocli-generated-man-section-commands[]
 
-// end::picocli-generated-full-manpage[]
+// end::picocli-generated-full-manpage[]
diff --git a/test_runner/docs/ascii/flank.jar_-cancel.adoc b/test_runner/docs/ascii/flank.jar_-cancel.adoc
@@ -1,15 +1,4 @@
 // tag::picocli-generated-full-manpage[]
-// tag::picocli-generated-man-section-header[]
-:doctype: manpage
-:revnumber: 
-:manmanual: Flank.jar
- Manual
-:mansource: 
-:man-linkstyle: pass:[blue R < >]
-= flank.jar
--cancel(1)
-
-// end::picocli-generated-man-section-header[]
 
 // tag::picocli-generated-man-section-name[]
 == Name
@@ -44,4 +33,4 @@ Reads in the matrix_ids.json file. Cancels any incomplete matrices.
 
 // end::picocli-generated-man-section-options[]
 
-// end::picocli-generated-full-manpage[]
+// end::picocli-generated-full-manpage[]
diff --git a/test_runner/docs/ascii/flank.jar_-firebase-cancel.adoc b/test_runner/docs/ascii/flank.jar_-firebase-cancel.adoc
@@ -1,15 +1,4 @@
 // tag::picocli-generated-full-manpage[]
-// tag::picocli-generated-man-section-header[]
-:doctype: manpage
-:revnumber: 
-:manmanual: Flank.jar
- Manual
-:mansource: 
-:man-linkstyle: pass:[blue R < >]
-= flank.jar
--firebase-cancel(1)
-
-// end::picocli-generated-man-section-header[]
 
 // tag::picocli-generated-man-section-name[]
 == Name
@@ -44,4 +33,4 @@ Reads in the matrix_ids.json file. Cancels any incomplete matrices.
 
 // end::picocli-generated-man-section-options[]
 
-// end::picocli-generated-full-manpage[]
+// end::picocli-generated-full-manpage[]
diff --git a/test_runner/docs/ascii/flank.jar_-firebase-refresh.adoc b/test_runner/docs/ascii/flank.jar_-firebase-refresh.adoc
@@ -1,15 +1,4 @@
 // tag::picocli-generated-full-manpage[]
-// tag::picocli-generated-man-section-header[]
-:doctype: manpage
-:revnumber: 
-:manmanual: Flank.jar
- Manual
-:mansource: 
-:man-linkstyle: pass:[blue R < >]
-= flank.jar
--firebase-refresh(1)
-
-// end::picocli-generated-man-section-header[]
 
 // tag::picocli-generated-man-section-name[]
 == Name
@@ -44,4 +33,4 @@ Reads in the matrix_ids.json file. Refreshes any incomplete matrices.
 
 // end::picocli-generated-man-section-options[]
 
-// end::picocli-generated-full-manpage[]
+// end::picocli-generated-full-manpage[]
diff --git a/test_runner/docs/ascii/flank.jar_-firebase-test-android-doctor.adoc b/test_runner/docs/ascii/flank.jar_-firebase-test-android-doctor.adoc
@@ -1,15 +1,4 @@
 // tag::picocli-generated-full-manpage[]
-// tag::picocli-generated-man-section-header[]
-:doctype: manpage
-:revnumber: 
-:manmanual: Flank.jar
- Manual
-:mansource: 
-:man-linkstyle: pass:[blue R < >]
-= flank.jar
--firebase-test-android-doctor(1)
-
-// end::picocli-generated-man-section-header[]
 
 // tag::picocli-generated-man-section-name[]
 == Name
@@ -49,4 +38,4 @@ Validates Android Flank YAML.
 
 // end::picocli-generated-man-section-options[]
 
-// end::picocli-generated-full-manpage[]
+// end::picocli-generated-full-manpage[]
diff --git a/test_runner/docs/ascii/flank.jar_-firebase-test-android-run.adoc b/test_runner/docs/ascii/flank.jar_-firebase-test-android-run.adoc
@@ -1,15 +1,4 @@
 // tag::picocli-generated-full-manpage[]
-// tag::picocli-generated-man-section-header[]
-:doctype: manpage
-:revnumber: 
-:manmanual: Flank.jar
- Manual
-:mansource: 
-:man-linkstyle: pass:[blue R < >]
-= flank.jar
--firebase-test-android-run(1)
-
-// end::picocli-generated-man-section-header[]
 
 // tag::picocli-generated-man-section-name[]
 == Name
@@ -247,4 +236,4 @@ Learn more at https://firebase.google.com/docs/test-lab/robo-ux-test#scripting.
 
 // end::picocli-generated-man-section-options[]
 
-// end::picocli-generated-full-manpage[]
+// end::picocli-generated-full-manpage[]
diff --git a/test_runner/docs/ascii/flank.jar_-firebase-test-android.adoc b/test_runner/docs/ascii/flank.jar_-firebase-test-android.adoc
@@ -1,15 +1,4 @@
 // tag::picocli-generated-full-manpage[]
-// tag::picocli-generated-man-section-header[]
-:doctype: manpage
-:revnumber: 
-:manmanual: Flank.jar
- Manual
-:mansource: 
-:man-linkstyle: pass:[blue R < >]
-= flank.jar
--firebase-test-android(1)
-
-// end::picocli-generated-man-section-header[]
 
 // tag::picocli-generated-man-section-name[]
 == Name
@@ -45,4 +34,4 @@ flank.jar
 
 // end::picocli-generated-man-section-commands[]
 
-// end::picocli-generated-full-manpage[]
+// end::picocli-generated-full-manpage[]
diff --git a/test_runner/docs/ascii/flank.jar_-firebase-test-ios-doctor.adoc b/test_runner/docs/ascii/flank.jar_-firebase-test-ios-doctor.adoc
@@ -1,15 +1,4 @@
 // tag::picocli-generated-full-manpage[]
-// tag::picocli-generated-man-section-header[]
-:doctype: manpage
-:revnumber: 
-:manmanual: Flank.jar
- Manual
-:mansource: 
-:man-linkstyle: pass:[blue R < >]
-= flank.jar
--firebase-test-ios-doctor(1)
-
-// end::picocli-generated-man-section-header[]
 
 // tag::picocli-generated-man-section-name[]
 == Name
@@ -49,4 +38,4 @@ Validates iOS YAML and connection to iOS catalog.
 
 // end::picocli-generated-man-section-options[]
 
-// end::picocli-generated-full-manpage[]
+// end::picocli-generated-full-manpage[]
diff --git a/test_runner/docs/ascii/flank.jar_-firebase-test-ios-run.adoc b/test_runner/docs/ascii/flank.jar_-firebase-test-ios-run.adoc
@@ -1,15 +1,4 @@
 // tag::picocli-generated-full-manpage[]
-// tag::picocli-generated-man-section-header[]
-:doctype: manpage
-:revnumber: 
-:manmanual: Flank.jar
- Manual
-:mansource: 
-:man-linkstyle: pass:[blue R < >]
-= flank.jar
--firebase-test-ios-run(1)
-
-// end::picocli-generated-man-section-header[]
 
 // tag::picocli-generated-man-section-name[]
 == Name
@@ -168,4 +157,4 @@ Configuration is read from flank.yml
 
 // end::picocli-generated-man-section-options[]
 
-// end::picocli-generated-full-manpage[]
+// end::picocli-generated-full-manpage[]
diff --git a/test_runner/docs/ascii/flank.jar_-firebase-test-ios.adoc b/test_runner/docs/ascii/flank.jar_-firebase-test-ios.adoc
@@ -1,15 +1,4 @@
 // tag::picocli-generated-full-manpage[]
-// tag::picocli-generated-man-section-header[]
-:doctype: manpage
-:revnumber: 
-:manmanual: Flank.jar
- Manual
-:mansource: 
-:man-linkstyle: pass:[blue R < >]
-= flank.jar
--firebase-test-ios(1)
-
-// end::picocli-generated-man-section-header[]
 
 // tag::picocli-generated-man-section-name[]
 == Name
@@ -45,4 +34,4 @@ flank.jar
 
 // end::picocli-generated-man-section-commands[]
 
-// end::picocli-generated-full-manpage[]
+// end::picocli-generated-full-manpage[]
diff --git a/test_runner/docs/ascii/flank.jar_-firebase-test-network-profiles-list.adoc b/test_runner/docs/ascii/flank.jar_-firebase-test-network-profiles-list.adoc
@@ -1,15 +1,4 @@
 // tag::picocli-generated-full-manpage[]
-// tag::picocli-generated-man-section-header[]
-:doctype: manpage
-:revnumber: 
-:manmanual: Flank.jar
- Manual
-:mansource: 
-:man-linkstyle: pass:[blue R < >]
-= flank.jar
--firebase-test-network-profiles-list(1)
-
-// end::picocli-generated-man-section-header[]
 
 // tag::picocli-generated-man-section-name[]
 == Name
@@ -34,4 +23,4 @@ flank.jar
 
 // end::picocli-generated-man-section-description[]
 
-// end::picocli-generated-full-manpage[]
+// end::picocli-generated-full-manpage[]