[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] master 9f23289 3/3: * bug-hunter.el: Bump version number
From: |
Artur Malabarba |
Subject: |
[elpa] master 9f23289 3/3: * bug-hunter.el: Bump version number |
Date: |
Sun, 26 Apr 2015 18:04:18 +0000 |
branch: master
commit 9f2328925e5bbb5be791e200dc4e421aa9c89551
Author: Artur Malabarba <address@hidden>
Commit: Artur Malabarba <address@hidden>
* bug-hunter.el: Bump version number
Also expand documentation.
---
packages/bug-hunter/bug-hunter.el | 51 ++++++++++++++++--------------------
1 files changed, 23 insertions(+), 28 deletions(-)
diff --git a/packages/bug-hunter/bug-hunter.el
b/packages/bug-hunter/bug-hunter.el
index 8dcd7a6..2d0fc50 100644
--- a/packages/bug-hunter/bug-hunter.el
+++ b/packages/bug-hunter/bug-hunter.el
@@ -2,9 +2,9 @@
;; Copyright (C) 2015 Free Software Foundation, Inc.
-;; Author: Artur Malabarba <address@hidden>
-;; URL: http://github.com/Bruce-Connor/elisp-bug-hunter
-;; Version: 0.1
+;; Author: Artur Malabarba <address@hidden>
+;; URL: http://github.com/Malabarba/elisp-bug-hunter
+;; Version: 0.2
;; Keywords: lisp
;; Package-Requires: ((seq "1.3") (cl-lib "0.5"))
@@ -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
-;; unexpected behavior inside an elisp configuration file (tipically
+;;
+;; 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 Gelpa shortly. For now, do the following:
-;; 1. Open the `bug-hunter.el` file.
-;; 2. Issue `M-x package-install-from-buffer`.
;;; Code: