diff --git a/docs/sources/api/docker_remote_api.rst b/docs/sources/api/docker_remote_api.rst
index 1c46cf148a..fd268e2760 100644
--- a/docs/sources/api/docker_remote_api.rst
+++ b/docs/sources/api/docker_remote_api.rst
@@ -871,6 +871,7 @@ Build an image from Dockerfile via stdin
 	   {{ STREAM }}
 
 	:query t: tag to be applied to the resulting image in case of success
+	:query remote: URL to be fetch. Either a single Dockerfile or a Git repository
 	:statuscode 200: no error
         :statuscode 500: server error
 
diff --git a/docs/sources/commandline/command/build.rst b/docs/sources/commandline/command/build.rst
index 81120b22d2..4810ed46ff 100644
--- a/docs/sources/commandline/command/build.rst
+++ b/docs/sources/commandline/command/build.rst
@@ -8,9 +8,11 @@
 
 ::
 
-    Usage: docker build [OPTIONS] PATH | -
+    Usage: docker build [OPTIONS] PATH | URL | -
     Build a new container image from the source code at PATH
       -t="": Tag to be applied to the resulting image in case of success.
+    When a single Dockerfile is given as URL, then no context is set. When a git reppository is set as URL, the repository is used as context
+
 
 Examples
 --------
diff --git a/docs/sources/use/builder.rst b/docs/sources/use/builder.rst
index abd5b9ecb1..4cf4045f7d 100644
--- a/docs/sources/use/builder.rst
+++ b/docs/sources/use/builder.rst
@@ -132,6 +132,8 @@ curl was installed within the image.
 
 The `ADD` instruction will insert the files from the `<src>` path of the context into `<dest>` path 
 of the container.
+`<src>` can be a local path or a remote file URL.
+
 The context must be set in order to use this instruction. (see examples)
 
 3. Dockerfile Examples