Add documentation in README.md and FAQ for --insecure

Should fix #4375
This commit is contained in:
syl20bnr 2016-01-05 01:16:29 -05:00
parent 2f479eedc3
commit 74689e0c22
2 changed files with 15 additions and 0 deletions

View File

@ -199,6 +199,12 @@ For efficient searches we recommend to install `pt` ([the platinum searcher][]).
manually. manually.
3. Launch Emacs. Spacemacs will automatically install the packages it requires. 3. Launch Emacs. Spacemacs will automatically install the packages it requires.
If you get an error regarding package downloads then you may try to disable
HTTPS protocol by starting Emacs with
```sh
emacs --insecure
```
4. Restart Emacs to complete the installation. 4. Restart Emacs to complete the installation.

View File

@ -6,6 +6,7 @@
- [[Which version of Spacemacs am I running?][Which version of Spacemacs am I running?]] - [[Which version of Spacemacs am I running?][Which version of Spacemacs am I running?]]
- [[What is the official pronunciation of Spacemacs?][What is the official pronunciation of Spacemacs?]] - [[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?]] - [[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 ?]]
- [[The Spacemacs banner is ugly, what should I do?][The Spacemacs banner is ugly, what should I do?]] - [[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 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?]] - [[The powerline separators have no anti-aliasing, what can I do?][The powerline separators have no anti-aliasing, what can I do?]]
@ -53,6 +54,14 @@ To declare new packages you have to create a new configuration layer or
add the package name to the variable =dotspacemacs-additonal-packages= add the package name to the variable =dotspacemacs-additonal-packages=
of your dotfile, see the [[file:QUICK_START.org][quick start guide]] for more info. of your dotfile, see the [[file:QUICK_START.org][quick start guide]] for more info.
** How to fix package download errors when installing Spacemacs ?
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
Emacs with the =--insecure= argument for force the usage of HTTP non secured
protocol.
Then you can set the variable =dotspacemacs-elpa-https= to =nil= in your
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?
Install the default font supported by Spacemacs or choose a fixed width font. 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]]. More information in the font section of the [[file:DOCUMENTATION.org][documentation]].