From ee9339e73b93dfc564bbd2275f26bf8aeb36f450 Mon Sep 17 00:00:00 2001 From: John-David Dalton Date: Mon, 2 Nov 2015 13:12:44 -0600 Subject: [PATCH] Add shortcut fusion heuristic note to `lodash` docs. [ci skip] --- lodash.js | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/lodash.js b/lodash.js index b10a0ce74..6407bb769 100644 --- a/lodash.js +++ b/lodash.js @@ -1436,7 +1436,11 @@ * Lazy evaluation allows several methods to support shortcut fusion. Shortcut * fusion is an optimization strategy which merge iteratee calls; this can help * to avoid the creation of intermediate data structures and greatly reduce the - * number of iteratee executions. + * number of iteratee executions. Sections of a chain sequence may qualify for + * shortcut fusion if the section is applied to an array of at least two hundred + * elements and any iteratees or predicates accept only one argument. The + * heuristic for whether a section qualifies for shortcut fusion is subject + * to change. * * Chaining is supported in custom builds as long as the `_#value` method is * directly or indirectly included in the build.