[elpa] externals/dtache eaf141725f 044/158: Add compile section to tips and tricks in README

[ELPA Syncer]

branch: externals/dtache
commit eaf141725f423a003ea18bacc5c7548195deb61d
Author: Niklas Eklund <niklas.eklund@posteo.net>
Commit: Niklas Eklund <niklas.eklund@posteo.net>

    Add compile section to tips and tricks in README
---
 README.org | 34 +++++++++++++++++++++++++++++++++-
 1 file changed, 33 insertions(+), 1 deletion(-)

diff --git a/README.org b/README.org
index b786ee1b25..abbd236b2f 100644
--- a/README.org
+++ b/README.org
@@ -230,11 +230,43 @@ The =dtache= package supports 
[[https://www.gnu.org/software/emacs/manual/html_n
 Some programs doesn't play well with =tee= which =dtache= relies upon to 
redirect the output both to standard out as well as to file. If you encounter a 
situation where output from a session is only visible once it has finished 
running, the command you launched should instead be using =redirect only=. To 
list a command to run with redirect only in the future can be done by adding a 
regexp to =dtache-redirect-only-regexps=.
 
 #+begin_src elisp
-  (setq dtache-read-only-list '("^ls"))
+  (setq dtache-redirect-only-regexps '("^ls"))
 #+end_src
 
 Here the command beginning with =ls= would from now on be using redirect only.
 
+** Replace compile with dtache
+
+*** Unconditionally
+
+=Dtache= can be seen as a replacement for =compile=. To unconditionally 
replace the latter with the former one can apply this advice.
+
+#+begin_src elisp
+  (defun dtache-compile-override (command &optional _)
+    "Run COMMAND with `dtache'."
+    (dtache-start-session command))
+
+  (advice-add 'compile :override #'dtache-compile-override)
+#+end_src
+
+#+RESULTS:
+
+*** Selectively
+
+Maybe you like the behavior of =compile= but for some specific commands you 
would like to replace the usage of =compile= with =dtache=. That can be done 
with the following advice, in this case replacing the usage of =compile= within 
function =foo=.
+
+#+begin_src elisp
+  (defun dtache-replace-compile-advice (orig-fun &rest args)
+    "Replace `compile' with `dtache'.
+  This is done before ORIG-FUN is passed ARGS."
+    (cl-letf* (((symbol-function 'compile)
+                (lambda (command &optional _)
+                  (dtache-start-session command))))
+      (apply orig-fun args)))
+
+  (advice-add #'foo :around #'dtache-replace-compile-advice)
+#+end_src
+
 ** Evil bindings
 
 For inspiration on how to configure =dtache-list-sessions= to use evil 
bindings see 
[[https://gitlab.com/niklaseklund/dotfiles/blob/master/.config/emacs/init.el#L1393][Niklas
 Eklund's Emacs config]].