Add comment to specify timeout unit in ConditionVariableTimedSleep()

Started by shveta malikabout 2 years ago4 messageshackers
Jump to latest
#1shveta malik
shveta.malik@gmail.com

Hi hackers,

ConditionVariableTimedSleep() accepts a timeout parameter, but it
doesn't explicitly state the unit for the timeout anywhere. To
determine this, one needs to look into the details of the function to
find it out from the comments of the internally called function
WaitLatch(). It would be beneficial to include a comment in the header
of ConditionVariableTimedSleep() specifying that the timeout is in
milliseconds, similar to what we have for other non-static functions
like WaitLatch and WaitEventSetWait. Attached the patch for the same.

thanks
Shveta

Attachments:

v1-0001-Specify-timeout-unit-in-ConditionVariableTimedSle.patchapplication/octet-stream; name=v1-0001-Specify-timeout-unit-in-ConditionVariableTimedSle.patchDownload+2-1
#2Michael Paquier
michael@paquier.xyz
In reply to: shveta malik (#1)
Re: Add comment to specify timeout unit in ConditionVariableTimedSleep()

On Tue, Mar 05, 2024 at 09:39:11AM +0530, shveta malik wrote:

ConditionVariableTimedSleep() accepts a timeout parameter, but it
doesn't explicitly state the unit for the timeout anywhere. To
determine this, one needs to look into the details of the function to
find it out from the comments of the internally called function
WaitLatch(). It would be beneficial to include a comment in the header
of ConditionVariableTimedSleep() specifying that the timeout is in
milliseconds, similar to what we have for other non-static functions
like WaitLatch and WaitEventSetWait. Attached the patch for the same.

That sounds like a good idea to me, so I'm OK with your suggestion.
--
Michael

#3Michael Paquier
michael@paquier.xyz
In reply to: Michael Paquier (#2)
Re: Add comment to specify timeout unit in ConditionVariableTimedSleep()

On Tue, Mar 05, 2024 at 03:20:48PM +0900, Michael Paquier wrote:

That sounds like a good idea to me, so I'm OK with your suggestion.

Applied this one as f160bf06f72a. Thanks.
--
Michael

#4shveta malik
shveta.malik@gmail.com
In reply to: Michael Paquier (#3)
Re: Add comment to specify timeout unit in ConditionVariableTimedSleep()

On Sat, Mar 9, 2024 at 12:19 PM Michael Paquier <michael@paquier.xyz> wrote:

On Tue, Mar 05, 2024 at 03:20:48PM +0900, Michael Paquier wrote:

That sounds like a good idea to me, so I'm OK with your suggestion.

Applied this one as f160bf06f72a. Thanks.

Thanks!

thanks
Shveta