From 5f8244a20da283ee46e147182b4a82c363ef3154 Mon Sep 17 00:00:00 2001
From: rpopma <rpopma@apache.org>
Date: Sun, 29 Oct 2017 22:02:23 +0900
Subject: [PATCH] [#221] Document workaround for Grapes bug on Groovy versions
 before 2.4.7. Closes #221

---
 RELEASE-NOTES.md |  1 +
 docs/index.adoc  | 10 ++++++++++
 2 files changed, 11 insertions(+)

diff --git a/RELEASE-NOTES.md b/RELEASE-NOTES.md
index 05774dd19..fdb9a0c57 100644
--- a/RELEASE-NOTES.md
+++ b/RELEASE-NOTES.md
@@ -5,6 +5,7 @@
 ## <a name="2.1.0-fixes"></a> Fixed issues
 
 - [#220] Improve tracing for positional parameters (provide detail on current position).
+- [#221] Document workaround for Grapes bug on Groovy versions before 2.4.7.
 
 # <a name="2.0.1"></a> Picocli 2.0.1
 
diff --git a/docs/index.adoc b/docs/index.adoc
index 5d492c87b..3ee0b224b 100644
--- a/docs/index.adoc
+++ b/docs/index.adoc
@@ -1899,6 +1899,16 @@ count.times {
 assert this.commandLine.commandName == "myCommand"
 ----
 
+CAUTION: When using a Groovy version older than 2.4.7, use this workaround for the https://issues.apache.org/jira/browse/GROOVY-7613[Grape bug] that causes this error:
+`java.lang.ClassNotFoundException: # Licensed to the Apache Software Foundation (ASF) under one or more`.
+
+[source,groovy]
+----
+@Grab('info.picocli:picocli:2.1.0-SNAPSHOT')
+@GrabExclude('org.codehaus.groovy:groovy-all') // work around GROOVY-7613
+...
+----
+
 === Kotlin
 Kotlin does not allow specifying an array https://kotlinlang.org/docs/reference/annotations.html[annotation]
  attribute as a single value,