From 8da126f79406f7f34cb6a1f9a502a5967fa81aca Mon Sep 17 00:00:00 2001
From: Dean Chen <862469039@qq.com>
Date: Sat, 15 Aug 2026 21:38:18 +0500
Subject: [PATCH] docs(man): note docker build uses BuildKit by default

The rest of this page still lists a lot of legacy-builder
flags. Point at buildx build for the current option set.

Signed-off-by: Dean Chen <862469039@qq.com>
---
 man/docker-build.1.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/man/docker-build.1.md b/man/docker-build.1.md
index 0b446a3f85c1..58e73798f3cc 100644
--- a/man/docker-build.1.md
+++ b/man/docker-build.1.md
@@ -36,6 +36,10 @@ docker-build - Build an image from a Dockerfile
 PATH | URL | -
 
 # DESCRIPTION
+**docker build** uses BuildKit by default. The flags listed in this page
+include options that only apply to the legacy builder. For the current
+BuildKit option set, see **docker buildx build**(1).
+
 This will read the Dockerfile from the directory specified in **PATH**.
 It also sends any other files and directories found in the current
 directory to the Docker daemon. The contents of this directory would