Merge pull request #3451 from AkhilManoj03/3121-improve-file-flag-docs

Docs: document remote URL support for --file flag in buildx build

Author: tonistiigi

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 - .