spacemacs/doc/FAQ.org

5.4 KiB

FAQ   TOC@4

Common

Which version of Spacemacs am I running ?

The version is displayed on the upper right corner of the loading screen. You may also just type SPC f e v.

What is the official pronunciation of Spacemacs ?

As it is written, that is space then macs.

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, see the quick start guide.

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 documentation.

The powerline separators are ugly, how can I fix them ?

Use the property :powerline-scale of the variable dotspacemacs-default-font. See font section of the documentation for more details.

The powerline separators have no anti-aliasing, what can I do ?

Emacs powerline uses XMP images to draw the separators in a graphical environment. You can have anti-aliasing if you use the utf8 separator. Note that by default the utf8 separator is used in a terminal. See the powerline section in the font section of the documentation.

Why is after-init-hook not executed ?

Don't launch Spacemacs with emacs -q -l init.el command. This command will run the hooked function in after-init-hook before the evaluation of the passed -l init.el file.

What is the difference between spacemacs-base and spacemacs distributions ?

The distribution concept was introduced in 0.104.x. You can now choose between two distributions spacemacs or spacemacs-base. spacemacs-base contains only a minimal set of packages; whereas spacemacs is the full Spacemacs experience. Set the distribution with dotspacemacs-distribution variable. The default is spacemacs. For more information as to what is included, check out the packages.el file in the respective folders in the +distribution folder of the layers/ directory.

Why do some of my org-related settings cause problems?

Since version 0.104, spacemacs uses the `org` version from the org ELPA repository instead of the one shipped with emacs. Then, any `org` related code should not be loaded before `dotspacemacs/user-config`, otherwise both versions will be loaded and will conflict.

Windows

Why do the fonts look crappy on Windows ?

You can install MacType on Windows to get very nice looking fonts. It is also recommended to disable smooth scrolling on Windows.

Why is there no Spacemacs logo in the startup buffer ?

A GUI build of emacs supporting image display is required. You can follow the instructions here. Alternatively you can download binaries of emacs with image support included such as this one.

Why are all packages unavailable?

Check if your Emacs has HTTPS capabilities by doing M-: and then:

  (gnutls-available-p)

If this returns nil, you need to install the GnuTLS DDL file in the same directory as Emacs. See here for instructions.

OS X

Why are the powerline colors not correct on OS X ?

This is a known issue as of Emacs 24.4 due to ns-use-srgb-colorspace defaulting to true. It is recommended to use the emacs-mac-port build. See the install section in the README for more details.