@@ -776,23 +776,23 @@ defmodule Macro do
776
776
777
777
## Options
778
778
779
- * `:unquote` - when true, this function leaves `unquote/1` and
779
+ * `:unquote` - when ` true` , this function leaves `unquote/1` and
780
780
`unquote_splicing/1` expressions unescaped, effectively unquoting
781
781
the contents on escape. This option is useful only when escaping
782
- ASTs which may have quoted fragments in them. Defaults to false.
782
+ ASTs which may have quoted fragments in them. Defaults to ` false` .
783
783
784
- * `:prune_metadata` - when true, removes metadata from escaped AST
784
+ * `:prune_metadata` - when ` true` , removes most metadata from escaped AST
785
785
nodes. Note this option changes the semantics of escaped code and
786
- it should only be used when escaping ASTs. Defaults to false.
786
+ it should only be used when escaping ASTs. Defaults to ` false` .
787
787
788
- As an example, `ExUnit` stores the AST of every assertion, so when
789
- an assertion fails we can show code snippets to users. Without this
790
- option, each time the test module is compiled, we get a different
791
- MD5 of the module bytecode, because the AST contains metadata,
788
+ As an example for `:prune_metadata` , `ExUnit` stores the AST of every
789
+ assertion, so when an assertion fails we can show code snippets to users.
790
+ Without this option, each time the test module is compiled, we would get a
791
+ different MD5 of the module bytecode, because the AST contains metadata,
792
792
such as counters, specific to the compilation environment. By pruning
793
793
the metadata, we ensure that the module is deterministic and reduce
794
794
the amount of data `ExUnit` needs to keep around. Only the minimal
795
- amount of metadata is kept, such as `:line` and `:no_parens `.
795
+ amount of metadata is kept, such as `:line`, `:no_parens` and `:delimiter `.
796
796
797
797
## Comparison to `quote/2`
798
798
0 commit comments