Skip to content

Commit 7d66be0

Browse files
committed
qualify :npm-deps caution - mark :fn-invoke-direct as alpha quality
1 parent ebf3539 commit 7d66be0

File tree

1 file changed

+12
-4
lines changed

1 file changed

+12
-4
lines changed

content/reference/compiler-options.adoc

+12-4
Original file line numberDiff line numberDiff line change
@@ -345,11 +345,12 @@ See also `:install-deps`.
345345

346346
[CAUTION]
347347
====
348-
The `:npm-deps` feature is in alpha status. Additionally, NPM dependencies
349-
configured in this manner are passed through Closure Compiler and not all NPM
350-
libraries contain Closure-compatible code.
348+
The `:npm-deps` feature is in alpha status for optimized builds. When applying
349+
Closure optimizations, NPM dependencies are passed through Closure Compiler and
350+
not all NPM libraries contain Closure-compatible code.
351351
352-
A reliable alternative can be found with <<xref/../../guides/webpack#,ClojureScript with Webpack>>.
352+
A reliable alternative can be found with
353+
<<xref/../../guides/webpack#,ClojureScript with Webpack>>.
353354
====
354355

355356
[source,clojure]
@@ -478,6 +479,13 @@ around 10-30%. Higher order function that don't implement the `IFn` protocol
478479
are normally called with `f.call(null, arg0, arg1 ...)`. With this option
479480
enabled the compiler calls them with a faster `f(arg0, arg1 ...` instead.
480481

482+
[CAUTION]
483+
====
484+
The `:fn-invoke-direct` feature is in alpha status. For some libraries such
485+
as Reagent, `:fn-invoke-direct` is known to generate incorrect code.
486+
====
487+
488+
481489
[source,clojure]
482490
----
483491
:fn-invoke-direct true

0 commit comments

Comments
 (0)