From c0a99338d5a62b87a985223f0c477c9c2e48972b Mon Sep 17 00:00:00 2001 From: Dean Chen <862469039@qq.com> Date: Sat, 15 Aug 2026 17:52:40 +0500 Subject: [PATCH] docs(run): say list flags are repeated, not comma-separated `--dns list` in --help looks like it wants a comma-separated string. Repeat the flag instead. Fixes #2138 Signed-off-by: Dean Chen <862469039@qq.com> --- docs/reference/commandline/run.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs/reference/commandline/run.md b/docs/reference/commandline/run.md index d544a9cdf5fe..8402326d0577 100644 --- a/docs/reference/commandline/run.md +++ b/docs/reference/commandline/run.md @@ -117,3 +117,12 @@ Create and run a new container from an image +## Description + +Options whose type is `list` take one value per flag. Repeat the flag to pass +more than one value. A comma-separated string is a single item, not a list. + +```console +$ docker run --dns 8.8.8.8 --dns 1.1.1.1 --rm alpine getent hosts docker.com +``` +