FAQ update
Close #1206 Close #1269 Close #1504 Close #1742 Correct #3839
This commit is contained in:
parent
16d6b0363c
commit
7c160e8ae5
|
@ -735,6 +735,10 @@ very handy Vim key binding to scroll up.
|
||||||
Spacemacs binds ~C-u~ to =scroll-up= and change the universal argument binding
|
Spacemacs binds ~C-u~ to =scroll-up= and change the universal argument binding
|
||||||
to ~SPC u~.
|
to ~SPC u~.
|
||||||
|
|
||||||
|
*Note*: ~SPC u~ is not working before =helm-M-x= (~SPC :~). Instead, call
|
||||||
|
=helm-M-x= first, select the command you want to run, and press ~C-u~ before
|
||||||
|
pressing ~RETURN~. For instance: ~SPC : org-reload C-u RET~
|
||||||
|
|
||||||
** Micro-states
|
** Micro-states
|
||||||
Spacemacs defines a wide variety of =micro-states= (temporary overlay maps)
|
Spacemacs defines a wide variety of =micro-states= (temporary overlay maps)
|
||||||
where it makes sense. This prevents one from doing repetitive and tedious
|
where it makes sense. This prevents one from doing repetitive and tedious
|
||||||
|
@ -845,6 +849,10 @@ You can see samples of all included themes in this [[http://themegallery.robdor.
|
||||||
- Due to the inner working of themes in Emacs, switching theme during the same
|
- Due to the inner working of themes in Emacs, switching theme during the same
|
||||||
session may have some weird side effects. Although these side effects should
|
session may have some weird side effects. Although these side effects should
|
||||||
be pretty rare.
|
be pretty rare.
|
||||||
|
- In the terminal version of Emacs, color themes will not render correctly as
|
||||||
|
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]].
|
||||||
|
|
||||||
*Hint*: If you are an =Org= user, [[https://github.com/fniessen/emacs-leuven-theme][leuven-theme]] is amazing ;-)
|
*Hint*: If you are an =Org= user, [[https://github.com/fniessen/emacs-leuven-theme][leuven-theme]] is amazing ;-)
|
||||||
|
|
||||||
|
|
39
doc/FAQ.org
39
doc/FAQ.org
|
@ -14,6 +14,8 @@
|
||||||
- [[Should I place my settings in =user-init= or =user-config=?][Should I place my settings in =user-init= or =user-config=?]]
|
- [[Should I place my settings in =user-init= or =user-config=?][Should I place my settings in =user-init= or =user-config=?]]
|
||||||
- [[Why do some of my =org=-related settings cause problems?][Why do some of my =org=-related settings cause problems?]]
|
- [[Why do some of my =org=-related settings cause problems?][Why do some of my =org=-related settings cause problems?]]
|
||||||
- [[Why is Spacemacs hanging on startup?][Why is Spacemacs hanging on startup?]]
|
- [[Why is Spacemacs hanging on startup?][Why is Spacemacs hanging on startup?]]
|
||||||
|
- [[Why does =helm-M-x= (~SPC :~) not accept the prefix argument?][Why does =helm-M-x= (~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?]]
|
||||||
- [[How do I...][How do I...]]
|
- [[How do I...][How do I...]]
|
||||||
- [[Install a package not provided by a layer?][Install a package not provided by a layer?]]
|
- [[Install a package not provided by a layer?][Install a package not provided by a layer?]]
|
||||||
- [[Disable a package completely?][Disable a package completely?]]
|
- [[Disable a package completely?][Disable a package completely?]]
|
||||||
|
@ -26,10 +28,12 @@
|
||||||
- [[Setup =$PATH=?][Setup =$PATH=?]]
|
- [[Setup =$PATH=?][Setup =$PATH=?]]
|
||||||
- [[Change or define an alias for an =evil-leader= prefix?][Change or define an alias for an =evil-leader= prefix?]]
|
- [[Change or define an alias for an =evil-leader= prefix?][Change or define an alias for an =evil-leader= prefix?]]
|
||||||
- [[Restore the sentence delimiter to two spaces?][Restore the sentence delimiter to two spaces?]]
|
- [[Restore the sentence delimiter to two spaces?][Restore the sentence delimiter to two spaces?]]
|
||||||
|
- [[Prevent the visual selection overriding my system clipboard?][Prevent the visual selection overriding my system clipboard?]]
|
||||||
- [[Windows][Windows]]
|
- [[Windows][Windows]]
|
||||||
- [[Why do the fonts look crappy on Windows?][Why do the fonts look crappy on Windows?]]
|
- [[Why do the fonts look crappy on Windows?][Why do the fonts look crappy on Windows?]]
|
||||||
- [[Why is there no Spacemacs logo in the startup buffer?][Why is there no Spacemacs logo in the startup buffer?]]
|
- [[Why is there no Spacemacs logo in the startup buffer?][Why is there no Spacemacs logo in the startup buffer?]]
|
||||||
- [[Why are all packages unavailable?][Why are all packages unavailable?]]
|
- [[Why are all packages unavailable?][Why are all packages unavailable?]]
|
||||||
|
- [[The powerline isn't shown correctly when Spacemacs is used within =PuTTY=.][The powerline isn't shown correctly when Spacemacs is used within =PuTTY=.]]
|
||||||
- [[OS X][OS X]]
|
- [[OS X][OS X]]
|
||||||
- [[Why are the powerline colors not correct on OS X?][Why are the powerline colors not correct on OS X?]]
|
- [[Why are the powerline colors not correct on OS X?][Why are the powerline colors not correct on OS X?]]
|
||||||
|
|
||||||
|
@ -102,11 +106,29 @@ configuration:
|
||||||
|
|
||||||
See [[https://github.com/syl20bnr/spacemacs/issues/3422#issuecomment-148919047][issue #3422]] and [[https://github.com/emacs-helm/helm/issues/1000#issuecomment-119487649][helm issue #1000]] for details.
|
See [[https://github.com/syl20bnr/spacemacs/issues/3422#issuecomment-148919047][issue #3422]] and [[https://github.com/emacs-helm/helm/issues/1000#issuecomment-119487649][helm issue #1000]] for details.
|
||||||
|
|
||||||
|
** Why does =helm-M-x= (~SPC :~) not accept the prefix argument?
|
||||||
|
If you try to run =helm-M-x= with the prefix argument (i.e. ~SPC u SPC :~) it
|
||||||
|
will fail with this message:
|
||||||
|
|
||||||
|
#+begin_verse
|
||||||
|
Error: Specifying a prefix arg before calling helm-M-x
|
||||||
|
#+end_verse
|
||||||
|
|
||||||
|
Instead, call =helm-M-x= first, select the command you want to run, and press
|
||||||
|
~C-u~ before pressing ~RETURN~. For instance: ~SPC : org-reload C-u RET~
|
||||||
|
|
||||||
|
** Why does my color theme not render correctly in terminal mode?
|
||||||
|
In the terminal version of Emacs, color themes will not render correctly as
|
||||||
|
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]].
|
||||||
|
|
||||||
* How do I...
|
* How do I...
|
||||||
** Install a package not provided by a layer?
|
** Install a package not provided by a layer?
|
||||||
Spacemacs provides a variable in the =dotspacemacs/layers= function in
|
Spacemacs provides a variable in the =dotspacemacs/layers= function in
|
||||||
=.spacemacs= called =dotspacemacs-additional-packages=. Just add a package name
|
=.spacemacs= called =dotspacemacs-additional-packages=. Just add a package name
|
||||||
to the list and it will be installed when you restart.
|
to the list and it will be installed when you reload your configuration with
|
||||||
|
~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
|
||||||
|
@ -282,6 +304,18 @@ To restore the sentence delimiter to two spaces, add the following code to the
|
||||||
(setq sentence-end-double-space t)
|
(setq sentence-end-double-space t)
|
||||||
#+end_src
|
#+end_src
|
||||||
|
|
||||||
|
** Prevent the visual selection overriding my system clipboard?
|
||||||
|
On some operating systems, there is only one clipboard for both *copied* and
|
||||||
|
*selected* texts. This has the consequence that visual *selection* – which
|
||||||
|
should normally be saved to the /PRIMARY/ clipboard – overrides the /SYSTEM/
|
||||||
|
clipboard, where normally goes the *copied* text. This can be corrected by
|
||||||
|
adding the following code to the =dotspacemacs/user-config= of your
|
||||||
|
=.spacemacs=:
|
||||||
|
|
||||||
|
#+begin_src emacs-lisp
|
||||||
|
(fset 'evil-visual-update-x-selection 'ignore)
|
||||||
|
#+end_src
|
||||||
|
|
||||||
* 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
|
||||||
|
@ -302,6 +336,9 @@ Check if your Emacs has HTTPS capabilities by doing =M-:= and then:
|
||||||
If this returns =nil=, you need to install the GnuTLS DDL file in the same
|
If this returns =nil=, you need to install the GnuTLS DDL file in the same
|
||||||
directory as Emacs. See [[https://www.gnu.org/software/emacs/manual/html_mono/emacs-gnutls.html#Help-For-Users][here]] for instructions.
|
directory as Emacs. See [[https://www.gnu.org/software/emacs/manual/html_mono/emacs-gnutls.html#Help-For-Users][here]] for instructions.
|
||||||
|
|
||||||
|
** The powerline isn't shown correctly when Spacemacs is used within =PuTTY=.
|
||||||
|
You can follow [[http://mschulte.nl/posts/using-powerline-in-PuTTY.html][this explanation]] explaining how to correct this.
|
||||||
|
|
||||||
* OS X
|
* OS X
|
||||||
** Why are the powerline colors not correct on OS X?
|
** Why are the powerline colors not correct on OS X?
|
||||||
This is a [[https://github.com/milkypostman/powerline/issues/54][known issue]] as of Emacs 24.4 due to =ns-use-srgb-colorspace=
|
This is a [[https://github.com/milkypostman/powerline/issues/54][known issue]] as of Emacs 24.4 due to =ns-use-srgb-colorspace=
|
||||||
|
|
Loading…
Reference in New Issue