From 791c62a3bad988d977a177cac7f76a1adedb0ba5 Mon Sep 17 00:00:00 2001
From: Robert Paul <robert20paul@gmail.com>
Date: Tue, 8 Aug 2017 14:02:29 -0500
Subject: [PATCH] Adds clarification comments

---
 lib/ex.coffee | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/lib/ex.coffee b/lib/ex.coffee
index 46ab42b..c84fbbf 100644
--- a/lib/ex.coffee
+++ b/lib/ex.coffee
@@ -440,16 +440,20 @@ class Ex
   sort: ({ range }) =>
     editor = atom.workspace.getActiveTextEditor()
     sortingRange = [[]]
+
+    # If no range is provided, the entire file should be sorted.
     isMultiLine = range[1] - range[0] > 1
     if isMultiLine
       sortingRange = [[range[0], 0], [range[1] + 1, 0]]
     else
       sortingRange = [[0, 0], [editor.getLastBufferRow(), 0]]
 
+    # Store every bufferedRow string in an array.
     textLines = []
     for lineIndex in [sortingRange[0][0]..sortingRange[1][0] - 1]
       textLines.push(editor.lineTextForBufferRow(lineIndex))
 
+    # Sort the array and join them together with newlines for writing back to the file.
     sortedText = _.sortBy(textLines).join('\n') + '\n'
     editor.buffer.setTextInRange(sortingRange, sortedText)