shell: document layer variable shell-default-term-shell

layers/+tools/shell/README.org

@@ -9,12 +9,13 @@
    - [[#default-shell][Default shell]]
    - [[#default-shell-position-and-height][Default shell position and height]]
    - [[#set-shell-for-term-and-ansi-term][Set shell for term and ansi-term]]
+   - [[#width-of-the-shell-popup-buffers][Width of the shell popup buffers]]
    - [[#enable-em-smart-in-eshell][Enable em-smart in Eshell]]
    - [[#protect-your-eshell-prompt][Protect your Eshell prompt]]
  - [[#eshell][Eshell]]
  - [[#key-bindings][Key bindings]]
    - [[#multi-term][Multi-term]]
-   - [[#eshell][Eshell]]
+   - [[#eshell-1][Eshell]]
 
 * Description
 This layer configures the various shells available in Emacs.
@@ -71,6 +72,16 @@ Default value is =/bin/bash=.
     '(shell :variables shell-default-term-shell "/bin/bash"))
 #+END_SRC
 
+** Width of the shell popup buffers
+By default the popup buffer spans the full width of the current frame, if
+you prefer to spans only the width of the current window then set the
+layer variable =shell-default-full-span= to nil.
+
+#+BEGIN_SRC emacs-lisp
+  (setq-default dotspacemacs-configuration-layers
+    '(shell :variables shell-default-full-span nil))
+#+END_SRC
+
 ** Enable em-smart in Eshell
 From the =em-smart= documentation:
 

layers/+tools/shell/config.el

@@ -46,5 +46,5 @@ commands, modify old commands or enter a new one.")
 movement to the prompt is inhibited like for `comint-mode'
 prompts and the prompt is made read-only")
 
-(defcustom shell-default-full-span t
-  "If non-nil, the `shell' spans full width of a window")
+(defvar shell-default-full-span t
+  "If non-nil, the `shell' buffer spans full width of a frame.")