Docs for Cargo Test mislieadingly imply that examples can be built and run as tests

[Farmadupe]

Problem

(Possible alternative title: Cargo Test does not run examples as tests when commanded)

(Relevant confusion in reddit thread here)

When read literally, line 140 of Cargo Test docs states that Cargo can reinterpret the main function of an example binary as a test, and execute it.

Since cargo does not appear to do this, a wording that does not have the misleading reading might be appropriate here.

Steps

No response

Possible Solution(s)

No response

Notes

No response

Version

No response

[epage]

Not having tried this, I'm assuming what is implicit here is that the default test harness is used, like any other test executable. This means it will discover and run #[test] functions. You'd have to disable the default test harness to do your own thing.