re-add the original heredoc example

Author: DannyBen

examples/README.md

@@ -58,4 +58,5 @@ Each of these examples demonstrates one aspect or feature of bashly.
 ## Other Examples
 
 - [heredoc](heredoc#readme) - using heredoc strings
+- [heredoc-alt](heredoc-alt#readme) - using heredoc strings in the lib directory
 - [settings](settings#readme) - using the settings.yml file to adjust bashly's behavior

examples/heredoc-alt/.gitignore

@@ -0,0 +1 @@
+cli

examples/heredoc-alt/README.md

@@ -0,0 +1,68 @@
+# Heredoc Alternative Example
+
+This example shows how you can use *Here document* (heredoc) constructs without
+forcing the entire script to use tab indentation. 
+
+Code in the `src/lib` directory is injected to your script as is, so in cases
+where you must use heredocs, this is where you can.
+
+This example was generated with:
+
+```bash
+$ bashly init
+$ bashly add lib
+# ... now edit src/bashly.yml to match the example ...
+# ... now edit src/root_command.sh to match the example ...
+# ... now edit src/lib/heredocs.sh to match the example ...
+$ bashly generate
+```
+
+<!-- include: src/root_command.sh src/lib/heredocs.sh -->
+
+-----
+
+## `bashly.yml`
+
+```yaml
+name: cli
+help: Sample application showing the use of heredoc
+version: 0.1.0
+```
+
+## `src/root_command.sh`
+
+```bash
+text="$(message1)"
+echo "$text"
+```
+
+## `src/lib/heredocs.sh`
+
+```bash
+message1() {
+  cat << EOF
+this is a
+  multiline
+    heredoc text
+EOF
+}
+
+```
+
+
+## Generated script output
+
+### `$ ./cli`
+
+```shell
+multiline
+heredoc text
+this is
+　an indented
+　　multiline text
+
+
+```
+
+
+

examples/heredoc-alt/src/bashly.yml

@@ -0,0 +1,3 @@
+name: cli
+help: Sample application showing the use of heredoc
+version: 0.1.0

examples/heredoc-alt/src/initialize.sh

@@ -0,0 +1,6 @@
+## Code here runs inside the initialize() function
+## Use it for anything that you need to run before any other function, like
+## setting environment vairables:
+## CONFIG_FILE=settings.ini
+##
+## Feel free to empty (but not delete) this file.

examples/heredoc-alt/src/lib/heredocs.sh

@@ -0,0 +1,7 @@
+message1() {
+  cat << EOF
+this is a
+  multiline
+    heredoc text
+EOF
+}

examples/heredoc-alt/src/root_command.sh

@@ -0,0 +1,2 @@
+text="$(message1)"
+echo "$text"

examples/heredoc-alt/test.sh

@@ -0,0 +1,9 @@
+#!/usr/bin/env bash
+
+set -x
+
+bashly generate
+
+### Try Me ###
+
+./cli

spec/approvals/examples/heredoc-alt

@@ -0,0 +1,10 @@
++ bashly generate
+creating user files in src
+skipped src/initialize.sh (exists)
+skipped src/root_command.sh (exists)
+created ./cli
+run ./cli --help to test your bash script
++ ./cli
+this is a
+  multiline
+    heredoc text