Add warning to specify timeout value in milliseconds, Fix #21449 (#21471)

a warning message been added to the documentation to remind users that the timeout parameter is expressed in milliseconds, not seconds. to help prevent confusion and unexpected behaviours.
This commit is contained in:
Sultan Al Isaiee
2023-03-04 18:53:57 +04:00
committed by GitHub
parent d950e5f3a8
commit 04a494f8cf

View File

@@ -220,6 +220,10 @@ proc waitForExit*(p: Process, timeout: int = -1): int {.rtl,
##
## On posix, if the process has exited because of a signal, 128 + signal
## number will be returned.
##
## .. warning:: When working with `timeout` parameters, remember that the value is
## typically expressed in milliseconds, and ensure that the correct unit of time
## is used to avoid unexpected behavior.
proc peekExitCode*(p: Process): int {.rtl, extern: "nosp$1", raises: [OSError], tags: [].}
## Return `-1` if the process is still running. Otherwise the process' exit code.