fix comments

Author: timotheecour

changelog.md

@@ -55,7 +55,7 @@
 
 - Added `os.isRelativeTo` to tell whether a path is relative to another
 
-- Added `sugar.byAddr` allowing a ref syntax for lvalue expressions
+- Added `sugar.byAddr` allowing a reference syntax for lvalue expressions, analog to C++ `auto& a = expr`.
 
 ## Library changes
 

lib/pure/sugar.nim

@@ -384,9 +384,9 @@ proc splitDefinition*(def: NimNode): tuple[lhs: NimNode, rhs: NimNode, exported:
   expectKind(result.lhs, nnkIdent)
 
 macro byAddr*(def: untyped): untyped {.since: (1,1).} =
-  ## Defines a ref alias for lvalue expressions. The expression is evaluated
-  ## only once, and any side effects will only be evaluated once, at declaration
-  ## time.
+  ## Defines a reference syntax for lvalue expressions, analog to C++ `auto& a = expr`.
+  ## The expression is evaluated only once, and any side effects will only be
+  ## evaluated once, at declaration time.
   runnableExamples:
     var x = @[1,2,3]
     byAddr: x1=x[1]