diff --git a/doc/FAQ.org b/doc/FAQ.org index 0d3641db9..aac1c81ee 100644 --- a/doc/FAQ.org +++ b/doc/FAQ.org @@ -6,6 +6,8 @@ - [[#what-is-the-official-pronunciation-of-spacemacs][What is the official pronunciation of Spacemacs?]] - [[#why-are-packages-installed-with-package-install-automatically-deleted-by-spacemacs-when-it-boots][Why are packages installed with =package-install= automatically deleted by Spacemacs when it boots?]] - [[#how-to-fix-package-download-errors-when-installing-spacemacs-][How to fix package download errors when installing Spacemacs ?]] + - [[#how-to-fix-symbols-value-as-variable-is-void-errors-on-startup][How to fix =Symbol's value as variable is void= errors on startup?]] + - [[#how-to-fix-wrong-type-argument-arrayp-nil-errors-on-startup][How to fix =(wrong-type-argument arrayp nil)= errors on startup?]] - [[#the-spacemacs-banner-is-ugly-what-should-i-do][The Spacemacs banner is ugly, what should I do?]] - [[#the-powerline-separators-are-ugly-how-can-i-fix-them][The powerline separators are ugly, how can I fix them?]] - [[#the-powerline-separators-have-no-anti-aliasing-what-can-i-do][The powerline separators have no anti-aliasing, what can I do?]] @@ -16,8 +18,6 @@ - [[#why-is-spacemacs-hanging-on-startup][Why is Spacemacs hanging on startup?]] - [[#why-does-helm-m-x-spc-spc-not-accept-the-prefix-argument][Why does =helm-M-x= (~SPC SPC~) not accept the prefix argument?]] - [[#why-does-my-color-theme-not-render-correctly-in-terminal-mode][Why does my color theme not render correctly in terminal mode?]] - - [[#why-do-i-get-wrong-type-argument-arrayp-nil-errors-on-startup][Why do I get =(wrong-type-argument arrayp nil)= errors on startup?]] - - [[#why-do-i-get-symbols-value-as-variable-is-void-errors-on-startup][Why do I get "Symbol's value as variable is void" errors on startup?]] - [[#typing-quickly-fd-takes-me-out-of-insert-state-what-is-going-on][Typing quickly =fd= takes me out of =insert state=. What is going on?]] - [[#why-do-i-get-files-starting-with-][Why do I get files starting with .#?]] - [[#how-do-i][How do I...]] @@ -67,6 +67,22 @@ Emacs with the =--insecure= argument for force the usage of HTTP non secured protocol. You can set the variable =dotspacemacs-elpa-https= to =nil= in your dotfile to remove the need to start Emacs with =--insecure== argument. +** How to fix =Symbol's value as variable is void= errors on startup? +If Emacs reports an error that the symbol =closed= or =-= is unbound as a +variable, it is probably because you are using HTTPS to download packages, but +you shouldn't be. Try deleting your packages (the =.emacs.d/elpa= folder), and +restart Emacs without HTTPS to download the packages again. There are two ways +to do this: + +- Run Emacs with the =--insecure= command line argument: =emacs --insecure=. You + will have to do this again the next time you update your packages. +- Set the variable =dotspacemacs-elpa-https= to =nil= in your dotfile. This has + the same effect as =--insecure=, but is persistent. + +** How to fix =(wrong-type-argument arrayp nil)= errors on startup? +This is most likely caused by a corrupted package archive. Try deleting your +=~/.emacs.d/elpa/archives/= folder and restart Emacs. + ** The Spacemacs banner is ugly, what should I do? Install the default font supported by Spacemacs or choose a fixed width font. More information in the font section of the [[file:DOCUMENTATION.org][documentation]]. @@ -162,22 +178,6 @@ colors are rendered by the terminal and not by emacs. You will probably have to change your terminal color palette. More explanations can be found on [[https://github.com/sellout/emacs-color-theme-solarized#important-note-for-terminal-users][emacs-color-theme-solarized webpage]]. -** Why do I get =(wrong-type-argument arrayp nil)= errors on startup? -This is most likely caused by a corrupted package archive. Try deleting your -=~/.emacs.d/elpa/archives/= folder and restart Emacs. - -** Why do I get "Symbol's value as variable is void" errors on startup? -If Emacs reports an error that the symbol =closed= or =-= is unbound as a -variable, it is probably because you are using HTTPS to download packages, but -you shouldn't be. Try deleting your packages (the =.emacs.d/elpa= folder), and -restart Emacs without HTTPS to download the packages again. There are two ways -to do this: - -- Run Emacs with the =--insecure= command line argument: =emacs --insecure=. You - will have to do this again the next time you update your packages. -- Set the variable =dotspacemacs-elpa-https= to =nil= in your dotfile. This has - the same effect as =--insecure=, but is persistent. - ** Typing quickly =fd= takes me out of =insert state=. What is going on? This is a feature of Spacemacs, enabling you to easily escape from a lot of situations, like escaping from =insert state= to =normal state=.