From 39eaee950e38dbf2727a045d07caa09d8a76d75a Mon Sep 17 00:00:00 2001
From: Dean Chen <862469039@qq.com>
Date: Fri, 14 Aug 2026 02:40:04 +0500
Subject: [PATCH] docs: say what PATH, URL, and - mean on docker build

Signed-off-by: Dean Chen <862469039@qq.com>
---
 data/cli/engine/docker_build.yaml | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/data/cli/engine/docker_build.yaml b/data/cli/engine/docker_build.yaml
index fc9886436827..1c21c2b90a68 100644
--- a/data/cli/engine/docker_build.yaml
+++ b/data/cli/engine/docker_build.yaml
@@ -1,7 +1,12 @@
 command: docker build
 aliases: docker image build, docker build, docker builder build
 short: Build an image from a Dockerfile
-long: Build an image from a Dockerfile
+long: |-
+    Build an image from a Dockerfile.
+
+    `PATH` is a local directory used as the [build context](/manuals/build/concepts/context.md)
+    (commonly `.`). `URL` is a remote Git repository or tarball. `-` reads a
+    Dockerfile or tarball from standard input.
 usage: docker build [OPTIONS] PATH | URL | -
 pname: docker
 plink: docker.yaml