hcl/ext/README.md

# HCL Extensions

This directory contains some packages implementing some extensions to HCL
that add features by building on the core API in the main `hcl` package.

These serve as optional language extensions for use-cases that are limited only
to specific callers. Generally these make the language more expressive at
the expense of increased dynamic behavior that may be undesirable for
applications that need to impose more rigid structure on configuration.
Update doc comments and readmes for zcl -> HCL. 2017-09-11 23:56:31 +00:00			`# HCL Extensions`
ext: A directory for packages implementing zcl language extensions These will provide additional language features that are implemented in terms of the basic zcl functionality, so that applications can opt-in to some more-dynamic behavior if desired. The general pattern here will be to provide a function that partially-decodes a given zcl.Body to look for certain block types and then returns its result along with a zcl.Body representing the remaining, as-yet-unprocessed content. 2017-07-26 01:30:59 +00:00
Update doc comments and readmes for zcl -> HCL. 2017-09-11 23:56:31 +00:00			`This directory contains some packages implementing some extensions to HCL`
			that add features by building on the core API in the main `hcl` package.
ext: A directory for packages implementing zcl language extensions These will provide additional language features that are implemented in terms of the basic zcl functionality, so that applications can opt-in to some more-dynamic behavior if desired. The general pattern here will be to provide a function that partially-decodes a given zcl.Body to look for certain block types and then returns its result along with a zcl.Body representing the remaining, as-yet-unprocessed content. 2017-07-26 01:30:59 +00:00
			`These serve as optional language extensions for use-cases that are limited only`
			`to specific callers. Generally these make the language more expressive at`
			`the expense of increased dynamic behavior that may be undesirable for`
			`applications that need to impose more rigid structure on configuration.`