[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[nongnu] elpa/macrostep 8950313 037/110: Bump version number and changel
From: |
ELPA Syncer |
Subject: |
[nongnu] elpa/macrostep 8950313 037/110: Bump version number and changelog for 0.8 |
Date: |
Sat, 7 Aug 2021 09:17:58 -0400 (EDT) |
branch: elpa/macrostep
commit 8950313a4e6e3e4bc1d9b0ce4ad4e3bf2f3eb73a
Author: joddie <jonxfield@gmail.com>
Commit: joddie <jonxfield@gmail.com>
Bump version number and changelog for 0.8
---
README.org | 2 ++
macrostep.el | 105 ++++++++++++++++++++++++++++++-----------------------------
2 files changed, 55 insertions(+), 52 deletions(-)
diff --git a/README.org b/README.org
index 9452fd6..2cfbf08 100644
--- a/README.org
+++ b/README.org
@@ -132,6 +132,8 @@
macrolet forms
** Changelog
+ - v0.8, 2014-05-29: fix a bug with printing the first element of
+ lists
- v0.7, 2014-05-11: expand locally-defined macros within
(cl-)macrolet forms
- v0.6, 2013-05-04: better handling of quote and backquote
diff --git a/macrostep.el b/macrostep.el
index a00802a..2abe1e5 100644
--- a/macrostep.el
+++ b/macrostep.el
@@ -6,7 +6,7 @@
;; Maintainer: joddie <j.j.oddie@gmail.com>
;; Created: 16 January 2012
;; Updated: 11 May 2014
-;; Version: 0.7
+;; Version: 0.8
;; Keywords: lisp, languages, macro, debugging
;; Url: https://github.com/joddie/macrostep
@@ -26,23 +26,24 @@
;; along with this program. If not, see `http://www.gnu.org/licenses/'.
;;; Commentary:
-;;
+
;; 1 Overview
;; ==========
-;;
+
;; This is a minor mode for interactively stepping through the expansion
;; of macros in Emacs Lisp source code. It lets you see exactly what
;; happens at each step of the expansion process by pretty-printing the
;; expanded forms inline in the source buffer, which is read-only while
;; macro expansions are visible. You can expand and collapse macro forms
;; one step at a time, and evaluate or instrument them for debugging with
-;; Edebug as normal (but see "Bugs and known limitations", below).
-;; Single-stepping through the expansion is useful for debugging macros
-;; that expand into another macro form, especially one like `lexical-let'
-;; that does significant rewriting. These can be difficult to debug with
-;; Emacs' built-in `macroexpand', because `macroexpand' continues
-;; expansion until the top-level form is no longer a macro call.
-;;
+;; Edebug as normal (but see "Bugs and known limitations",
+;; below). Single-stepping through the expansion is useful for debugging
+;; macros that expand into another macro form, especially one like
+;; `lexical-let' that does significant rewriting. These can be difficult
+;; to debug with Emacs' built-in `macroexpand', because `macroexpand'
+;; continues expansion until the top-level form is no longer a macro
+;; call.
+
;; The mode also adds some simple additional fontification to
;; macro-expanded code. The heads of macro sub-forms are fontified using
;; `macrostep-macro-face'. Uninterned symbols (gensyms) are fontified
@@ -57,50 +58,50 @@
;; 2 Key-bindings and usage
;; ========================
-;;
+
;; The standard macrostep-mode keybindings are the following:
-;;
+
;; e, =, RET : expand the macro form following point one step
;; c, u, DEL : collapse the form following point
;; q, C-c C-c: collapse all expanded forms and exit macrostep-mode
;; n, TAB : jump to the next macro form in the expansion
;; p, M-TAB : jump to the previous macro form in the expansion
-;;
-;; It's not very useful to enable and disable macrostep-mode directly.
-;; Instead, bind `macrostep-expand' to a key in `emacs-lisp-mode-map',
-;; for example C-c e:
-;;
+
+;; It's not very useful to enable and disable macrostep-mode
+;; directly. Instead, bind `macrostep-expand' to a key in
+;; `emacs-lisp-mode-map', for example C-c e:
+
;; ,----
;; | (define-key emacs-lisp-mode-map (kbd "C-c e") 'macrostep-expand)
;; `----
-;;
+
;; You can then enter macrostep-mode and expand a macro form completely
;; by typing `C-c e e e ...' as many times as necessary.
-;;
+
;; Exit macrostep-mode either with `q', `C-c C-c', or by successively
;; typing `c' to collapse all expanded forms back to their original text.
-;;
-;;
+
+
;; 3 Expanding sub-forms
;; =====================
-;;
+
;; By moving point around in the macro expansion (perhaps using the `n'
;; and `p' keys), you can macro-expand sub-forms before fully expanding
;; the enclosing form. This can be useful in some cases, but you should
;; keep in mind that it does not correspond to the way Emacs actually
-;; expands macro calls when evaluating or compiling your code. Macro
+;; expands macro calls when evaluating or compiling your code. Macro
;; expansion in Emacs Lisp always proceeds by fully expanding the outer
;; form to a non-macro form before doing anything with the sub-forms.
-;;
+
;; For example, with `cl' loaded, try expanding the following form:
-;;
+
;; ,----
;; | (dolist (l list-of-lists)
;; | (incf (car l)))
;; `----
-;;
+
;; to produce the following:
-;;
+
;; ,----
;; | (block nil
;; | (let
@@ -115,48 +116,48 @@
;; | (cdr --cl-dolist-temp--)))
;; | nil))
;; `----
-;;
+
;; where the forms beginning `block' and `incf' are both macro calls.
-;;
+
;; At this point, you can either continue expanding the `block' form,
;; which corresponds to the real order of macro expansion in evaluation,
;; or type `n' to move point to the unexpanded `incf' and expand it to a
-;; `callf' form and finally to a `let*' form. If you then move point back
-;; to the `block' and expand it, an unexpanded `incf' form appears again
-;; in the result. This might look visually confusing, but it does at
-;; least correspond to the way real macro expansion works.
-;;
+;; `callf' form and finally to a `let*' form. If you then move point
+;; back to the `block' and expand it, an unexpanded `incf' form appears
+;; again in the result. This might look visually confusing, but it does
+;; at least correspond to the way real macro expansion works.
+
;; Why allow expanding sub-forms out of order like this at all? The main
;; reason is for debugging macros which expand into another macro, like
;; `lexical-let', that programmatically expands its contents in order to
-;; rewrite them. In this case, expanding the sub-forms first allows you
+;; rewrite them. In this case, expanding the sub-forms first allows you
;; to see what `lexical-let' would compute via `cl-macroexpand-all'.
-;;
-;;
+
+
;; 4 Bugs and known limitations
;; ============================
-;;
+
;; You can evaluate and edebug macro-expanded forms and step through the
;; macro-expanded version, but the form that `eval-defun' and friends
;; read from the buffer won't have the uninterned symbols of the real
-;; macro expansion. This will probably work OK with CL-style gensyms, but
-;; may cause problems with `make-symbol' symbols if they have the same
-;; print name as another symbol in the expansion. It's possible that
+;; macro expansion. This will probably work OK with CL-style gensyms,
+;; but may cause problems with `make-symbol' symbols if they have the
+;; same print name as another symbol in the expansion. It's possible that
;; using `print-circle' and `print-gensym' could get around this.
-;;
+
;; The macro stepper doesn't bother trying to determine whether or not a
;; sub-form is in an evaluated position before highlighting it as a
;; macro. It does exclude `lambda' from treatment as a macro, since that
-;; leads to an endless series of expansions: `(function (function ...
-;; ))'. It would be better to recognise `function', `quote' and other
+;; leads to an endless series of expansions: `(function (function
+;; ... ))'. It would be better to recognise `function', `quote' and other
;; special forms using their `edebug-form-spec' property.
-;;
+
;; Please send other bug reports and feature requests to the author.
-;;
-;;
+
+
;; 5 Acknowledgements
;; ==================
-;;
+
;; Thanks to:
;; - John Wiegley for fixing a bug with the face definitions under Emacs
;; 24 & for plugging macrostep in his [EmacsConf presentation]!
@@ -167,12 +168,12 @@
;; [EmacsConf presentation] http://youtu.be/RvPFZL6NJNQ
-;;
-;;
+
+
;; 6 Changelog
;; ===========
-;;
+;; - v0.8, 2014-05-29: fix a bug with printing the first element of lists
;; - v0.7, 2014-05-11: expand locally-defined macros within (cl-)macrolet
;; forms
;; - v0.6, 2013-05-04: better handling of quote and backquote
@@ -181,7 +182,7 @@
;; macro-expansion
;; - v0.3, 2012-10-30: print dotted lists correctly. autoload
;; definitions.
-;;
+
;;; Code:
;; We use `pp-buffer' to pretty-print macro expansions
- [nongnu] elpa/macrostep 51d5b6a 036/110: Fix a bug with printing the first element of a list., (continued)
- [nongnu] elpa/macrostep 51d5b6a 036/110: Fix a bug with printing the first element of a list., ELPA Syncer, 2021/08/07
- [nongnu] elpa/macrostep 07e14e2 032/110: Test for macrostep-environment-at-point, ELPA Syncer, 2021/08/07
- [nongnu] elpa/macrostep c93c2d6 053/110: Language-agnostic macro-form boundaries, ELPA Syncer, 2021/08/07
- [nongnu] elpa/macrostep e3e5c12 034/110: Merge branch 'expand-macrolet', ELPA Syncer, 2021/08/07
- [nongnu] elpa/macrostep 4ea178a 045/110: Simplify overlay collapsing, ELPA Syncer, 2021/08/07
- [nongnu] elpa/macrostep 2519692 038/110: Restore narrowing, ELPA Syncer, 2021/08/07
- [nongnu] elpa/macrostep c748996 057/110: Tweak macrostep-slime-macro-form-p, ELPA Syncer, 2021/08/07
- [nongnu] elpa/macrostep 3757ec4 033/110: Extend macrostep-environment while printing macrolet body forms, ELPA Syncer, 2021/08/07
- [nongnu] elpa/macrostep a478a3a 054/110: Bind inhibit-read-only instead of buffer-read-only, ELPA Syncer, 2021/08/07
- [nongnu] elpa/macrostep 8d72b62 044/110: Fix indentation in new macrostep-pp function, ELPA Syncer, 2021/08/07
- [nongnu] elpa/macrostep 8950313 037/110: Bump version number and changelog for 0.8,
ELPA Syncer <=
- [nongnu] elpa/macrostep 5680278 056/110: Gross hack to macrostep--slime-propertize-macros, ELPA Syncer, 2021/08/07
- [nongnu] elpa/macrostep 31e1dc2 060/110: Detect Elisp macro forms by advising `macroexpand`, ELPA Syncer, 2021/08/07
- [nongnu] elpa/macrostep c61b836 062/110: Use SB-WALKER:WALK-FORM to collect macro forms, ELPA Syncer, 2021/08/07
- [nongnu] elpa/macrostep 39e809a 064/110: swank-macrostep: call PROVIDE at the end, ELPA Syncer, 2021/08/07
- [nongnu] elpa/macrostep 1be6c4d 061/110: Extract Elisp macro environments accurately, ELPA Syncer, 2021/08/07
- [nongnu] elpa/macrostep d9c7629 063/110: Improvements to Elisp environment handling, ELPA Syncer, 2021/08/07
- [nongnu] elpa/macrostep 59972eb 071/110: Fix handling of subforms contained within other subforms, ELPA Syncer, 2021/08/07
- [nongnu] elpa/macrostep a0ae61c 073/110: Properly handle forms not present in the expansion, ELPA Syncer, 2021/08/07
- [nongnu] elpa/macrostep 817322b 074/110: Properly place the macrostep[-compiler]-macro-face, ELPA Syncer, 2021/08/07
- [nongnu] elpa/macrostep aa40d97 076/110: Test expansion within Elisp macro-defining macros, ELPA Syncer, 2021/08/07