[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/bug-hunter 36b0594 67/95: Update comments
From: |
Stefan Monnier |
Subject: |
[elpa] externals/bug-hunter 36b0594 67/95: Update comments |
Date: |
Fri, 27 Nov 2020 22:06:58 -0500 (EST) |
branch: externals/bug-hunter
commit 36b0594de445c9f41c2260d785da2e76a1105946
Author: Artur Malabarba <bruce.connor.am@gmail.com>
Commit: Artur Malabarba <bruce.connor.am@gmail.com>
Update comments
---
README.org | 2 +-
bug-hunter.el | 43 +++++++++++++++++++------------------------
2 files changed, 20 insertions(+), 25 deletions(-)
diff --git a/README.org b/README.org
index 20e1e56..00d034c 100644
--- a/README.org
+++ b/README.org
@@ -3,7 +3,7 @@
The Bug Hunter is an Emacs library that finds the source of an error
-or unexpected behavior inside an elisp configuration file (tipically
+or unexpected behavior inside an elisp configuration file (typically
~init.el~ or ~.emacs~).
* Usage Examples
diff --git a/bug-hunter.el b/bug-hunter.el
index e0a35a9..bd3f771 100644
--- a/bug-hunter.el
+++ b/bug-hunter.el
@@ -22,55 +22,50 @@
;; along with this program. If not, see <http://www.gnu.org/licenses/>.
;;; Commentary:
-;; `bug-hunter' is an Emacs library that finds the source of an error or
+;;
+;; The Bug Hunter is an Emacs library that finds the source of an error or
;; unexpected behavior inside an elisp configuration file (typically
;; `init.el' or `.emacs').
-;;
-;;
+;;
;; Usage Examples
;; ==============
-;;
+;;
;; If your Emacs init file signals an error during startup, but you don’t
;; know why, simply issue
;; ,----
;; | M-x bug-hunter-init-file RET RET
;; `----
-;; and `bug-hunter' will find it for you.
-;;
+;; and The Bug Hunter will find it for you. Note that your `init.el' (or
+;; `.emacs') must be idempotent for this to work.
+;;
;; If Emacs starts up without errors but something is not working as it
;; should, invoke the same command, but give it in an assertion.
;; Essentially, if you can write a snippet that detects the issue and
;; returns non-nil, just provide this snippet as the assertion and the
;; Bug Hunter will do a bisection search for you.
-;;
+;;
;; For example, let’s say there’s something in your init file that’s
;; loading the `cl' library, and you don’t want that. You /know/ you’re
;; not loading it yourself, but how can you figure out which external
;; package is responsible for this outrage?
-;;
+;;
;; ,----
;; | M-x bug-hunter-init-file RET (featurep 'cl) RET
;; `----
-;;
+;;
;; *That’s it!* You’ll be given a nice buffer reporting the results:
-;;
+;;
;; - Are you getting obscure errors when trying to open /“.tex”/ files?
-;; Don’t despair! Just use `(find-file "dummy.tex")' as the assertion.
-;; - Did `ox-html' stop working due to some arcane misconfiguration? Just
-;; write an assertion that does an export and checks the result.
+;; - Don’t despair! Just use `(find-file "dummy.tex")' as the
+;; assertion.
+;; - Did `ox-html' stop working due to some arcane misconfiguration?
+;; - Just write an assertion that does an export and checks the result.
;; - Does some random command suddenly bind itself to `C-j' and you can’t
-;; figure out why? `(eq (key-binding "\n") 'unwanted-command)' is the
-;; assertion for you!
-;;
+;; figure out why?
+;; - `(eq (key-binding "\n") 'unwanted-command)' is the assertion for
+;; you!
+;;
;; Finally, you can also use `bug-hunter-file' to hunt in other files.
-;;
-
-;; Installation
-;; ============
-;;
-;; Bug Hunter will be on Melpa shortly. For now, do the following:
-;; 1. Open the `bug-hunter.el` file.
-;; 2. Issue `M-x package-install-from-buffer`.
;;; Code:
- [elpa] externals/bug-hunter 2524718 55/95: Don't quote file name argument to `call-process`, (continued)
- [elpa] externals/bug-hunter 2524718 55/95: Don't quote file name argument to `call-process`, Stefan Monnier, 2020/11/27
- [elpa] externals/bug-hunter 0f9bd03 17/95: Copyright and deps, Stefan Monnier, 2020/11/27
- [elpa] externals/bug-hunter 0fbf2a4 24/95: Run after-init-hooks, Stefan Monnier, 2020/11/27
- [elpa] externals/bug-hunter 4da93d7 36/95: Provide full information on where the bug occurs., Stefan Monnier, 2020/11/27
- [elpa] externals/bug-hunter 80af9de 38/95: Ignore cask, Stefan Monnier, 2020/11/27
- [elpa] externals/bug-hunter 95d6857 44/95: DOC, Stefan Monnier, 2020/11/27
- [elpa] externals/bug-hunter a0ed5ea 40/95: Move around variables, Stefan Monnier, 2020/11/27
- [elpa] externals/bug-hunter 1d2f393 41/95: Report which expression caused an error., Stefan Monnier, 2020/11/27
- [elpa] externals/bug-hunter 1a050a0 57/95: Merge pull request #2 from lunaryorn/patch-1, Stefan Monnier, 2020/11/27
- [elpa] externals/bug-hunter c2f2d29 60/95: Note about init file idempotence, Stefan Monnier, 2020/11/27
- [elpa] externals/bug-hunter 36b0594 67/95: Update comments,
Stefan Monnier <=
- [elpa] externals/bug-hunter f9780b8 68/95: Style fixes, Stefan Monnier, 2020/11/27
- [elpa] externals/bug-hunter 5075592 71/95: Inhibit readonly, Stefan Monnier, 2020/11/27
- [elpa] externals/bug-hunter 5f61401 33/95: More tests, Stefan Monnier, 2020/11/27
- [elpa] externals/bug-hunter e903dd0 37/95: Ignore a dummy file, Stefan Monnier, 2020/11/27
- [elpa] externals/bug-hunter 1778749 58/95: Improve bisection logic to avoid unnecessary step., Stefan Monnier, 2020/11/27
- [elpa] externals/bug-hunter 0794ccf 66/95: Merge pull request #8 from hariharanr5/master, Stefan Monnier, 2020/11/27
- [elpa] externals/bug-hunter 0998393 70/95: Implement interactive assertion throughout, Stefan Monnier, 2020/11/27
- [elpa] externals/bug-hunter 130cc12 45/95: Report what we can when the user aborts., Stefan Monnier, 2020/11/27
- [elpa] externals/bug-hunter 53a74dd 46/95: Whitespace, Stefan Monnier, 2020/11/27
- [elpa] externals/bug-hunter a4ba22d 49/95: checkdoc, Stefan Monnier, 2020/11/27