moby: docker ps -h: --no-trunc incorrectly documented

Surely it should read “–no-trunc=true: Don’t truncate output” or “–no-trunc=false: Truncate output (default behaviour)”.

Similar for “–quiet=false”. I presume it was intended to show the alternatives (either “-q” or “–quiet=false”), however the textual description is misleading.

I think a better format would be “-q, --quiet=<true|false>: whether to only display numeric IDs”, or something along those lines.

anni@helium:~/src/Redis$ docker ps -h

Usage: docker ps [OPTIONS]

List containers

  -a, --all=false: Show all containers. Only running containers are shown by default.
  --before="": Show only container created before Id or Name, include non-running ones.
  -l, --latest=false: Show only the latest created container, include non-running ones.
  -n=-1: Show n last created containers, include non-running ones.
  --no-trunc=false: Don't truncate output
  -q, --quiet=false: Only display numeric IDs
  -s, --size=false: Display sizes
  --since="": Show only containers created since Id or Name, include non-running ones.
anni@helium:~/src/Redis$
anni@helium:~/src/Redis$ docker version
Client version: 0.10.0
Client API version: 1.10
Go version (client): go1.2.1
Git commit (client): dc9c28f
Server version: 0.10.0
Server API version: 1.10
Git commit (server): dc9c28f
Go version (server): go1.2.1
Last stable version: 0.10.0
anni@helium:~/src/Redis$

About this issue

  • Original URL
  • State: closed
  • Created 10 years ago
  • Comments: 16 (15 by maintainers)

Most upvoted comments

I don’t think it’s correct to call --no-trunc a double negative. It only appears this way due to the documentation; it would not be problematic if #9406 was implemented.

I would avoid default true flags at all costs. In my opinion they are extremely confusing, see #10517.