From 4c6382a334feeeef601aeed4dd8ff8cb672d1678 Mon Sep 17 00:00:00 2001
From: Vindaar <basti90@gmail.com>
Date: Mon, 24 Sep 2018 11:21:45 +0200
Subject: [PATCH] fix `posix.onSignal` example, inject current signal as `s`

---
 lib/posix/posix.nim | 16 +++++++++++-----
 1 file changed, 11 insertions(+), 5 deletions(-)

diff --git a/lib/posix/posix.nim b/lib/posix/posix.nim
index c230e65985..b63a00e11f 100644
--- a/lib/posix/posix.nim
+++ b/lib/posix/posix.nim
@@ -985,12 +985,18 @@ proc utimes*(path: cstring, times: ptr array[2, Timeval]): int {.
 proc handle_signal(sig: cint, handler: proc (a: cint) {.noconv.}) {.importc: "signal", header: "<signal.h>".}
 
 template onSignal*(signals: varargs[cint], body: untyped) =
-  ## Setup code to be executed when Unix signals are received. Example:
-  ## from posix import SIGINT, SIGTERM
-  ## onSignal(SIGINT, SIGTERM):
-  ##   echo "bye"
+  ## Setup code to be executed when Unix signals are received. The
+  ## currently handled signal is injected as ``s`` into the calling
+  ## scope.
+  ##
+  ## Example:
+  ##
+  ## .. code-block::
+  ##   from posix import SIGINT, SIGTERM
+  ##   onSignal(SIGINT, SIGTERM):
+  ##     echo "bye from signal ", s
 
-  for s in signals:
+  for s {.inject.} in signals:
     handle_signal(s,
       proc (sig: cint) {.noconv.} =
         body