diff options
author | Bozhidar Batsov <bozhidar@batsov.com> | 2016-04-06 13:03:58 +0300 |
---|---|---|
committer | Bozhidar Batsov <bozhidar@batsov.com> | 2016-04-06 13:03:58 +0300 |
commit | f0faf630ee48dd712f008842dbfa8d9d19e86de3 (patch) | |
tree | 5b0a9411e972a1ce5c991dc2e1d31438e6d00a05 /doc/troubleshooting.md | |
parent | 140bb130f17ec9eb5db73133c60bc8269938e467 (diff) |
Add a section on debugging lock ups
Diffstat (limited to 'doc/troubleshooting.md')
-rw-r--r-- | doc/troubleshooting.md | 14 |
1 files changed, 14 insertions, 0 deletions
diff --git a/doc/troubleshooting.md b/doc/troubleshooting.md index ddfda65f..783eb020 100644 --- a/doc/troubleshooting.md +++ b/doc/troubleshooting.md @@ -42,6 +42,20 @@ try to debug an expression (e.g., with `C-u C-M-x`). [File an issue](https://github.com/clojure-emacs/cider-repl/issues/new) and copy this information. +### Debugging freezes & lock ups + +Sometimes a CIDER command might hang for a while (e.g. due to a bug or a +configuration issue). Such problems are super annoying, but are relatively easy +to debug. Here are a few steps you can take in such situations: + +* Do `M-x toggle-debug-on-quit` +* Reproduce the problem +* Hit `C-g` around 10 seconds into the hang + +This will bring up a backtrace with the entire function stack, including +function arguments. So you should be able to figure out what's going on (or at +least what's being required). + ### Warning saying you have to use nREPL 0.2.12+ CIDER currently requires at least nREPL 0.2.12 to work properly (there were some |