is this correct samples with seconds behavior? - better document effect of tuning

function dosomething()
    sleep(1)
end

julia> @time @btime dosomething() samples=3 seconds=20
  1.002 s (7 allocations: 160 bytes)  # this is from btime
 26.740450 seconds (312.46 k allocations: 15.984 MiB, 1.59% gc time)  # this is from time

The documentation seems to imply that seconds is an upper bound on benchmarking, which leads me to believe that the proper behavior is to exit after n samples or m seconds, whichever comes first.

Am I misunderstanding how this works?

Start by reproducing the documented @time @btime dosomething() samples=3 seconds=20 example and read the documentation describing samples and seconds. Confirm how the two timing macros apply those options, then update the documentation so the stopping behavior and the distinction between the displayed timings are unambiguous.