[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] master 89f1ca6 133/187: Merge pull request #42 from mneilsen/mast
From: |
Michael Albinus |
Subject: |
[elpa] master 89f1ca6 133/187: Merge pull request #42 from mneilsen/master |
Date: |
Wed, 30 Dec 2015 11:50:11 +0000 |
branch: master
commit 89f1ca6df38a8b5271785c14cde97e2c8124486b
Merge: 0ddafcf dc63b59
Author: John Wiegley <address@hidden>
Commit: John Wiegley <address@hidden>
Merge pull request #42 from mneilsen/master
Documentation tweaks; mention DEFAULT-DIRECTORY
---
README.md | 17 +++++++++--------
async.el | 3 ++-
2 files changed, 11 insertions(+), 9 deletions(-)
diff --git a/README.md b/README.md
index f34b2ab..bc764ba 100644
--- a/README.md
+++ b/README.md
@@ -26,7 +26,7 @@ The interface is intended to be very easy to use:
## async-start
async-start START-FUNC FINISH-FUNC
-
+
Execute START-FUNC (often a lambda) in a subordinate Emacs process. When
done, the return value is passed to FINISH-FUNC. Example:
@@ -40,7 +40,7 @@ done, the return value is passed to FINISH-FUNC. Example:
;; What to do when it finishes
(lambda (result)
(message "Async process done, result should be 222: %s" result)))
-
+
If FINISH-FUNC is `nil` or missing, a future is returned that can be inspected
using `async-get`, blocking until the value is ready. Example:
@@ -57,7 +57,7 @@ using `async-get`, blocking until the value is ready.
Example:
(async-get proc)))
If you don't want to use a callback, and you don't care about any return value
-form the child process, pass the `'ignore` symbol as the second argument (if
+from 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):
@@ -74,17 +74,18 @@ however, as an argument to `async-ready` or `async-wait`.
## async-start-process
async-start-process NAME PROGRAM FINISH-FUNC &rest PROGRAM-ARGS
-
+
Start the executable PROGRAM asynchronously. See `async-start`. PROGRAM is
passed PROGRAM-ARGS, calling FINISH-FUNC with the process object when done.
If FINISH-FUNC is `nil`, the future object will return the process object when
-the program is finished.
+the program is finished. Set DEFAULT-DIRECTORY to change PROGRAM's current
+working directory.
## async-get
async-get FUTURE
-
-Get the value from an asynchronously function when it is ready. FUTURE is
+
+Get the value from an asynchronously called function when it is ready. FUTURE
is
returned by `async-start` or `async-start-process` when its FINISH-FUNC is
`nil`.
@@ -92,7 +93,7 @@ returned by `async-start` or `async-start-process` when its
FINISH-FUNC is
async-ready FUTURE
-Query a FUTURE to see if the ready is ready -- i.e., if no blocking
+Query a FUTURE to see if its function's value is ready -- i.e., if no blocking
would result from a call to `async-get` on that FUTURE.
## async-wait
diff --git a/async.el b/async.el
index d44f14a..be9c04e 100644
--- a/async.el
+++ b/async.el
@@ -200,7 +200,8 @@ its FINISH-FUNC is nil."
PROGRAM is passed PROGRAM-ARGS, calling FINISH-FUNC with the
process object when done. If FINISH-FUNC is nil, the future
object will return the process object when the program is
-finished."
+finished. Set DEFAULT-DIRECTORY to change PROGRAM's current
+working directory."
(let* ((buf (generate-new-buffer (concat "*" name "*")))
(proc (let ((process-connection-type nil))
(apply #'start-process name buf program program-args))))
- [elpa] master f44f8be 150/187: * README.md: Update infos for dired-async., (continued)
- [elpa] master f44f8be 150/187: * README.md: Update infos for dired-async., Michael Albinus, 2015/12/30
- [elpa] master 1da6e8f 144/187: Don't use package--get-deps that doesn't handle non installed packages., Michael Albinus, 2015/12/30
- [elpa] master 40d4f78 154/187: New mode async-bytecomp-package-mode., Michael Albinus, 2015/12/30
- [elpa] master 348600d 138/187: Unbound async-byte-recompile-directory when reinstalling async., Michael Albinus, 2015/12/30
- [elpa] master 12235bd 156/187: * async-pkg.el: Update version number., Michael Albinus, 2015/12/30
- [elpa] master 2235bc9 135/187: Inject bytecomp variables (#44)., Michael Albinus, 2015/12/30
- [elpa] master c9fb3f5 147/187: async-bytecomp-allowed-packages should be a list of symbols., Michael Albinus, 2015/12/30
- [elpa] master 2b01ad8 137/187: Merge branch 'master' of github.com:jwiegley/emacs-async, Michael Albinus, 2015/12/30
- [elpa] master 98ef20d 162/187: Change mode-line face., Michael Albinus, 2015/12/30
- [elpa] master 2143217 159/187: Bind print-level and print-length (#48)., Michael Albinus, 2015/12/30
- [elpa] master 89f1ca6 133/187: Merge pull request #42 from mneilsen/master,
Michael Albinus <=
- [elpa] master 1f5e89b 146/187: * async-bytecomp.el (package--compile): Fix typo., Michael Albinus, 2015/12/30
- [elpa] master 7625671 140/187: Async compile also dependendies (#46)., Michael Albinus, 2015/12/30
- [elpa] master d250e7b 139/187: Allow customizing which packages compile async (#46)., Michael Albinus, 2015/12/30
- [elpa] master 51c598b 149/187: Add autoload cookie and make dired-async--modeline-mode internal., Michael Albinus, 2015/12/30
- [elpa] master 23edf9e 151/187: * dired-async.el (dired-async-mode): Fix group name., Michael Albinus, 2015/12/30
- [elpa] master c368125 155/187: * async-bytecomp.el: Add autoload cookies., Michael Albinus, 2015/12/30
- [elpa] master bedfa96 152/187: * dired-async.el: Fix compatibility with emacs-24.3., Michael Albinus, 2015/12/30
- [elpa] master 753d593 148/187: Allow enabling dired-async with a minor-mode., Michael Albinus, 2015/12/30
- [elpa] master cdbf622 157/187: No message on startup when quiet., Michael Albinus, 2015/12/30
- [elpa] master 4ab15f7 161/187: Merge pull request #50 from tarsius/master, Michael Albinus, 2015/12/30