clarify retry vs retryable in docs. closes #1450

1 files changed, 2 insertions, 2 deletions

diff --git a/lib/retry.js b/lib/retry.js
index bd60644..391a4fa 100644
--- a/lib/retry.js
+++ b/lib/retry.js
@@ -76,8 +76,8 @@ import wrapAsync from './internal/wrapAsync';
  *     // do something with the result
  * });
  *
- * // It can also be embedded within other control flow functions to retry
- * // individual methods that are not as reliable, like this:
+ * // to retry individual methods that are not as reliable within other
+ * // control flow functions, use the `retryable` wrapper:
  * async.auto({
  *     users: api.getUsers.bind(api),
  *     payments: async.retryable(3, api.getPayments.bind(api))