Deprecate foreach-service

Author: pjeby

CLI.md

@@ -253,7 +253,7 @@ doco.cp() {
 Execute the given `doco` subcommand once for each service in the current service set, with the service set restricted to a single service for each subcommand invocation.  This can be useful for explicit multiple (or zero) execution of a command that is otherwise restricted in how many times it can be executed.
 
 ```shell
-doco.foreach() { foreach-service doco "$@"; }
+doco.foreach() { target @current foreach doco "$@"; }
 ```
 
 #### `jq`

Services.md

@@ -9,14 +9,6 @@ The services API depends on the [Targets API](Targets.md) and [bashup/events](ht
 
 ### Automation
 
-#### `foreach-service` *cmd args...*
-
-Invoke *cmd args...* once for each service in the current service set; the service set will contain exactly one service during each invocation.  Does nothing if the current service set is empty.
-
-```shell
-foreach-service() { target @current foreach "$@"; }
-```
-
 #### `have-services` *[compexpr]*
 
 Return true if the current service count matches the bash numeric comparison *compexpr*; if no *compexpr* is supplied, returns true if the current service count is non-zero.
@@ -144,5 +136,6 @@ set-alias() { target "$1" set "$@"; }
 with-alias() { target "$1" call "${@:2}"; }
 with-service() { mdsh-splitwords "$1"; with-targets @current "${REPLY[@]}" -- "${@:2}"; }
 find-services() { services-matching "$@"; }
+foreach-service() { target @current foreach "$@"; }
 ```
 

bin/doco

@@ -714,7 +714,6 @@ doco-target::get-env() {
 }
 
 doco-target::with-env() { this get-env || return; local "${REPLY[@]}"; "$@"; }
-foreach-service() { target @current foreach "$@"; }
 have-services() { target @current has-count "$@"; }
 project-name() {
     REPLY=${COMPOSE_PROJECT_NAME-}
@@ -771,6 +770,7 @@ set-alias() { target "$1" set "$@"; }
 with-alias() { target "$1" call "${@:2}"; }
 with-service() { mdsh-splitwords "$1"; with-targets @current "${REPLY[@]}" -- "${@:2}"; }
 find-services() { services-matching "$@"; }
+foreach-service() { target @current foreach "$@"; }
 # doco opt OPTION CMD...  --> run CMD with OPTION added to project options
 doco-opt() { local DOCO_OPTS=("${DOCO_OPTS[@]}" "$1"); "${@:2}"; }
 
@@ -1004,7 +1004,7 @@ doco.cp() {
     [[ "$seen" ]] || fail "cp: either source or destination must contain a :" || return
     docker cp ${opts[@]+"${opts[@]}"}
 }
-doco.foreach() { foreach-service doco "$@"; }
+doco.foreach() { target @current foreach doco "$@"; }
 doco.jq() { RUN_JQ "$@" <"$DOCO_CONFIG"; }
 doco.sh() { doco exec bash "$@"; }
 DEFINE "${mdsh_raw_jq_api[*]}"

specs/Services.cram.md

@@ -14,18 +14,6 @@
 
 ### Automation
 
-#### `foreach-service` *cmd args...*
-
-Invoke *cmd args...* once for each service in the current service set; the service set will contain exactly one service during each invocation.
-
-~~~shell
-    $ SERVICES foo bar
-    $ with-targets foo bar -- foreach-service eval 'echo "${DOCO_SERVICES[@]}"'
-    foo
-    bar
-    $ foreach-service eval 'echo "${DOCO_SERVICES[@]}"'
-~~~
-
 #### `have-services` *[compexpr]*
 
 Return true if the current service count matches the bash numeric comparison *compexpr*; if no *compexpr* is supplied, returns true if the current service count is non-zero.

specs/Targets.cram.md

@@ -314,7 +314,7 @@ Run *command* with a non-existent  `@current` target.
 
 #### `target` *target* `foreach` *command...*
 
-Run *command* zero or more times, once for each service in *target*, with the current target set to the corresponding service.
+Run *command* zero or more times, once for each service in *target*, with the current target set to the corresponding service.  Does nothing if the target is an empty group.
 
 ~~~shell
     $ target @current foreach declare -p DOCO_SERVICES   # no entries; doesn't run