Set mdsh cache directory globally

Author: pjeby

Config.md

@@ -52,6 +52,7 @@ Either way, service targets are created for any services that don't already have
 ```shell
 loco_loadproject() {
     cd "$LOCO_ROOT"; [[ ! -f .env ]] || export-env .env
+    mdsh-use-cache "$LOCO_ROOT/.doco-cache/includes"
     export COMPOSE_FILE=$LOCO_ROOT/.doco-cache.json COMPOSE_PATH_SEPARATOR=$'\n'
     local json=$COMPOSE_FILE; DOCO_CONFIG=
 
@@ -191,7 +192,6 @@ Source the mdsh compilation  of the specified markdown file, saving it in *cache
 include() {
     realpath.absolute "$1"
     if [[ ! "${2-}" ]]; then
-        local MDSH_CACHE="$LOCO_ROOT/.doco-cache/includes"
         @require "doco-include:$REPLY" mdsh-run "$1" ""
     else
         __include() { mdsh-make "$1" "$2"; source "$2"; }

bin/doco

@@ -452,6 +452,7 @@ loco_preconfig() {
 }
 loco_loadproject() {
     cd "$LOCO_ROOT"; [[ ! -f .env ]] || export-env .env
+    mdsh-use-cache "$LOCO_ROOT/.doco-cache/includes"
     export COMPOSE_FILE=$LOCO_ROOT/.doco-cache.json COMPOSE_PATH_SEPARATOR=$'\n'
     local json=$COMPOSE_FILE; DOCO_CONFIG=
 
@@ -526,7 +527,6 @@ export-source() {
 include() {
     realpath.absolute "$1"
     if [[ ! "${2-}" ]]; then
-        local MDSH_CACHE="$LOCO_ROOT/.doco-cache/includes"
         @require "doco-include:$REPLY" mdsh-run "$1" ""
     else
         __include() { mdsh-make "$1" "$2"; source "$2"; }

specs/Config.cram.md

@@ -99,14 +99,30 @@ Either way, service targets are created for any services that don't already have
     > doco.dump() { echo "${DOCO_SERVICES[@]}"; echo "$FOO"; }
     > event on "finalize project" echo "hi!"
     > event on "before commands" declare -p __doco_target__2d_2dall
+    > include "$TESTDIR/../README.md"
+    > include "dummy.md" test-caching.sh
+    > include "dummy.md"  # multiple includes of same file are a no-op
+    > EOF
+
+    $ cat <<'EOF' >dummy.md
+    > ```shell
+    > echo "dummy loaded"
+    > ```
     > EOF
 
     $ run-doco t dump
+    dummy loaded
     hi!
-    declare -ar __doco_target__2d_2dall=([0]="t")
+    declare -ar __doco_target__2d_2dall=([0]="t" [1]="example1")
     t
     baz'bar
 
+    $ ls .doco-cache/includes  # cached compiled README
+    *%2Fspecs%2F..%2FREADME.md (glob)
+
+    $ cat test-caching.sh
+    echo "dummy loaded"
+
 # doco command(s) can't be run from config:
 
     $ echo 'doco --all' >.doco