Warn against the use of org.asciidoctor.convert 1.5.6

plugins {
  id 'org.asciidoctor.convert' version '1.5.6'
}

testCompile('org.springframework.restdocs:spring-restdocs-core:1.2.2.RELEASE')

The combination above will not replace

operation::my-example[snippets='httpie-request,http-request']

with the generated snippets.

Version 1.5.3 works.

[wilkinsona]

I’ve finally had some time to track this down. It’s a regression in the Asciidoctor Gradle plugin caused by https://github.com/asciidoctor/asciidoctor-gradle-plugin/pull/213. There’s an existing issue that is tracking the regression: https://github.com/asciidoctor/asciidoctor-gradle-plugin/issues/222. In addition to the problem occurring when using the daemon, it will also occur when using --continuous.

[wilkinsona]

Dropping back to 1.5.3 of the Asciidoctor Gradle plugin does indeed make the problem go away as @sdavids originally reported. The problem also doesn’t occur with 1.5.3 of the Gradle plugin and Asciidoctor 1.5.6.

In summary, it appears that a change in 1.5.6 of the Asciidoctor Gradle plugin interacts with something in Gradle’s daemon and triggers the problem.