[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[nongnu] elpa/devil fbc422c666 20/49: Add steps to install Devil from ME
|
From: |
ELPA Syncer |
|
Subject: |
[nongnu] elpa/devil fbc422c666 20/49: Add steps to install Devil from MELPA |
|
Date: |
Mon, 15 May 2023 12:59:32 -0400 (EDT) |
branch: elpa/devil
commit fbc422c6661c437b8b7950c289d7e149cf736790
Author: Susam Pal <susam@susam.net>
Commit: Susam Pal <susam@susam.net>
Add steps to install Devil from MELPA
---
README.md | 85 ++++++++++++++++++++++++++++++++++++++++++++++++++++++---------
1 file changed, 74 insertions(+), 11 deletions(-)
diff --git a/README.md b/README.md
index da62961073..d89d0fadf1 100644
--- a/README.md
+++ b/README.md
@@ -19,7 +19,10 @@ Contents
* [Introduction](#introduction)
* [Notation](#notation)
-* [Get Started](#get-started)
+* [Install](#install)
+ * [Install Interactively from MELPA](#install-interactively-from-melpa)
+ * [Install Automatically from MELPA](#install-automatically-from-melpa)
+ * [Install from Git Source](#install-from-git-source)
* [Use Devil](#use-devil)
* [Typing Commas](#typing-commas)
* [Devil Reader](#devil-reader)
@@ -80,12 +83,74 @@ general and how Emacs functions like `key-description`,
type a space, it is represented as `SPC`.
-Get Started
------------
+Install
+-------
+
+### Install Interactively from MELPA
+
+Devil is available via [MELPA](https://melpa.org/). You may already
+have a preferred way of installing packages from MELPA. If so, install
+the package named `devil` to get Devil. For the sake of completeness,
+here is a very basic way of installing Devil from MELPA:
+
+ 1. Add the following to the Emacs initialization file (i.e.,
+ `~/.emacs` or `~/.emacs.d/init.el` or `~/.config/emacs/init.el`):
-To get started quickly with Devil, clone its Git repository to your
-system and load it in your Emacs initialization file with the
-following steps:
+ ```sh
+ (require 'package)
+ (add-to-list 'package-archives '("melpa" . "https://melpa.org/packages/")
t)
+ (package-initialize)
+ ```
+
+ 2. Start Emacs with the updated initialization file and then type
+ these commands:
+
+ ```
+ M-x package-refresh-contents RET
+ M-x package-install RET devil RET
+ ```
+
+ 3. Confirm that Devil is installed successfully with this command:
+
+ ```
+ M-x devil-show-version RET
+ ```
+
+ 4. Enable Devil mode with this command:
+
+ ```
+ M-x global-devil-mode RET
+ ```
+
+ 4. Type `, x , f` and watch Devil translate it to `C-x C-f` and
+ invoke the corresponding command.
+
+
+### Install Automatically from MELPA
+
+Here is yet another basic way to install and enable Devil using Elisp:
+
+```elisp
+(require 'package)
+(add-to-list 'package-archives '("melpa" . "https://melpa.org/packages/") t)
+(package-initialize)
+(unless package-archive-contents
+ (package-refresh-contents))
+(unless (package-installed-p 'devil)
+ (package-install 'devil))
+(global-devil-mode)
+(global-set-key (kbd "C-,") 'global-devil-mode)
+```
+
+Now type `, x , f` and watch Devil translate it to `C-x C-f` and
+invoke the corresponding command. Type `C-,` to disable Devil mode.
+Type `C-,` again to enable it.
+
+
+### Install from Git Source
+
+If you prefer obtaining Devil from its Git repository, follow these
+steps:
1. Clone Devil to your system:
@@ -93,8 +158,7 @@ following steps:
git clone https://github.com/susam/devil.git
```
- 2. Add the following to your Emacs initialization file (i.e., to your
- `~/.emacs` or `~/.emacs.d/init.el` or `~/.config/emacs/init.el`):
+ 2. Add the following to your Emacs initialization:
```elisp
(add-to-list 'load-path "/path/to/devil/")
@@ -108,9 +172,8 @@ following steps:
lighter.
4. Type `, x , f` and watch Devil translate it to `C-x C-f` and
- invoke the corresponding command.
-
- 5. Type `C-,` to disable Devil mode. Type `C-,` again to enable it.
+ invoke the corresponding command. Type `C-,` to disable Devil
+ mode. Type `C-,` again to enable it.
Use Devil
- [nongnu] elpa/devil 355bcc9c14 34/49: Extract most of the README into a separate manual, (continued)
- [nongnu] elpa/devil 355bcc9c14 34/49: Extract most of the README into a separate manual, ELPA Syncer, 2023/05/15
- [nongnu] elpa/devil 79fd50fe22 36/49: Set version to 0.3.0, ELPA Syncer, 2023/05/15
- [nongnu] elpa/devil c60437c11b 39/49: Support making all key sequences repeatable, ELPA Syncer, 2023/05/15
- [nongnu] elpa/devil f6ddd7cac1 38/49: Fix undefined error for RET, <f10>, etc., ELPA Syncer, 2023/05/15
- [nongnu] elpa/devil 72ce585e59 42/49: Document devil-all-keys-repeatable in the manual, ELPA Syncer, 2023/05/15
- [nongnu] elpa/devil 305a41dc55 45/49: Add MELPA badges, ELPA Syncer, 2023/05/15
- [nongnu] elpa/devil 2fe542cbc6 46/49: Mention Emacs at the beginning of documentation, ELPA Syncer, 2023/05/15
- [nongnu] elpa/devil b84cd61eec 40/49: Format .org files consistently, ELPA Syncer, 2023/05/15
- [nongnu] elpa/devil a42a778ec3 43/49: Add devil-all-keys-repeatable to changelog, ELPA Syncer, 2023/05/15
- [nongnu] elpa/devil 1ddc4dc2e3 44/49: Fix key translation for key vector as Devil key, ELPA Syncer, 2023/05/15
- [nongnu] elpa/devil fbc422c666 20/49: Add steps to install Devil from MELPA,
ELPA Syncer <=
- [nongnu] elpa/devil 2090eb34f4 21/49: Move configuration examples to subsections, ELPA Syncer, 2023/05/15
- [nongnu] elpa/devil 92b95191ca 25/49: Remove demo files, ELPA Syncer, 2023/05/15
- [nongnu] elpa/devil ef7a7d4c74 29/49: Add 'devil' customisation group, ELPA Syncer, 2023/05/15
- [nongnu] elpa/devil b3ad615c76 30/49: Fix spacing in documentation strings, ELPA Syncer, 2023/05/15
- [nongnu] elpa/devil 1b929b815b 31/49: * devil.el (devil--saved-keys): Assign nil by default, ELPA Syncer, 2023/05/15
- [nongnu] elpa/devil eb38e94a8a 47/49: Do not duplicate support section in the manual, ELPA Syncer, 2023/05/15
- [nongnu] elpa/devil d63216f1cd 48/49: Link to HTML manual, ELPA Syncer, 2023/05/15