diff options
| author | kpdecker <kpdecker@gmail.com> | 2014-08-25 00:34:05 -0500 |
|---|---|---|
| committer | kpdecker <kpdecker@gmail.com> | 2014-08-25 00:34:05 -0500 |
| commit | 31f6fd7131e2d725666cf86c6042d40fa91d604e (patch) | |
| tree | 98848f60a5c250d9ca7046235d54070b1f6fa44e | |
| parent | c9886fdc0fc3d291cd19190e53687739125be34f (diff) | |
| download | handlebars.js-31f6fd7131e2d725666cf86c6042d40fa91d604e.zip handlebars.js-31f6fd7131e2d725666cf86c6042d40fa91d604e.tar.gz handlebars.js-31f6fd7131e2d725666cf86c6042d40fa91d604e.tar.bz2 | |
Merge mustache compatibility sections
| -rw-r--r-- | README.markdown | 15 |
1 files changed, 8 insertions, 7 deletions
diff --git a/README.markdown b/README.markdown index 4f8ccb7..7755286 100644 --- a/README.markdown +++ b/README.markdown @@ -252,6 +252,14 @@ You can also use real html comments if you want them to end up in the output. ``` +### Compatibility + +There are a few Mustache behaviors that Handlebars does not implement. +- Handlebars deviates from Mustache slightly in that it does not perform recursive lookup by default. The compile time `compat` flag must be set to enable this functionality. Users should note that there is a performance cost for enabling this flag. The exact cost varies by template, but it's recommended that performance sensitive operations should avoid this mode and instead opt for explicit path references. +- The optional Mustache-style lambdas are not supported. Instead Handlebars provides it's own lambda resolution that follows the behaviors of helpers. +- Alternative delimeters are not supported. + + Precompiling Templates ---------------------- @@ -337,13 +345,6 @@ does have some big performance advantages. Justin Marney, a.k.a. rewritten Handlebars (current version) is faster than the old version, with many [performance tests](https://travis-ci.org/wycats/handlebars.js/builds/33392182#L538) being 5 to 7 times faster than the Mustache equivalent. -Mustache Compatibilty ---------------------- - -Handlebars deviates from the Mustache spec in a few key ways: -- Alternative delimeters are not supported -- Recrusive value lookup is not enabled by default. The compile time `compat` flag must be set to enable this functionality. Users should note that there is a performance cost for enabling this flag. The exact cost varies by template, but it's recommended that performance sensitive operations should avoid this mode and instead opt for explicit path references. -- The optional Mustache-style lambdas are not supported. Instead Handlebars provides it's own lambda resolution that follows the behaviors of helpers. Upgrading --------- |