Certainly, it should be:
<pre>
@param [in, out] v  Velocity
</pre>
which should be fine.

Also the units are missed. They must be:
[m/s]
[m/s]
[s]