summary refs log tree commit diff stats
path: root/lib/std/decls.nim
diff options
context:
space:
mode:
Diffstat (limited to 'lib/std/decls.nim')
-rw-r--r--lib/std/decls.nim13
1 files changed, 6 insertions, 7 deletions
diff --git a/lib/std/decls.nim b/lib/std/decls.nim
index 7b907f5e1..bb7ec3593 100644
--- a/lib/std/decls.nim
+++ b/lib/std/decls.nim
@@ -1,16 +1,15 @@
-# see `semLowerLetVarCustomPragma` for compiler support that enables these
-# lowerings
+## This module implements syntax sugar for some declarations.
 
-import macros
+import std/macros
 
 macro byaddr*(sect) =
   ## Allows a syntax for l-value references, being an exact analog to
   ## `auto& a = ex;` in C++.
   ## 
-  ## Warning: This makes use of 2 experimental features, namely nullary
-  ## templates instantiated as symbols and variable macro pragmas.
-  ## For this reason, its behavior is not stable. The current implementation
-  ## allows redefinition, but this is not an intended consequence.
+  ## .. warning:: This makes use of 2 experimental features, namely nullary
+  ##   templates instantiated as symbols and variable macro pragmas.
+  ##   For this reason, its behavior is not stable. The current implementation
+  ##   allows redefinition, but this is not an intended consequence.
   runnableExamples:
     var s = @[10, 11, 12]
     var a {.byaddr.} = s[0]