Sebastiaan van Stijn 3c244d1099 deprecate "--pause" flag on docker commit in favor of "--no-pause" ...

Commit [moby@17d870b] (API v1.13, docker v1.1.0) changed the default to pause
containers during commit, keeping the behavior opt-in for older API versions.
This version-gate was removed in [moby@1b1147e] because API versions lower
than v1.23 were no longer supported.

This patch deprecates the `--pause` flag in favor of a `--no-pause` flag to
be more explicit on the default. The old `--pause` flag is marked deprecated
but still functional. Using the deprecated flag will print a warning, and an
error is produced when trying to use both the old and new flag;

    docker commit --pause mycontainer
    Flag --pause has been deprecated, and enabled by default. Use --no-pause to disable pausing during commit.

    docker commit --pause=false mycontainer
    Flag --pause has been deprecated, and enabled by default. Use --no-pause to disable pausing during commit.

    docker commit --pause --no-pause mycontainer
    Flag --pause has been deprecated, use --no-pause instead
    conflicting options: --no-pause and --pause cannot be used together

[moby@17d870b]: 17d870bed5
[moby@1b1147e]: 1b1147e46b

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>

2025-09-22 15:41:22 +02:00

..

attach.md

chore: regenerate docs

2024-07-04 10:30:56 +02:00

bake.md

add top-level "docker bake" command as alias for "docker buildx bake"

2025-04-11 16:28:47 +02:00

build.md

build: remove DCT support for classic builder

2025-07-21 19:05:38 +02:00

builder_build.md

build: remove DCT support for classic builder

2025-07-21 19:05:38 +02:00

builder_prune.md

chore: regenerate docs

2024-07-04 10:30:56 +02:00

builder.md

docs: generate markdown

2023-01-06 22:36:47 +01:00

checkpoint_create.md

chore: regenerate docs

2024-07-04 10:30:56 +02:00

checkpoint_ls.md

docs: generate markdown

2023-01-06 22:36:47 +01:00

checkpoint_rm.md

docs: generate markdown

2023-01-06 22:36:47 +01:00

checkpoint.md

docs: minor editorial improvements, typo fixes

2023-12-19 17:15:38 +01:00

commit.md

deprecate "--pause" flag on docker commit in favor of "--no-pause"

2025-09-22 15:41:22 +02:00

config_create.md

docs: use gh alert syntax for callouts

2024-08-16 11:02:10 +02:00

config_inspect.md

docs: use gh alert syntax for callouts

2024-08-16 11:02:10 +02:00

config_ls.md

docs: use gh alert syntax for callouts

2024-08-16 11:02:10 +02:00

config_rm.md

docs: use gh alert syntax for callouts

2024-08-16 11:02:10 +02:00

config.md

docs: generate markdown

2023-01-06 22:36:47 +01:00

container_attach.md

docs: use gh alert syntax for callouts

2024-08-16 11:02:10 +02:00

container_commit.md

deprecate "--pause" flag on docker commit in favor of "--no-pause"

2025-09-22 15:41:22 +02:00

container_cp.md

chore: regenerate docs

2024-07-04 10:30:56 +02:00

container_create.md

cli/command/container: fully deprecate --kernel-memory options

2025-09-16 15:36:45 +02:00

container_diff.md

docs: rename cli reference aliases to canonical

2024-01-15 11:29:30 +01:00

container_exec.md

chore: regenerate docs

2024-07-04 10:30:56 +02:00

container_export.md

docs: update internal links after refactor

2024-08-11 16:58:08 +02:00

container_inspect.md

chore: regenerate docs

2024-07-04 10:30:56 +02:00

container_kill.md

docs: use gh alert syntax for callouts

2024-08-16 11:02:10 +02:00

container_logs.md

docs: update internal links after refactor

2024-08-11 16:58:08 +02:00

container_ls.md

docs: update internal links after refactor

2024-08-11 16:58:08 +02:00

container_pause.md

docs: rename cli reference aliases to canonical

2024-01-15 11:29:30 +01:00

container_port.md

docs: rename cli reference aliases to canonical

2024-01-15 11:29:30 +01:00

container_prune.md

docs: Link supported Go duration strings

2024-10-07 10:37:00 +02:00

container_rename.md

docs: rename cli reference aliases to canonical

2024-01-15 11:29:30 +01:00

container_restart.md

docs: fix broken anchor-link in "container restart" reference

2025-02-21 23:45:32 +01:00

container_rm.md

chore: regenerate docs

2024-07-04 10:30:56 +02:00

container_run.md

cli/command/container: fully deprecate --kernel-memory options

2025-09-16 15:36:45 +02:00

container_start.md

chore: regenerate docs

2024-07-04 10:30:56 +02:00

container_stats.md

docs: use gh alert syntax for callouts

2024-08-16 11:02:10 +02:00

container_stop.md

cli/command/container: stop, restart: rename "--time" to "--timeout"

2024-09-30 09:43:54 +02:00

container_top.md

docs: rename cli reference aliases to canonical

2024-01-15 11:29:30 +01:00

container_unpause.md

docs: rename cli reference aliases to canonical

2024-01-15 11:29:30 +01:00

container_update.md

docs: use gh alert syntax for callouts

2024-08-16 11:02:10 +02:00

container_wait.md

docs: use gh alert syntax for callouts

2024-08-16 11:02:10 +02:00

container.md

docs: generate markdown

2023-01-06 22:36:47 +01:00

context_create.md

docs: minor editorial improvements, typo fixes

2023-12-19 17:15:38 +01:00

context_export.md

docs: generate markdown

2023-01-06 22:36:47 +01:00

context_import.md

docs: generate markdown

2023-01-06 22:36:47 +01:00

context_inspect.md

docs: generate markdown

2023-01-06 22:36:47 +01:00

context_ls.md

chore: regenerate docs

2024-07-04 10:30:56 +02:00

context_rm.md

chore: regenerate docs

2024-07-04 10:30:56 +02:00

context_show.md

docs: generate markdown

2023-01-06 22:36:47 +01:00

context_update.md

docs: generate markdown

2023-01-06 22:36:47 +01:00

context_use.md

docs: minor editorial improvements, typo fixes

2023-12-19 17:15:38 +01:00

context.md

docs: generate markdown

2023-01-06 22:36:47 +01:00

cp.md

chore: regenerate docs

2024-07-04 10:30:56 +02:00

create.md

cli/command/container: fully deprecate --kernel-memory options

2025-09-16 15:36:45 +02:00

diff.md

docs: regenerate stubs for non-canonical commands

2024-01-15 13:49:53 +01:00

docker.md

cli/flags: add "hostVar" to handle --host / -H as a single string

2025-08-18 11:01:39 +02:00

events.md

docs: regenerate stubs for non-canonical commands

2024-01-15 13:49:53 +01:00

exec.md

chore: regenerate docs

2024-07-04 10:30:56 +02:00

export.md

docs: regenerate stubs for non-canonical commands

2024-01-15 13:49:53 +01:00

history.md

image/history: Add --platform flag

2024-10-10 17:00:43 +02:00

image_build.md

build: remove DCT support for classic builder

2025-07-21 19:05:38 +02:00

image_history.md

image/history: Add --platform flag

2024-10-10 17:00:43 +02:00

image_import.md

docs: import: add example for multiple --change flags

2025-05-06 19:40:53 +02:00

image_inspect.md

image/inspect: Add --platform flag

2025-04-11 15:53:41 +02:00

image_load.md

Update markdown docs to indicate multi-platform support in image load/save.

2025-06-10 16:42:39 -07:00

image_ls.md

image/list: Add --tree flag

2024-08-16 15:09:51 +02:00

image_prune.md

docs: Link supported Go duration strings

2024-10-07 10:37:00 +02:00

image_pull.md

docs: use gh alert syntax for callouts

2024-08-16 11:02:10 +02:00

image_push.md

push: Improve note message and colors

2024-07-10 11:36:40 +02:00

image_rm.md

image rm: add --platform option

2025-05-27 10:58:11 +02:00

image_save.md

Update markdown docs to indicate multi-platform support in image load/save.

2025-06-10 16:42:39 -07:00

image_tag.md

docs: update prose about image tag/name format

2024-10-17 12:36:32 +02:00

image.md

docs: generate markdown

2023-01-06 22:36:47 +01:00

images.md

image/list: Add --tree flag

2024-08-16 15:09:51 +02:00

import.md

docs: regenerate stubs for non-canonical commands

2024-01-15 13:49:53 +01:00

index.md

docs: update links to docker cli reference

2024-07-04 10:28:53 +02:00

info.md

docs: regenerate stubs for non-canonical commands

2024-01-15 13:49:53 +01:00

inspect.md

Merge pull request #6052 from thaJeztah/inspect_completion

2025-05-06 20:29:54 +02:00

kill.md

docs: regenerate stubs for non-canonical commands

2024-01-15 13:49:53 +01:00

load.md

Update markdown docs to indicate multi-platform support in image load/save.

2025-06-10 16:42:39 -07:00

login.md

login: improve text on already authenticated and on OAuth login

2025-02-05 12:32:24 +01:00

logout.md

docs: generate markdown

2023-01-06 22:36:47 +01:00

logs.md

chore: regenerate docs

2024-07-04 10:30:56 +02:00

manifest_annotate.md

docs: generate markdown

2023-01-06 22:36:47 +01:00

manifest_create.md

chore: regenerate docs

2024-07-04 10:30:56 +02:00

manifest_inspect.md

chore: regenerate docs

2024-07-04 10:30:56 +02:00

manifest_push.md

chore: regenerate docs

2024-07-04 10:30:56 +02:00

manifest_rm.md

docs: generate markdown

2023-01-06 22:36:47 +01:00

manifest.md

docs: use gh alert syntax for callouts

2024-08-16 11:02:10 +02:00

network_connect.md

run, create, connect: add support for gw-priority

2024-12-03 15:13:08 +01:00

network_create.md

Add option '--ipv4'

2024-12-10 15:51:21 +00:00

network_disconnect.md

chore: regenerate docs

2024-07-04 10:30:56 +02:00

network_inspect.md

chore: regenerate docs

2024-07-04 10:30:56 +02:00

network_ls.md

docs: network ls add heading and anchor for "--no-trunc"

2025-02-21 23:51:04 +01:00

network_prune.md

docs: Link supported Go duration strings

2024-10-07 10:37:00 +02:00

network_rm.md

chore: regenerate docs

2024-07-04 10:30:56 +02:00

network.md

docs: generate markdown

2023-01-06 22:36:47 +01:00

node_demote.md

docs: use gh alert syntax for callouts

2024-08-16 11:02:10 +02:00

node_inspect.md

docs: use gh alert syntax for callouts

2024-08-16 11:02:10 +02:00

node_ls.md

docs: use gh alert syntax for callouts

2024-08-16 11:02:10 +02:00

node_promote.md

docs: use gh alert syntax for callouts

2024-08-16 11:02:10 +02:00

node_ps.md

docs: update example redis tags from 3.0.x to 7.4.x

2024-11-05 11:20:17 +01:00

node_rm.md

docs: use gh alert syntax for callouts

2024-08-16 11:02:10 +02:00

node_update.md

docs: use gh alert syntax for callouts

2024-08-16 11:02:10 +02:00

node.md

docs: generate markdown

2023-01-06 22:36:47 +01:00

pause.md

docs: regenerate stubs for non-canonical commands

2024-01-15 13:49:53 +01:00

plugin_create.md

chore: regenerate docs

2024-07-04 10:30:56 +02:00

plugin_disable.md

chore: regenerate docs

2024-07-04 10:30:56 +02:00

plugin_enable.md

docs: generate markdown

2023-01-06 22:36:47 +01:00

plugin_inspect.md

docs: update url scheme for reference docs

2024-02-20 21:38:50 +01:00

plugin_install.md

cli/command/plugin: remove DCT

2025-08-06 12:33:27 +02:00

plugin_ls.md

chore: regenerate docs

2024-07-04 10:30:56 +02:00

plugin_push.md

cli/command/plugin: remove DCT

2025-08-06 12:33:27 +02:00

plugin_rm.md

chore: regenerate docs

2024-07-04 10:30:56 +02:00

plugin_set.md

docs: use gh alert syntax for callouts

2024-08-16 11:02:10 +02:00

plugin_upgrade.md

cli/command/plugin: remove DCT

2025-08-06 12:33:27 +02:00

plugin.md

docs: generate markdown

2023-01-06 22:36:47 +01:00

port.md

docs: regenerate stubs for non-canonical commands

2024-01-15 13:49:53 +01:00

ps.md

chore: regenerate docs

2024-07-04 10:30:56 +02:00

pull.md

chore: regenerate docs

2024-07-04 10:30:56 +02:00

push.md

push: Improve note message and colors

2024-07-10 11:36:40 +02:00

rename.md

docs: regenerate stubs for non-canonical commands

2024-01-15 13:49:53 +01:00

restart.md

cli/command/container: stop, restart: rename "--time" to "--timeout"

2024-09-30 09:43:54 +02:00

rm.md

chore: regenerate docs

2024-07-04 10:30:56 +02:00

rmi.md

image rm: add --platform option

2025-05-27 10:58:11 +02:00

run.md

cli/command/container: fully deprecate --kernel-memory options

2025-09-16 15:36:45 +02:00

save.md

Update markdown docs to indicate multi-platform support in image load/save.

2025-06-10 16:42:39 -07:00

search.md

docs/reference: search: remove mention of deprecated "IsAutomated"

2025-03-31 17:45:20 +02:00

secret_create.md

docs: use gh alert syntax for callouts

2024-08-16 11:02:10 +02:00

secret_inspect.md

docs: use gh alert syntax for callouts

2024-08-16 11:02:10 +02:00

secret_ls.md

docs: use gh alert syntax for callouts

2024-08-16 11:02:10 +02:00

secret_rm.md

docs: use gh alert syntax for callouts

2024-08-16 11:02:10 +02:00

secret.md

docs: generate markdown

2023-01-06 22:36:47 +01:00

service_create.md

remove deprecated bind-nonrecursive option for --mount

2025-08-05 23:23:38 +02:00

service_inspect.md

docs: update example redis tags from 3.0.x to 7.4.x

2024-11-05 11:20:17 +01:00

service_logs.md

docs: use gh alert syntax for callouts

2024-08-16 11:02:10 +02:00

service_ls.md

docs: update example redis tags from 3.0.x to 7.4.x

2024-11-05 11:20:17 +01:00

service_ps.md

docs: update example redis tags from 3.0.x to 7.4.x

2024-11-05 11:20:17 +01:00

service_rm.md

docs: use gh alert syntax for callouts

2024-08-16 11:02:10 +02:00

service_rollback.md

docs: use gh alert syntax for callouts

2024-08-16 11:02:10 +02:00

service_scale.md

docs: update example redis tags from 3.0.x to 7.4.x

2024-11-05 11:20:17 +01:00

service_update.md

docs: use gh alert syntax for callouts

2024-08-16 11:02:10 +02:00

service.md

docs: use gh alert syntax for callouts

2024-08-16 11:02:10 +02:00

stack_config.md

chore: regenerate docs

2024-07-04 10:30:56 +02:00

stack_deploy.md

docs: use gh alert syntax for callouts

2024-08-16 11:02:10 +02:00

stack_ls.md

docs: use gh alert syntax for callouts

2024-08-16 11:02:10 +02:00

stack_ps.md

docs: use gh alert syntax for callouts

2024-08-16 11:02:10 +02:00

stack_rm.md

docs: use gh alert syntax for callouts

2024-08-16 11:02:10 +02:00

stack_services.md

docs: use gh alert syntax for callouts

2024-08-16 11:02:10 +02:00

stack.md

docs: generate markdown

2023-01-06 22:36:47 +01:00

start.md

chore: regenerate docs

2024-07-04 10:30:56 +02:00

stats.md

chore: regenerate docs

2024-07-04 10:30:56 +02:00

stop.md

cli/command/container: stop, restart: rename "--time" to "--timeout"

2024-09-30 09:43:54 +02:00

swarm_ca.md

docs: use gh alert syntax for callouts

2024-08-16 11:02:10 +02:00

swarm_init.md

Fix missing link from Configure node healthcheck heading

2025-02-19 16:56:28 +01:00

swarm_join-token.md

docs: fix missing anchors in swarm reference pages

2025-02-21 23:46:07 +01:00

swarm_join.md

docs: fix missing anchors in swarm reference pages

2025-02-21 23:46:07 +01:00

swarm_leave.md

chore: regenerate docs

2024-07-04 10:30:56 +02:00

swarm_unlock-key.md

docs: fix missing anchors in swarm reference pages

2025-02-21 23:46:07 +01:00

swarm_unlock.md

docs: use gh alert syntax for callouts

2024-08-16 11:02:10 +02:00

swarm_update.md

docs: use gh alert syntax for callouts

2024-08-16 11:02:10 +02:00

swarm.md

docs: generate markdown

2023-01-06 22:36:47 +01:00

system_df.md

docs: use gh alert syntax for callouts

2024-08-16 11:02:10 +02:00

system_dial-stdio.md

docs: generate markdown

2023-01-06 22:36:47 +01:00

system_events.md

docs: corrected the max events returned

2024-10-16 12:21:51 +02:00

system_info.md

docs: add documentation for CDI

2024-01-18 14:58:43 +01:00

system_prune.md

docs: fix output example for docker system prune

2025-08-15 12:55:03 +02:00

system.md

update cli-docs-tool to v0.6.0

2023-08-28 01:58:58 +02:00

tag.md

docs: regenerate stubs for non-canonical commands

2024-01-15 13:49:53 +01:00

top.md

docs: regenerate stubs for non-canonical commands

2024-01-15 13:49:53 +01:00

trust_inspect.md

chore: regenerate docs

2024-07-04 10:30:56 +02:00

trust_key_generate.md

docs: minor editorial improvements, typo fixes

2023-12-19 17:15:38 +01:00

trust_key_load.md

docs: minor editorial improvements, typo fixes

2023-12-19 17:15:38 +01:00

trust_key.md

docs: generate markdown

2023-01-06 22:36:47 +01:00

trust_revoke.md

chore: regenerate docs

2024-07-04 10:30:56 +02:00

trust_sign.md

chore: regenerate docs

2024-07-04 10:30:56 +02:00

trust_signer_add.md

docs: minor editorial improvements, typo fixes

2023-12-19 17:15:38 +01:00

trust_signer_remove.md

chore: regenerate docs

2024-07-04 10:30:56 +02:00

trust_signer.md

docs: generate markdown

2023-01-06 22:36:47 +01:00

trust.md

docs: generate markdown

2023-01-06 22:36:47 +01:00

unpause.md

docs: regenerate stubs for non-canonical commands

2024-01-15 13:49:53 +01:00

update.md

docs: regenerate stubs for non-canonical commands

2024-01-15 13:49:53 +01:00

version.md

chore: update link to docker engine api reference

2024-08-20 12:35:04 +02:00

volume_create.md

Correct typos in docs/ and man/

2024-06-06 02:15:23 +00:00

volume_inspect.md

docs/reference: update links to Go documentation

2023-08-25 14:10:40 +02:00

volume_ls.md

chore: regenerate docs

2024-07-04 10:30:56 +02:00

volume_prune.md

chore: regenerate docs

2024-07-04 10:30:56 +02:00

volume_rm.md

cli/command/volume: remove example and var for long description

2025-02-03 12:21:00 +01:00

volume_update.md

docs: generate markdown

2023-01-06 22:36:47 +01:00

volume.md

Update docs/command output for volume pruning

2023-08-12 14:22:23 +01:00

wait.md

docs: regenerate stubs for non-canonical commands

2024-01-15 13:49:53 +01:00