Small doc improvements for `std/with` (#17556)

1 files changed, 4 insertions, 3 deletions

diff --git a/lib/std/with.nim b/lib/std/with.nim
index 79afd61a4..c7338b4e4 100644
--- a/lib/std/with.nim
+++ b/lib/std/with.nim
@@ -12,15 +12,16 @@
 ## and https://github.com/nim-lang/RFCs/issues/192 for details leading to this
 ## particular design.
 ##
-## **Since** version 1.2.
+## **Since:** version 1.2.
 
 import macros, private / underscored_calls
 
 macro with*(arg: typed; calls: varargs[untyped]): untyped =
-  ## This macro provides the `chaining`:idx: of function calls.
+  ## This macro provides `chaining`:idx: of function calls.
   ## It does so by patching every call in `calls` to
   ## use `arg` as the first argument.
-  ## **This evaluates `arg` multiple times!**
+  ##
+  ## .. caution:: This evaluates `arg` multiple times!
   runnableExamples:
     var x = "yay"
     with x: