jt/emacs-prelude
1
0
Fork 0
Code Issues Pull requests Actions Packages Projects Releases Wiki Activity

[Docs] Improve the installation instructions

Browse source
This commit is contained in:
Bozhidar Batsov 2020-09-16 19:22:49 +03:00
parent 8c6285314e
commit d40d05d47c
1 changed files with 26 additions and 13 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

39
doc/installation.md
View file

@ -26,36 +26,49 @@ All those tools are completely optional, though.
### Automated ### Automated
You can install **Emacs Prelude** via the command line with either `curl` or You can install Emacs Prelude via the command line with either `curl` or
`wget`. Naturally `git` is also required. `wget`. Naturally `git` is also required.
The installer script will do the following:
* Clone Prelude's GitHub repo
* Check your Emacs version
* Backup any existing `.emacs` or `.emacs.d` you might have
* Create any additional folders if necessary (e.g. for storing package-specific data)
If you have a `.emacs` file it will backed up as `.emacs.pre-prelude` and if you have
a `.emacs.d` folder, it will be backed up as `.emacs.d.pre-prelude.tar`.
#### Via Curl #### Via Curl
If you're using `curl` type the following command: If you're using `curl` type the following command:
```bash ```shellsession
curl -L https://github.com/bbatsov/prelude/raw/master/utils/installer.sh | sh $ curl -L https://github.com/bbatsov/prelude/raw/master/utils/installer.sh | sh
``` ```
#### Via Wget #### Via Wget
If you're using `wget` type: If you're using `wget` type:
```bash ```shellsession
wget --no-check-certificate https://github.com/bbatsov/prelude/raw/master/utils/installer.sh -O - | sh $ wget --no-check-certificate https://github.com/bbatsov/prelude/raw/master/utils/installer.sh -O - | sh
``` ```
### Manual ### Manual
Make sure you do not have any `~/.emacs` file or `~/.emacs.d` folder present. Make sure you do not have any `~/.emacs` file or `~/.emacs.d` folder present.
```bash ```shellsession
git clone git://github.com/bbatsov/prelude.git path/to/local/repo $ git clone git://github.com/bbatsov/prelude.git path/to/local/repo
ln -s path/to/local/repo ~/.emacs.d $ ln -s path/to/local/repo ~/.emacs.d
cd ~/.emacs.d $ cd ~/.emacs.d
``` ```
If you are using Windows, you should check what Emacs thinks the `~` directory is by running Emacs and typing `C-x d ~/<RET>`, and then adjust the command appropriately. !!! Note
If you are using Windows, you should check what Emacs thinks the `~` directory is by running Emacs
and typing `C-x d ~/<RET>`, and then adjust the command appropriately.
## Updating Prelude ## Updating Prelude
@ -69,9 +82,9 @@ Just run <kbd>M-x package-list-packages RET U x</kbd>.
#### Update Prelude's code #### Update Prelude's code
```bash ```shellsession
cd path/to/prelude/installation $ cd path/to/prelude/installation
git pull $ git pull
``` ```
The `path/to/prelude/installation` is usually `~/.emacs.d` (at least The `path/to/prelude/installation` is usually `~/.emacs.d` (at least