X-Git-Url: https://code.delx.au/gnu-emacs-elpa/blobdiff_plain/f44f8be7ba1b86ecbf5d331143c505e081fa5886..e8db6cc6f717f5ebd92e17abb1c7931324b29fd8:/README.md

diff --git a/README.md b/README.md
index 7e4fa8014..e19fb5a54 100644
--- a/README.md
+++ b/README.md
@@ -1,9 +1,16 @@
+<p><a href="http://www.gnu.org/licenses/gpl-3.0.txt"><img src="https://img.shields.io/badge/license-GPL_3-green.svg" alt="License GPL 3" /></a>
+<a href="http://melpa.org/#/async"><img src="http://melpa.org/packages/async-badge.svg" alt="MELPA" title="" /></a>
+<a href="http://stable.melpa.org/#/async"><img src="http://stable.melpa.org/packages/async-badge.svg" alt="MELPA Stable" title="" /></a></p>
+
+
 # emacs-async
 
 `async.el` is a module for doing asynchronous processing in Emacs.
 
 # Install
 
+## Install dired-async
+
 Add to your `.emacs.el`:
 
     (autoload 'dired-async-mode "dired-async.el" nil t)
@@ -18,6 +25,27 @@ you can disable this by running the copy, rename etc... commands with a prefix a
 
 If you don't want to make dired/helm asynchronous disable it with `dired-async-mode`.
 
+### Debian and Ubuntu
+
+Users of Debian 9 or later or Ubuntu 16.04 or later may simply `apt-get install elpa-async`.
+
+## Enable asynchronous compilation of your (M)elpa packages
+
+By default emacs package.el compile packages in its running emacs session.
+This is not a problem when installing a new package (which is not actually loaded in current emacs)
+but it may create errors and bad compilation when upgrading a package (old version of package is already loaded
+and running in current emacs).
+You can remedy to this by allowing async to compile your packages asynchronously,
+(helm and magit actually do this by default,
+so if you are using these packages they will compile asynchronously)
+to do this, add to your init file:
+    
+    (async-bytecomp-package-mode 1)
+
+
+You can control which packages will compile async with `async-bytecomp-allowed-packages`.
+Set it to `'(all)` to be sure you will compile all packages asynchronously.
+
 # Usage
 
 The interface is intended to be very easy to use: