From 1f69c574ebc01fe335b185dfad26637e455885fb Mon Sep 17 00:00:00 2001
From: Akhil Manoj <manoja2@vcu.edu>
Date: Sun, 5 Oct 2025 17:43:13 -0400
Subject: [PATCH] Docs: update --file flag to clarify input options

Expand the buildx build doc to include details on the supported input
options for the --file flag: local file path, remote URL, and stdin. Add
examples for each input type to enhance user understanding.

Signed-off-by: Akhil Manoj <akhil.manoj2003@gmail.com>
Signed-off-by: Akhil Manoj <manoja2@vcu.edu>
---
 docs/reference/buildx_build.md | 30 +++++++++++++++++++++++++++---
 1 file changed, 27 insertions(+), 3 deletions(-)

diff --git a/docs/reference/buildx_build.md b/docs/reference/buildx_build.md
index 4d85a6a47..d7443e3ab 100644
--- a/docs/reference/buildx_build.md
+++ b/docs/reference/buildx_build.md
@@ -553,13 +553,37 @@ the daemon runs the containers used in the build with the
 ### <a name="file"></a> Specify a Dockerfile (-f, --file)
 
 ```console
-$ docker buildx build -f <filepath> .
+$ docker buildx build -f [PATH|URL|-] .
 ```
 
-Specifies the filepath of the Dockerfile to use.
+Specifies the location of the Dockerfile to use.
 If unspecified, a file named `Dockerfile` at the root of the build context is used by default.
 
-To read a Dockerfile from stdin, you can use `-` as the argument for `--file`.
+The supported inputs formats are:
+
+- [`Local file path`](#local-file-path)
+- [`Remote URL`](#remote-url)
+- [`Standard input`](#standard-input)
+
+#### Local file path
+
+To specify a path to a local Dockerfile:
+
+```console
+$ docker buildx build -f path/to/Dockerfile .
+```
+
+#### Remote URL
+
+To specify a URL to a remote Dockerfile:
+
+```console
+$ docker buildx build -f https://raw.githubusercontent.com/docker/buildx/refs/tags/v0.29.0/Dockerfile .
+```
+
+#### Standard input
+
+To read a Dockerfile from stdin, use `-` as the argument:
 
 ```console
 $ cat Dockerfile | docker buildx build -f - .