From f589ae1e417ba049f79a0aa4d232fc5fd1203a36 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
 <41898282+github-actions[bot]@users.noreply.github.com>
Date: Thu, 26 Mar 2026 03:13:45 +0000
Subject: [PATCH] cli: sync docs with docker/cli v29.3.0

---
 data/cli/engine/docker_service_create.yaml | 19 ++++++++++++++++++-
 data/cli/engine/docker_stack_ps.yaml       | 16 ++++++++--------
 2 files changed, 26 insertions(+), 9 deletions(-)

diff --git a/data/cli/engine/docker_service_create.yaml b/data/cli/engine/docker_service_create.yaml
index 6e111f7744..7653d2b94a 100644
--- a/data/cli/engine/docker_service_create.yaml
+++ b/data/cli/engine/docker_service_create.yaml
@@ -1165,6 +1165,22 @@ examples: |-
           When the option is not specified, the default behavior corresponds to setting <tt>enabled</tt>.
         </td>
       </tr>
+      <tr>
+        <td><b>bind-create-src</b></td>
+        <td>
+          By default, bind mounts require the source path to exist on the daemon host. This is a significant difference
+          from the <tt>-v</tt> flag, which creates the source path if it doesn't exist.<br />
+          <br />
+          Set <tt>bind-create-src</tt> to create the source path on the daemon host if it doesn't exist.<br />
+          <br />
+          A value is optional:<br />
+          <br />
+          <ul>
+            <li><tt>true</tt> or <tt>1</tt>: Create path on the daemon host if it doesn't exist.</li>
+            <li><tt>false</tt> or <tt>0</tt>: Default behavior. Produces an error if the source path doesn't exist on the daemon host.</li>
+          </ul>
+        </td>
+      </tr>
     </table>
 
     ##### Bind propagation
@@ -1299,7 +1315,8 @@ examples: |-
 
     - When you use `--mount` with `type=bind`, the host-path must refer to an *existing*
       path on the host. The path will not be created for you and the service will fail
-      with an error if the path does not exist.
+      with an error if the path does not exist. You can use `bind-create-src` to
+      create the host path if it doesn't exist.
 
     - The `--mount` flag does not allow you to relabel a volume with `Z` or `z` flags,
       which are used for `selinux` labeling.
diff --git a/data/cli/engine/docker_stack_ps.yaml b/data/cli/engine/docker_stack_ps.yaml
index daaee38f62..7cb116cc9d 100644
--- a/data/cli/engine/docker_stack_ps.yaml
+++ b/data/cli/engine/docker_stack_ps.yaml
@@ -255,14 +255,14 @@ examples: |-
     $ docker stack ps --no-trunc voting
 
     ID                          NAME                  IMAGE                                                                                                                 NODE   DESIRED STATE  CURREN STATE           ERROR  PORTS
-    xim5bcqtgk1bxqz91jzo4a1s5   voting_worker.1       dockersamples/examplevotingapp_worker:latest@sha256:3e4ddf59c15f432280a2c0679c4fc5a2ee5a797023c8ef0d3baf7b1385e9fed   node2  Running        Runnin 32 minutes ago
-    q7yik0ks1in6kv32gg6y6yjf7   voting_result.1       dockersamples/examplevotingapp_result:before@sha256:83b56996e930c292a6ae5187fda84dd6568a19d97cdb933720be15c757b7463   node1  Running        Runnin 32 minutes ago
-    rx5yo0866nfxc58zf4irsss6n   voting_vote.1         dockersamples/examplevotingapp_vote:before@sha256:8e64b182c87de902f2b72321c89b4af4e2b942d76d0b772532ff27ec4c6ebf6     node3  Running        Runnin 32 minutes ago
-    tz6j82jnwrx7n2offljp3mn03   voting_db.1           postgres:9.4@sha256:6046af499eae34d2074c0b53f9a8b404716d415e4a03e68bc1d2f8064f2b027                                   node1  Running        Runnin 32 minutes ago
-    w48spazhbmxcmbjfi54gs7x90   voting_redis.1        redis:alpine@sha256:9cd405cd1ec1410eaab064a1383d0d8854d1ef74a54e1e4a92fb4ec7bdc3ee7                                   node2  Running        Runnin 32 minutes ago
-    6jj1m02freg1n3z9n1evrzsbl   voting_visualizer.1   dockersamples/visualizer:stable@sha256:f924ad66c8e94b10baaf7bdb9cd491ef4e982a1d048a56a17e02bf5945401e5                node1  Running        Runnin 32 minutes ago
-    kqgdmededccbhz2wuc0e9hx7g   voting_vote.2         dockersamples/examplevotingapp_vote:before@sha256:8e64b182c87de902f2b72321c89b4af4e2b942d76d0b772532ff27ec4c6ebf6     node2  Running        Runnin 32 minutes ago
-    t72q3z038jehe1wbh9gdum076   voting_redis.2        redis:alpine@sha256:9cd405cd1ec1410eaab064a1383d0d8854d1ef74a54e1e4a92fb4ec7bdc3ee7                                   node3  Running        Runnin 32 minutes ago
+    xim5bcqtgk1bxqz91jzo4a1s5   voting_worker.1       dockersamples/examplevotingapp_worker:latest@sha256:3e4ddf59c15f432280a2c0679c4fc5a2ee5a797023c8ef0d3baf7b1385e9fed   node2  Running        Running 32 minutes ago
+    q7yik0ks1in6kv32gg6y6yjf7   voting_result.1       dockersamples/examplevotingapp_result:before@sha256:83b56996e930c292a6ae5187fda84dd6568a19d97cdb933720be15c757b7463   node1  Running        Running 32 minutes ago
+    rx5yo0866nfxc58zf4irsss6n   voting_vote.1         dockersamples/examplevotingapp_vote:before@sha256:8e64b182c87de902f2b72321c89b4af4e2b942d76d0b772532ff27ec4c6ebf6     node3  Running        Running 32 minutes ago
+    tz6j82jnwrx7n2offljp3mn03   voting_db.1           postgres:9.4@sha256:6046af499eae34d2074c0b53f9a8b404716d415e4a03e68bc1d2f8064f2b027                                   node1  Running        Running 32 minutes ago
+    w48spazhbmxcmbjfi54gs7x90   voting_redis.1        redis:alpine@sha256:9cd405cd1ec1410eaab064a1383d0d8854d1ef74a54e1e4a92fb4ec7bdc3ee7                                   node2  Running        Running 32 minutes ago
+    6jj1m02freg1n3z9n1evrzsbl   voting_visualizer.1   dockersamples/visualizer:stable@sha256:f924ad66c8e94b10baaf7bdb9cd491ef4e982a1d048a56a17e02bf5945401e5                node1  Running        Running 32 minutes ago
+    kqgdmededccbhz2wuc0e9hx7g   voting_vote.2         dockersamples/examplevotingapp_vote:before@sha256:8e64b182c87de902f2b72321c89b4af4e2b942d76d0b772532ff27ec4c6ebf6     node2  Running        Running 32 minutes ago
+    t72q3z038jehe1wbh9gdum076   voting_redis.2        redis:alpine@sha256:9cd405cd1ec1410eaab064a1383d0d8854d1ef74a54e1e4a92fb4ec7bdc3ee7                                   node3  Running        Running 32 minutes ago
     ```
 
     ### Only display task IDs (-q, --quiet) {#quiet}