aboutsummaryrefslogtreecommitdiff
path: root/vendor/github.com/homemade/scl/doc.go
diff options
context:
space:
mode:
Diffstat (limited to 'vendor/github.com/homemade/scl/doc.go')
-rw-r--r--vendor/github.com/homemade/scl/doc.go37
1 files changed, 37 insertions, 0 deletions
diff --git a/vendor/github.com/homemade/scl/doc.go b/vendor/github.com/homemade/scl/doc.go
new file mode 100644
index 0000000..ec34ae2
--- /dev/null
+++ b/vendor/github.com/homemade/scl/doc.go
@@ -0,0 +1,37 @@
+/*
+Package scl is an implementation of a parser for the Sepia Configuration
+Language.
+
+SCL is a simple, declarative, self-documenting, semi-functional language that
+extends HCL (as in https://github.com/hashicorp/hcl) in the same way that Sass
+extends CSS. What that means is, any properly formatted HCL is valid SCL. If
+you really enjoy HCL, you can keep using it exclusively: under the hood, SCL
+‘compiles’ to HCL. The difference is that now you can explicitly include
+files, use ‘mixins’ to quickly inject boilerplate code, and use properly
+scoped, natural variables. The language is designed to accompany Sepia (and,
+specifically, Sepia plugins) but it's a general purpose language, and can be
+used for pretty much any configurational purpose.
+
+Full documenation for the language itself, including a language specification,
+tutorials and examples, is available at https://github.com/homemade/scl/wiki.
+*/
+package scl
+
+/*
+MixinDoc documents a mixin from a particular SCL file. Since mixins can be nested, it
+also includes a tree of all child mixins.
+*/
+type MixinDoc struct {
+ Name string
+ File string
+ Line int
+ Reference string
+ Signature string
+ Docs string
+ Children MixinDocs
+}
+
+/*
+MixinDocs is a slice of MixinDocs, for convenience.
+*/
+type MixinDocs []MixinDoc