--extensions= variables. =pre= extensions are loaded
-before the packages and =post= extensions are loaded after. The name of the
-extension is the name of the folder it is in. Using the above example structure,
-the extensions would be activated like so:
+in its own folder inside the =extensions= folder. Extensions can be declared
+using the =--extensions= variables. =pre= extensions are
+loaded before the packages and =post= extensions are loaded after. The name of
+the extension is the name of the folder it is in. Using the above example
+structure, the extensions would be activated like so:
#+begin_src emacs-lisp
(setq layer-name-pre-extensions '())
@@ -364,13 +363,14 @@ pattern as packages.
Make sure you [[*Activating%20a%20Layer][add]] your layer to your =.dotspacemacs= file and restart to
activate it.
+
** Installing a single package
Sometimes creating a layer is a bit overkill. Maybe you just want one package
and don't want to maintain a whole layer. Spacemacs provides a variable in the
-=dotspacemacs/init= function in =.spacemacs= called
+=dotspacemacs/layers= function in =.spacemacs= called
=dotspacemacs-additional-packages=. Just add a package name to the list and it
will be installed when you restart. Loading the package is covered in the next
-[[*Loading%20packages][section.]]
+[[#loading-packages][section]].
** Loading packages
Ever wonder how Spacemacs can load over a 100 packages in just a few seconds?
@@ -384,7 +384,6 @@ to using it:
;; try to lazy load the package.
(use-package package-name
:defer t)
-
;; The :init section is run before the package loads The :config section is
;; run after the package loads
(use-package package-name
@@ -394,7 +393,8 @@ to using it:
;; Change some variables
(setq variable1 t variable2 nil)
;; Define a function
- (defun foo () (message "%s" "Hello, World!")))
+ (defun foo ()
+ (message "%s" "Hello, World!")))
:config
(progn
;; Calling a function that is defined when the package loads
@@ -403,19 +403,20 @@ to using it:
This is just a very basic overview of =use-package=. There are many other ways
to control how a package loads using it that aren't covered here.
+
** Uninstalling a package
Spacemacs provides a variable in the =dotspacemacs/init= function in
-=.spacemacs= called =dotspacemacs-excluded-packages=. Just add a package name
-to the list and it will be uninstalled when you restart.
+=.spacemacs= called =dotspacemacs-excluded-packages=. Just add a package name to
+the list and it will be uninstalled when you restart.
** Common tweaks
This section is for things many will want to change. All of these settings go in
the =dotspacemacs/config= function in your =.spacemacs= unless otherwise noted.
*** Changing the escape key
-Spacemacs uses =[[https://github.com/syl20bnr/evil-escape][evil-escape]]= to allow escaping from many =major-modes= with one
-keybinding. You can customize the variable in your =dotspacemacs/init= like
-this:
+Spacemacs uses =[[https://github.com/syl20bnr/evil-escape][evil-escape]]= to
+allow escaping from many =major-modes= with one keybinding. You can customize
+the variable in your =dotspacemacs/init= like this:
#+begin_src emacs-lisp
(defun dotspacemacs/init ()
@@ -425,13 +426,13 @@ this:
#+end_src
This is one of the few variables that must be set in =dotspacemacs/init=. More
-documentation is found in the =evil-escape= README.
+documentation is found in the =evil-escape= [[https://github.com/syl20bnr/evil-escape/blob/master/README.md][README]].
*** Changing the colorscheme
The =.spacemacs= file contains the =dotspacemacs-themes= variable in the
=dotspacemacs/init= function. This is a list of themes that can be cycled
-through with the ~SPC T n~ keybinding. The first
-theme in the list is the one that is loaded at startup. Here is an example:
+through with the ~SPC T n~ keybinding. The first theme in the list is the one
+that is loaded at startup. Here is an example:
#+begin_src emacs-lisp
(defun dotspacemacs/init
@@ -449,36 +450,36 @@ All installed themes can be listed and chosen using the ~SPC T h~ keybinding.
*** Nohlsearch
Spacemacs emulates the default vim behavior which highlights search results even
-when you are not navigating between them. You can use ~SPC s c~ or ~:nohlsearch~ to
-disable search result highlighting.
+when you are not navigating between them. You can use ~SPC s c~ or ~:nohlsearch~
+to disable search result highlighting.
To disable the result highlighting when it is not needed anymore automatically,
-you can [[*Uninstalling%20a%20package][uninstall]] the =evil-search-highlight-persist= package.
+you can [[#uninstalling-a-package][uninstall]] the =evil-search-highlight-persist= package.
*** Sessions
Spacemacs does not automatically restore your windows and buffers when you
reopen it. If you use vim sessions regularly you may want to add
=(desktop-save-mode t)= to you =dotspacemacs/config= in your =.spacemacs= to get
-this functionality. You will then be able to load the saved session using
-~SPC : desktop-read~. The location of the desktop
-file can be set with the variable =desktop-dirname=. To automatically load a
-session, add =(desktop-read)= to your =.spacemacs=.
+this functionality. You will then be able to load the saved session using ~SPC :
+desktop-read~. The location of the desktop file can be set with the variable
+=desktop-dirname=. To automatically load a session, add =(desktop-read)= to your
+=.spacemacs=.
*** Navigating using visual lines
Spacemacs uses the vim default of navigating by actual lines, even if they are
-wrapped. If you want ~j~ and ~k~ to behave like ~g j~ and ~g k~, add this to your
-=.spacemacs=:
+wrapped. If you want ~j~ and ~k~ to behave like ~g j~ and ~g k~, add this to
+your =.spacemacs=:
#+begin_src emacs-lisp
-(define-key evil-normal-state-map (kbd "j") 'evil-next-visual-line)
-(define-key evil-normal-state-map (kbd "k") 'evil-previous-visual-line)
+ (define-key evil-normal-state-map (kbd "j") 'evil-next-visual-line)
+ (define-key evil-normal-state-map (kbd "k") 'evil-previous-visual-line)
#+end_src
* Other useful links
- [[https://www.gnu.org/software/emacs/manual/emacs.html][Emacs Manual]]
-- [[file:DOCUMENTATION.md][Spacemacs Documentation]]
+- [[file:DOCUMENTATION.org][Spacemacs Documentation]]
- [[http://ian.mccowan.space/2015/04/07/Spacemacs/][Spacemacs: A Vimmer's Emacs Prerequisites]]
- - Note: The article refers to ~SPC b s~
- as the keybinding to switch buffers. It is ~SPC b b~
+ - Note: The article refers to ~SPC b s~ as the keybinding to switch buffers.
+ It is ~SPC b b~
- [[http://thume.ca/howto/2015/03/07/configuring-spacemacs-a-tutorial/][Configuring Spacemacs: A Tutorial]]
- [[http://juanjoalvarez.net/es/detail/2014/sep/19/vim-emacsevil-chaotic-migration-guide/][From Vim to Emacs+Evil chaotic migration guide]]
diff --git a/doc/img/guide-key.png b/doc/img/guide-key.png
new file mode 100644
index 000000000000..85d78a4632ac
Binary files /dev/null and b/doc/img/guide-key.png differ
diff --git a/doc/img/spacemacs-scale-micro-state.png b/doc/img/spacemacs-scale-micro-state.png
index 90e670903227..1b2726ad00a9 100644
Binary files a/doc/img/spacemacs-scale-micro-state.png and b/doc/img/spacemacs-scale-micro-state.png differ
diff --git a/init.el b/init.el
index 75735cf4218c..321ea98b9c3a 100644
--- a/init.el
+++ b/init.el
@@ -13,7 +13,7 @@
;; Without this comment emacs25 adds (package-initialize) here
;; (package-initialize)
-(defconst spacemacs-version "0.103.0" "Spacemacs version.")
+(defconst spacemacs-version "0.103.5" "Spacemacs version.")
(defconst spacemacs-emacs-min-version "24.3" "Minimal version of Emacs.")
(defun spacemacs/emacs-version-ok ()
diff --git a/private/README.md b/private/README.md
index 385cef701e3f..c755c1e50c8b 100644
--- a/private/README.md
+++ b/private/README.md
@@ -18,4 +18,4 @@ Each created file has further guidance written in them.
Once the configuration is done, restart Emacs to load, install and configure
your layer.
-[conf_layers]: https://github.com/syl20bnr/spacemacs/blob/master/doc/DOCUMENTATION.md#extensions-and-packages
+[conf_layers]: https://github.com/syl20bnr/spacemacs/blob/master/doc/DOCUMENTATION.org#extensions-and-packages