Enforce consistent args rejection for no-args commands: ls, restart, version

[piroux]

What I did
Make cobra to reject arguments for no-args commands in the same manner:

• ls
• version
• (down was done already)

For the restart command, the documentation is updated to let the user know that services can be passed as arguments.

Related issue

Based on #9158 which enforced it for the down command.

---

According to the listing below, these 4 commands were the only ones to not handle arguments.

➜ for c in (docker compose --help | awk '/^  [a-z]+ +.*/ {print $1}');
      docker compose $c --help | grep 'Usage:';
  end | cat
Usage:  docker compose build [SERVICE...]
Usage:  docker compose convert SERVICES
Usage:  docker compose cp [OPTIONS] SERVICE:SRC_PATH DEST_PATH|-
Usage:  docker compose create [SERVICE...]
Usage:  docker compose down
Usage:  docker compose events [options] [--] [SERVICE...]
Usage:  docker compose exec [options] [-e KEY=VAL...] [--] SERVICE COMMAND [ARGS...]
Usage:  docker compose images [SERVICE...]
Usage:  docker compose kill [options] [SERVICE...]
Usage:  docker compose logs [SERVICE...]
Usage:  docker compose ls
Usage:  docker compose pause [SERVICE...]
Usage:  docker compose port [options] [--] SERVICE PRIVATE_PORT
Usage:  docker compose ps [SERVICE...]
Usage:  docker compose pull [SERVICE...]
Usage:  docker compose push [SERVICE...]
Usage:  docker compose restart
Usage:  docker compose rm [SERVICE...]
Usage:  docker compose run [options] [-v VOLUME...] [-p PORT...] [-e KEY=VAL...] [-l KEY=VALUE...] SERVICE [COMMAND] [ARGS...]
Usage:  docker compose start [SERVICE...]
Usage:  docker compose stop [SERVICE...]
Usage:  docker compose top [SERVICES...]
Usage:  docker compose unpause [SERVICE...]
Usage:  docker compose up [SERVICE...]
Usage:  docker compose version

[ulyssessouza]

LGTM

[glours]

I let you choose what you want to do:

• Update the restart documentation in your PR
• Remove your changes for the restart command

[glours]

Ok I think we should update the documentation of the restart command to show the optional service name arg!
Restart allows you to choose a specific service to restart so you can pass an argument like that:

docker compose restart my-service

[laurazard]

We shouldn't change this, right? It implies losing the ability to just restart a specific service, which people might be relying on. I'd prefer to keep the current compose restart behaviour unless there is a reason for changing it.

[glours]

We'll keep the actual behavior for sure, that's why I proposed to update the doc or remove the modification for the restart command

[piroux]

Sorry, I had overlooked that restart could be used like that too.

So yes, let's update the docs.

[glours]

You need to resolve your conflict in order to start the CI process

[glours]

Doing modification in the documentation isn't trivial 😅
You should modify the command itself in the restart.go file and then use make docs to generate the yaml and md doc files.

[glours]

LGTM