[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] master 954c865 006/187: Updated README
From: |
Michael Albinus |
Subject: |
[elpa] master 954c865 006/187: Updated README |
Date: |
Wed, 30 Dec 2015 11:49:21 +0000 |
branch: master
commit 954c865e74757152d8fd00e0394edcd8f748be0e
Author: John Wiegley <address@hidden>
Commit: John Wiegley <address@hidden>
Updated README
---
README.md | 22 ++++++++++++++--------
1 files changed, 14 insertions(+), 8 deletions(-)
diff --git a/README.md b/README.md
index ec7e83a..f7bc852 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,10 @@
# emacs-async
-Adds the ability to process Lisp concurrently, with a very simple syntax:
+async.el is an exceedingly simple (78 lines of code) module for doing
+asynchronous processing in Emacs, by spawning a child Emacs interpreter to
+execute a lambda function, and calling back when the job is done.
+
+It uses a very simple syntax:
(async-start
;; What to do in the child process
@@ -13,9 +17,8 @@ Adds the ability to process Lisp concurrently, with a very
simple syntax:
(lambda (result)
(message "Async process done, result should be 222: %s" result)))
-If you omit the callback function, `async-start` will return a process object
-that you can call `async-get` on when you're ready to wait for the result
-value:
+If you omit the callback function, `async-start` returns a process object that
+you can call `async-get` on when you're ready to wait for the result value:
(let ((proc (async-start
;; What to do in the child process
@@ -23,13 +26,16 @@ value:
(message "This is a test")
(sleep-for 3)
222))))
- (message "I'm going to do some work here")
- ;; ....
- (message "Async process done, result should be 222: %s"
+
+ (message "I'm going to do some work here") ;; ....
+
+ (message "Waiting on async process, result should be 222: %s"
(async-get proc)))
If you don't want to use a callback, and you don't care about any return value
-form the child proces, pass the `ignore` symbol as the second argument:
+form the child process, pass the `ignore` symbol as the second argument (if
+you don't, and never call `async-get', it will leave *emacs* process buffers
+hanging around):
(async-start
(lambda ()
- [elpa] master updated (e053cef -> ef4a542), Michael Albinus, 2015/12/30
- [elpa] master 6647749 002/187: Small change, Michael Albinus, 2015/12/30
- [elpa] master 8d37c00 004/187: Added note to README, Michael Albinus, 2015/12/30
- [elpa] master 4733d1e 001/187: Initial revision, Michael Albinus, 2015/12/30
- [elpa] master 3d388c6 007/187: Added support for signal propagation, Michael Albinus, 2015/12/30
- [elpa] master 0a7f3dd 008/187: Added async-inject-environment, Michael Albinus, 2015/12/30
- [elpa] master 954c865 006/187: Updated README,
Michael Albinus <=
- [elpa] master a8ac820 003/187: Renamed emacs-async.el to async.el, Michael Albinus, 2015/12/30
- [elpa] master 63fe7ee 010/187: Updated README, Michael Albinus, 2015/12/30
- [elpa] master c48d3db 009/187: Added smtpmail-async.el, Michael Albinus, 2015/12/30
- [elpa] master 728e791 005/187: Added dired-async, Michael Albinus, 2015/12/30
- [elpa] master 628a295 014/187: Send data over a pipe, rather than in an argument, Michael Albinus, 2015/12/30
- [elpa] master 190a040 012/187: Fixed async-smtpmail-send-it, Michael Albinus, 2015/12/30
- [elpa] master 4fb51ce 013/187: Corrected a problem with async deletions, Michael Albinus, 2015/12/30
- [elpa] master 1ad2902 011/187: Quiet byte-compiler warnings, Michael Albinus, 2015/12/30
- [elpa] master 742c82e 020/187: Added message passing, but undocumented for now, Michael Albinus, 2015/12/30
- [elpa] master b80f1a5 018/187: Don't use pipes for communication just yet, Michael Albinus, 2015/12/30