summary refs log tree commit diff stats
path: root/lib/std
diff options
context:
space:
mode:
Diffstat (limited to 'lib/std')
-rw-r--r--lib/std/wordwrap.nim4
1 files changed, 4 insertions, 0 deletions
diff --git a/lib/std/wordwrap.nim b/lib/std/wordwrap.nim
index ff33a2ba9..3e3a4609c 100644
--- a/lib/std/wordwrap.nim
+++ b/lib/std/wordwrap.nim
@@ -3,6 +3,10 @@ import unicode
 proc wordWrap*(s: string, maxLineWidth = 80,
                splitLongWords = true,
                newLine = "\n"): string  =
+  ## This function breaks all words that reach over `maxLineWidth`
+  ## measured in number of runes. When `splitLongWords` is `true`
+  ## words that are longer than `maxLineWidth` are splitted. Multiple spaces and newlines are converted to a single space. All
+  ## whitespace is treated equally. Non-breaking whitespace is ignored.
 
   var currentWordLength: int = 0
   var currentWord: string = newStringOfCap(32)