Merge pull request #492 from hairyhenderson/tmpl-exec-func-444-485

New tmpl.Exec function

1 files changed, 33 insertions, 0 deletions

diff --git a/docs/content/functions/tmpl.md b/docs/content/functions/tmpl.md
index 64a0bf64..f6da5f4d 100644
--- a/docs/content/functions/tmpl.md
+++ b/docs/content/functions/tmpl.md
@@ -7,6 +7,39 @@ menu:
 
 Functions for defining or executing templates.
 
+## `tmpl.Exec`
+
+Execute (render) the named template. This is equivalent to using the [`template`](https://golang.org/pkg/text/template/#hdr-Actions) action, except the result is returned as a string.
+
+This allows for post-processing of templates.
+
+### Usage
+```go
+tmpl.Exec name [context] 
+```
+
+```go
+context | tmpl.Exec name  
+```
+
+### Arguments
+
+| name | description |
+|------|-------------|
+| `name` | _(required)_ The template's name. |
+| `context` | _(optional)_ The context to use. |
+
+### Examples
+
+```console
+$ gomplate -i '{{define "T1"}}hello, world!{{end}}{{ tmpl.Exec "T1" | strings.ToUpper }}'
+HELLO, WORLD!
+```
+```console
+$ gomplate -i '{{define "T1"}}hello, {{.}}{{end}}{{ tmpl.Exec "T1" "world!" | strings.Title }}'
+Hello, World!
+```
+
 ## `tmpl.Inline`
 
 **Alias:** `tpl`