diff --git a/docsite/rst/playbooks_filters.rst b/docsite/rst/playbooks_filters.rst index 6e12e127c9..b9dfd4a579 100644 --- a/docsite/rst/playbooks_filters.rst +++ b/docsite/rst/playbooks_filters.rst @@ -324,25 +324,25 @@ Combining hashes/dictionaries .. versionadded:: 2.0 The `combine` filter allows hashes to be merged. For example, the -following would override keys in one hash: +following would override keys in one hash:: {{ {'a':1, 'b':2}|combine({'b':3}) }} -The resulting hash would be: +The resulting hash would be:: {'a':1, 'b':3} The filter also accepts an optional `recursive=True` parameter to not only override keys in the first hash, but also recurse into nested -hashes and merge their keys too: +hashes and merge their keys too:: {{ {'a':{'foo':1, 'bar':2}, 'b':2}|combine({'a':{'bar':3, 'baz':4}}, recursive=True) }} -This would result in: +This would result in:: {'a':{'foo':1, 'bar':3, 'baz':4}, 'b':2} -The filter can also take multiple arguments to merge: +The filter can also take multiple arguments to merge:: {{ a|combine(b, c, d) }}