Minor documentation fix for race and try_race

[abhishekc-sharma]

race was being referred to as a macro. Additionally is the comment

Note that this function consumes all futures passed, and once a future is
completed, all other futures are dropped.

required for a function since this fact is more clear from the signature of the function than for macros ?

[ghost]

Thanks!