[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[nongnu] elpa/macrostep 993a79f 010/110: bump version number, add change
From: |
ELPA Syncer |
Subject: |
[nongnu] elpa/macrostep 993a79f 010/110: bump version number, add changelog |
Date: |
Sat, 7 Aug 2021 09:17:52 -0400 (EDT) |
branch: elpa/macrostep
commit 993a79f0791ef61b365a45d665b5486b868d22b7
Author: joddie <jonxfield@gmail.com>
Commit: joddie <jonxfield@gmail.com>
bump version number, add changelog
---
README.org | 7 +++---
macrostep.el | 81 +++++++++++++++++++++++++++++++++++-------------------------
2 files changed, 51 insertions(+), 37 deletions(-)
diff --git a/README.org b/README.org
index f85efe6..17416ea 100644
--- a/README.org
+++ b/README.org
@@ -120,13 +120,14 @@
... ))=. It would be better to recognise =function=, =quote= and
other special forms using their =edebug-form-spec= property.
- Macro-expanding a call to an autoloaded macro doesn't work. This
- shouldn't be too hard to fix.
-
Please send other bug reports and feature requests to the author.
** Acknowledgements
Thanks to John Wiegley for fixing a bug with the face definitions
under Emacs 24.
+** Changelog
+ - v0.3, 2012-10-30: print dotted lists correctly. autoload
+ definitions.
+
#+OPTIONS: author:nil email:nil toc:nil timestamp:nil
diff --git a/macrostep.el b/macrostep.el
index 31967e0..3476461 100644
--- a/macrostep.el
+++ b/macrostep.el
@@ -6,7 +6,7 @@
;; Maintainer: joddie <j.j.oddie@gmail.com>
;; Created: 16 January 2012
;; Updated: 23 September 2012
-;; Version: 0.2
+;; Version: 0.3
;; Keywords: lisp, languages, macro, debugging
;; Url: https://github.com/joddie/macrostep
@@ -26,11 +26,11 @@
;; along with this program. If not, see `http://www.gnu.org/licenses/'.
;;; Commentary:
-
+
;; 1.1 Overview
;; =============
-;; `macrostep-mode' is a minor mode for interactively stepping through
-;; the expansion of macros in Emacs Lisp source code. It lets you see
+;; 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
@@ -43,7 +43,7 @@
;; `macroexpand', because `macroexpand' continues expansion until the
;; top-level form is no longer a macro call.
;;
-;; `macrostep-mode' also adds some simple additional fontification to
+;; 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 based on which step in the expansion created them, to
@@ -54,7 +54,7 @@
;; 1.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
@@ -74,7 +74,7 @@
;;
;;
;; You can then enter macrostep-mode and expand a macro form
-;; completely by typing =C-c e e e ...= as many times as necessary.
+;; 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
@@ -82,22 +82,27 @@
;;
;; 1.3 Expanding sub-forms
;; ========================
-;; By moving point around in the macro expansion (perhaps using `n'
-;; and `p'), 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 expansion in Emacs Lisp always proceeds by fully
+;; 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 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
;; ((--cl-dolist-temp-- list-of-lists)
@@ -111,16 +116,17 @@
;; (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 at least corresponds to the way
-;; real macro expansion works.
+;; 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.
;;
;; Why allow expanding sub-forms out of order like this at all? The
;; main reason is for debugging macros which expand into another
@@ -130,29 +136,36 @@
;; via `cl-macroexpand-all'.
;;
;;
-;; 1.4 Bugs and known limitations:
-;; ================================
+;; 1.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
-;; `(gensym)'s, 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.
+;; 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 special forms using their edebug-form-spec property.
-;;
-;; Macro-expanding a call to an autoloaded macro doesn't work. This
-;; shouldn't be too hard to fix.
+;; that 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.
;;
+;; 1.5 Acknowledgements
+;; =====================
+;; Thanks to John Wiegley for fixing a bug with the face definitions
+;; under Emacs 24.
+;;
+;; 1.6 Changelog
+;; ==============
+;; - v0.3, 2012-10-30: print dotted lists correctly. autoload
+;; definitions.
+;;
;;; Code:
- [nongnu] elpa/macrostep e9a95f4 049/110: Fix `macrostep--macro-form-info`, (continued)
- [nongnu] elpa/macrostep e9a95f4 049/110: Fix `macrostep--macro-form-info`, ELPA Syncer, 2021/08/07
- [nongnu] elpa/macrostep e35b61d 047/110: Add compiler-macro support for SLIME, ELPA Syncer, 2021/08/07
- [nongnu] elpa/macrostep 3766ffb 043/110: Hack to propertize macros in SLIME expansions, ELPA Syncer, 2021/08/07
- [nongnu] elpa/macrostep 522226f 050/110: Improve `macrostep-slime-macro-form-p`, ELPA Syncer, 2021/08/07
- [nongnu] elpa/macrostep 059dda6 066/110: Also hook into slime-repl-mode, ELPA Syncer, 2021/08/07
- [nongnu] elpa/macrostep e582ca7 078/110: Fix trivial bug printing a single non-list form, ELPA Syncer, 2021/08/07
- [nongnu] elpa/macrostep 84e5bfa 086/110: Make tests pass again, ELPA Syncer, 2021/08/07
- [nongnu] elpa/macrostep 2dd3447 004/110: Fix bug with output of macros that expand to a string (e.g. `rx'), ELPA Syncer, 2021/08/07
- [nongnu] elpa/macrostep 6c4afbe 002/110: Got rid of `macrostep-change-group'. Updated some documentation., ELPA Syncer, 2021/08/07
- [nongnu] elpa/macrostep e2bf1aa 005/110: Change :reverse-video to :inverse-video for e24, ELPA Syncer, 2021/08/07
- [nongnu] elpa/macrostep 993a79f 010/110: bump version number, add changelog,
ELPA Syncer <=
- [nongnu] elpa/macrostep 9cd6742 016/110: Try to be smarter about maintaining buffer state, ELPA Syncer, 2021/08/07
- [nongnu] elpa/macrostep cb2019e 017/110: acknowledgements in docs, ELPA Syncer, 2021/08/07
- [nongnu] elpa/macrostep 5c62a4c 021/110: Merge remote-tracking branch 'georgek/backquotes', ELPA Syncer, 2021/08/07
- [nongnu] elpa/macrostep f026495 025/110: Fix comment typos, ELPA Syncer, 2021/08/07
- [nongnu] elpa/macrostep 77c0c1a 023/110: update readme, ELPA Syncer, 2021/08/07
- [nongnu] elpa/macrostep b04f8db 026/110: Basic support for expanding macros bound by `macrolet', ELPA Syncer, 2021/08/07
- [nongnu] elpa/macrostep 7acce07 028/110: Require `cl-macs` at runtime, ELPA Syncer, 2021/08/07
- [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