From 30737ea34b95b10cd9add766a4397b7e3934efb4 Mon Sep 17 00:00:00 2001
From: apense <apense@users.noreply.github.com>
Date: Mon, 6 Jul 2015 15:47:23 -0400
Subject: [PATCH] Added safeAdd documentation

---
 lib/system.nim | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/lib/system.nim b/lib/system.nim
index 2677e4990..4ea880b4b 100644
--- a/lib/system.nim
+++ b/lib/system.nim
@@ -3286,14 +3286,19 @@ when declared(initDebugger):
 when hasAlloc:
   # XXX: make these the default (or implement the NilObject optimization)
   proc safeAdd*[T](x: var seq[T], y: T) {.noSideEffect.} =
+    ## Add `y` to `x` unless `x` is not yet initialized; in that case, `x`
+    ## becomes `@[y]`
     if x == nil: x = @[y]
     else: x.add(y)
 
   proc safeAdd*(x: var string, y: char) =
+    ## Add `y` to `x`. If `x` is `nil` it is initialized to `""`
     if x == nil: x = ""
     x.add(y)
 
   proc safeAdd*(x: var string, y: string) =
+    ## Add `y` to `x` unless `x` is not yet initalized; in that case, `x`
+    ## becomes `y`
     if x == nil: x = y
     else: x.add(y)