docs(report): enhance man pages for cargo report *

[weihanglo]

What does this PR try to resolve?

Make space for future report kinds iun cargo report documentations.

• A new sub-section of "report commands" in the Cargo book.
• Fixed that cargo report man page didn't match its --help text equivalent
• ‼️ Make report future-incompat the primary name instead of an alias.
• cargo report future-incompat didn't have its own man page.

Note that cargo help hasn't yet supported for future-incompat.
It will be a separate PR.

How to test and review this PR?

mdbook serve src/doc
target/debug/cargo help report

[rustbot]

r? @epage

rustbot has assigned @epage.
They will have a look at your PR within the next two weeks and either review your PR or reassign to another reviewer.

Use r? to explicitly pick a reviewer

[epage]

How are sub-sub command man pages normally named and handled?

Do we need to update --help to call this out?

[weihanglo]

docker-container-run

DOCKER(1)                         Docker User Manuals                         DOCKER(1)

NAME
       docker-container-run - Create and run a new container from an image

SYNOPSIS
       docker container run [OPTIONS] IMAGE [COMMAND] [ARG...]

DESCRIPTION
       Alias for docker run.

OPTIONS
       --add-host=      Add a custom host-to-IP mapping (host:ip)

       --annotation=map[]       Add  an  annotation to the container (passed through to
       the OCI runtime)

       -a, --attach=      Attach to STDIN, STDOUT or STDERR

podman-machine-start

https://docs.podman.io/en/latest/markdown/podman-machine-start.1.html

[weihanglo]

Do we need to update --help to call this out?

Yes, but cargo help hasn't yet supported it, and I am not sure whether cargo help report-timings makes more sense or cargo help report timings (mind the dash).