xTimerStart vs. xTimerReset documentation

asund wrote on Tuesday, February 20, 2018:

In the documentation for the timer functions:

xTimerStart

If the timer had already been started and was already in the active state, then xTimerStart() has equivalent functionality to the xTimerReset() API function.

xTimerReset

If the timer had already been started and was already in the active state, then xTimerReset() will cause the timer to re-evaluate its expiry time so that it is relative to when xTimerReset() was called. If the timer was in the dormant state then xTimerReset() has equivalent functionality to the xTimerStart() API function.

As far as I can tell the only difference in these commands is the value passed to traceTIMER_COMMAND_RECEIVED, which could be useful for some users to make the distinction. I feel like changing the documentation to say this up front instead of conditionally referring to each other for behaviour would be clearer.

rtel wrote on Wednesday, February 21, 2018:

Duplicate of https://sourceforge.net/p/freertos/discussion/382005/thread/6f987ded/