osx layer: add documentation for coreutils' gls

contrib/osx/README.md

@@ -9,6 +9,8 @@
     - [Description](#description)
     - [Philosophy](#philosophy)
     - [Install](#install)
+        - [Layer](#layer)
+        - [Coreutils](#coreutils)
     - [Key Bindings](#key-bindings)
     - [Future Work](#future-work)
 
@@ -21,6 +23,8 @@ This layer globally defines common OSX keybindings. ⌘ is set to
 `super` and ⌥ is set to `meta`. Aside from that, there's nothing
 much, really.
 
+While in `dired` this layer will try to use `gls` instead of `ls`.
+
 ## Philosophy
 
 While this layer enables common OSX bindings, it does not implement
@@ -29,6 +33,8 @@ and we encourage you to do so :)
 
 ## Install
 
+### Layer
+
 To use this configuration layer, add it to your `~/.spacemacs`
 
 ```elisp
@@ -37,6 +43,14 @@ To use this configuration layer, add it to your `~/.spacemacs`
 )
 ```
 
+### Coreutils
+
+To get `gls` install coreutils homebrew:
+
+```sh
+brew install coreutils
+```
+
 ## Key Bindings
 
     Key Binding   |       Description

contrib/osx/packages.el

@@ -4,8 +4,9 @@
     ))
 
 (if (executable-find "gls")
-    ; maybe absolute or relative name of the `ls' program used by `insert-directory'.
-    ; brew info coreutils
+    ;; maybe absolute or relative name of the `ls' program used by
+    ;; `insert-directory'.
+    ;; brew info coreutils
     (setq insert-directory-program "gls"
           dired-listing-switches "-aBhl --group-directories-first")
   (setq dired-use-ls-dired nil))