`cargo test --name` not working

This command fails to produce any output:

cargo test --name <test_name>

However, this command runs the given test

cargo test <test_name>

[alexcrichton]

Currently --name is the name of a target, not a test itself. Do you have a test executable named <test_name> for cargo to run?

This is probably a documentation error then. When I wanted to run a specific test, I ran cargo help test giving

    --name NAME              Name of the test to run

So I expected cargo test --name to run a test with NAME. However, cargo test <test_name> did what I wanted, but it doesn't appear to be documented.

[alexcrichton]

Ah yes indeed! I'll try to clarify the docs. I'll point out though the bit at the end:

All of the trailing arguments are passed to the test binaries generated for
filtering tests and generally providing options configuring how they run.