TakeV
/
spacemacs
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

[FAQ.org] Justify paragraphs

This commit is contained in:
Fabien Dubosson 2016-01-31 20:35:53 +01:00
parent 4cf6a88ff8
commit 125a553dae
1 changed files with 45 additions and 47 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

92
doc/FAQ.org
View File

@ -52,16 +52,15 @@ may also just type ~SPC f e v~.
As it is written, that is _space_ then _macs_. As it is written, that is _space_ then _macs_.
** 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?
To declare new packages you have to create a new configuration layer or To declare new packages you have to create a new configuration layer or add the
add the package name to the variable =dotspacemacs-additonal-packages= package name to the variable =dotspacemacs-additonal-packages= of your dotfile,
of your dotfile, see the [[file:QUICK_START.org][quick start guide]] for more info. see the [[file:QUICK_START.org][quick start guide]] for more info.
** How to fix package download errors when installing Spacemacs ? ** How to fix package download errors when installing Spacemacs ?
Since 0.105.0 HTTPS protocol is used by default to download packages. If your Since 0.105.0 HTTPS protocol is used by default to download packages. If your
environment does not allow HTTPS to reach ELPA repositories then you can start environment does not allow HTTPS to reach ELPA repositories then you can start
Emacs with the =--insecure= argument for force the usage of HTTP non secured Emacs with the =--insecure= argument for force the usage of HTTP non secured
protocol. protocol. You can set the variable =dotspacemacs-elpa-https= to =nil= in your
Then you can set the variable =dotspacemacs-elpa-https= to =nil= in your
dotfile to remove the need to start Emacs with =--insecure== argument. dotfile to remove the need to start Emacs with =--insecure== argument.
** The Spacemacs banner is ugly, what should I do? ** The Spacemacs banner is ugly, what should I do?
@ -80,18 +79,19 @@ section in the font section of the [[file:DOCUMENTATION.org][documentation]].
** Why is after-init-hook not executed? ** Why is after-init-hook not executed?
Don't launch Spacemacs with =emacs -q -l init.el= command. This command will run Don't launch Spacemacs with =emacs -q -l init.el= command. This command will run
the hooked functions in =after-init-hook= before the evaluation of the passed =-l the hooked functions in =after-init-hook= before the evaluation of the passed
init.el= file. =-l init.el= file.
** What is the difference between =spacemacs-base= and =spacemacs= distributions? ** What is the difference between =spacemacs-base= and =spacemacs= distributions?
The =distribution= concept was introduced in 0.104.x. You can now choose The =distribution= concept was introduced in 0.104.x. You can now choose between
between two distributions =spacemacs= or =spacemacs-base=. two distributions =spacemacs= or =spacemacs-base=. =spacemacs-base= contains
=spacemacs-base= contains only a minimal set of packages; whereas =spacemacs= only a minimal set of packages; whereas =spacemacs= is the full Spacemacs
is the full Spacemacs experience. experience.
Set the distribution with =dotspacemacs-distribution= variable. The default is Set the distribution with =dotspacemacs-distribution= variable. The default is
=spacemacs=. For more information as to what is included, =spacemacs=. For more information as to what is included, check out the
check out the =packages.el= file in the respective folders in the =packages.el= file in the respective folders in the =+distribution= folder of
=+distribution= folder of the =layers/= directory. the =layers/= directory.
** Should I place my settings in =user-init= or =user-config=? ** Should I place my settings in =user-init= or =user-config=?
Any variable that layer configuration code will *read* and *act on* must be set Any variable that layer configuration code will *read* and *act on* must be set
@ -107,15 +107,15 @@ should not be loaded before =dotspacemacs/user-config=, otherwise both versions
will be loaded and will conflict. will be loaded and will conflict.
Because of autoloading, calling to =org= functions will trigger the loading up Because of autoloading, calling to =org= functions will trigger the loading up
of the =org= shipped with emacs wich will induce conflicts. of the =org= shipped with emacs wich will induce conflicts. One way to avoid
One way to avoid conflict is to wrap your =org= config code in a conflict is to wrap your =org= config code in a =with-eval-after-load= block
=with-eval-after-load= block like this: like this:
#+BEGIN_SRC emacs-lisp #+BEGIN_SRC emacs-lisp
(with-eval-after-load 'org (with-eval-after-load 'org
;; here goes your Org config :) ;; here goes your Org config :)
;; .... ;; ....
) )
#+END_SRC #+END_SRC
** Why is Spacemacs hanging on startup? ** Why is Spacemacs hanging on startup?
@ -180,33 +180,31 @@ to the list and it will be installed when you reload your configuration with
~SPC f e R~, or at the next Spacemacs launch. ~SPC f e R~, or at the next Spacemacs launch.
** Disable a package completely? ** Disable a package completely?
To completely disable a package and effectively uninstalling it even if To completely disable a package and effectively uninstalling it even if it is
it is part of your used layers, look for the variable part of your used layers, look for the variable =dotspacemacs-excluded-packages=
=dotspacemacs-excluded-packages= in your dotfile and add the package in your dotfile and add the package name to it:
name to it:
#+begin_src emacs-lisp #+begin_src emacs-lisp
(setq-default dotspacemacs-excluded-packages '(package1 package2 ...)) (setq-default dotspacemacs-excluded-packages '(package1 package2 ...))
#+end_src #+end_src
** Disable a package only for a specific major-mode? ** Disable a package only for a specific major-mode?
This is done by removing the hook added by Spacemacs. For example to This is done by removing the hook added by Spacemacs. For example to remove
remove =flycheck= support in python buffers, look for the function =flycheck= support in python buffers, look for the function
=dotspacemacs/user-config= in your dotfile and add the following code: =dotspacemacs/user-config= in your dotfile and add the following code:
#+begin_src emacs-lisp #+begin_src emacs-lisp
(remove-hook 'python-mode-hook 'flycheck-mode) (remove-hook 'python-mode-hook 'flycheck-mode)
#+end_src #+end_src
*Hint* to know the name of the major-mode of the current buffer press: *Hint* to know the name of the major-mode of the current buffer press: ~SPC h d
~SPC h d v major-mode RET~ v major-mode RET~
** Disable company for a specific major-mode? ** Disable company for a specific major-mode?
It may be handy to disable =company= for a given mode if you plan on It may be handy to disable =company= for a given mode if you plan on configuring
configuring =auto-complete= instead. One easy way to do it is to use the =auto-complete= instead. One easy way to do it is to use the macro
macro =spacemacs|disable-company= in the function =dotspacemacs/user-config= =spacemacs|disable-company= in the function =dotspacemacs/user-config= of your
of your dotfile. The following snippet disables company for dotfile. The following snippet disables company for =python-mode=:
=python-mode=:
#+begin_src emacs-lisp #+begin_src emacs-lisp
(spacemacs|disable-company python-mode) (spacemacs|disable-company python-mode)
@ -214,10 +212,9 @@ of your dotfile. The following snippet disables company for
** Change special buffer rules? ** Change special buffer rules?
To change the way spacemacs marks buffers as useless, you can customize To change the way spacemacs marks buffers as useless, you can customize
=spacemacs-useless-buffers-regexp= which marks buffers matching the =spacemacs-useless-buffers-regexp= which marks buffers matching the regexp as
regexp as useless. The variable =spacemacs-useful-buffers-regexp= marks useless. The variable =spacemacs-useful-buffers-regexp= marks buffers matching
buffers matching the regexp as useful buffers. Both can be customized the regexp as useful buffers. Both can be customized the same way.
the same way.
Examples: Examples:
#+begin_src emacs-lisp #+begin_src emacs-lisp
@ -393,27 +390,28 @@ commits messages. To enable this you have to add the following line to your
** Try Spacemacs without modifying my existing Emacs configuration? ** Try Spacemacs without modifying my existing Emacs configuration?
Emacs' ability to use any directory as the home for launching it allows us to Emacs' ability to use any directory as the home for launching it allows us to
try out Spacemacs (or any other Emacs configuration we desire) without having to go try out Spacemacs (or any other Emacs configuration we desire) without having to
through the trouble of backing up our =~/.emacs.d= directory and then cloning the new go through the trouble of backing up our =~/.emacs.d= directory and then cloning
configuration. This can be achieved easily using the following steps: the new configuration. This can be achieved easily using the following steps:
#+BEGIN_SRC shell #+BEGIN_SRC shell
mkdir ~/spacemacs mkdir ~/spacemacs
git clone git@github.com:syl20bnr/spacemacs.git ~/spacemacs/.emacs.d git clone git@github.com:syl20bnr/spacemacs.git ~/spacemacs/.emacs.d
HOME=~/spacemacs emacs HOME=~/spacemacs emacs
#+END_SRC #+END_SRC
If you're on Fish shell, you will need to modify the last command to: =env HOME=$HOME/spacemacs emacs= If you're on Fish shell, you will need to modify the last command to:
=env HOME=$HOME/spacemacs emacs=
* Windows * Windows
** Why do the fonts look crappy on Windows? ** Why do the fonts look crappy on Windows?
You can install [[https://code.google.com/p/mactype/][MacType]] on Windows to get very nice looking fonts. It is You can install [[https://code.google.com/p/mactype/][MacType]] on Windows to get very nice looking fonts. It is also
also recommended to disable smooth scrolling on Windows. recommended to disable smooth scrolling on Windows.
** Why is there no Spacemacs logo in the startup buffer? ** Why is there no Spacemacs logo in the startup buffer?
A GUI build of emacs supporting image display is required. A GUI build of emacs supporting image display is required. You can follow the
You can follow the instructions [[http://stackoverflow.com/questions/2650041/emacs-under-windows-and-png-files][here]]. Alternatively you can download binaries instructions [[http://stackoverflow.com/questions/2650041/emacs-under-windows-and-png-files][here]]. Alternatively you can download binaries of emacs with image
of emacs with image support included such as [[http://emacsbinw64.sourceforge.net/][this one]]. support included such as [[http://emacsbinw64.sourceforge.net/][this one]].
** Why are all packages unavailable? ** Why are all packages unavailable?
Check if your Emacs has HTTPS capabilities by doing =M-:= and then: Check if your Emacs has HTTPS capabilities by doing =M-:= and then: