Skip to Content
Writing GNU Emacs Extensions
book

Writing GNU Emacs Extensions

by Bob Glickstein
April 1997
Intermediate to advanced
240 pages
5h 56m
English
O'Reilly Media, Inc.
Content preview from Writing GNU Emacs Extensions

The Debugger

Emacs Lisp has a built-in debugging mode that can be invoked automatically under certain circumstances. Entering the debugger is controlled as follows.

debug-on-entry

This is a command. It prompts (with completion) for the name of a function. Whenever that function is invoked, Emacs will enter the debugger.

debug-on-error

This is a variable. If it is non-nil, then Emacs will enter the debugger whenever an error is signaled.

debug-on-next-call

This is a variable. If it is non-nil, Emacs will enter the debugger the very next time an expression is to be evaluated.

debug-on-quit

This is a variable. If it is non-nil, Emacs will enter the debugger whenever a "quit" is signaled (e.g., when the user presses C-g).

When the debugger is invoked, a window displaying the Lisp stack appears. In this buffer, called *Backtrace*, each line represents a pending function call, with the top lines representing more recent calls. You can see the pending Lisp expressions, test the values of variables and other expressions in different contexts, and force a function to return a certain value.

These are the useful debugging-mode commands.

c

Leave the debugger, continuing whatever code was interrupted by entering it. This isn't possible when the debugger was invoked because of an error.

q

Leave the debugger, aborting the pending computation.

d

Continue execution until the next function call, then reenter the debugger.

e

Prompt for a Lisp expression to evaluate in the context of the topmost stack "frame."

b

"Break" ...

Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.

Read now

Unlock full access

More than 5,000 organizations count on O’Reilly

AirBnbBlueOriginElectronic ArtsHomeDepotNasdaqRakutenTata Consultancy Services

QuotationMarkO’Reilly covers everything we've got, with content to help us build a world-class technology community, upgrade the capabilities and competencies of our teams, and improve overall team performance as well as their engagement.
Julian F.
Head of Cybersecurity
QuotationMarkI wanted to learn C and C++, but it didn't click for me until I picked up an O'Reilly book. When I went on the O’Reilly platform, I was astonished to find all the books there, plus live events and sandboxes so you could play around with the technology.
Addison B.
Field Engineer
QuotationMarkI’ve been on the O’Reilly platform for more than eight years. I use a couple of learning platforms, but I'm on O'Reilly more than anybody else. When you're there, you start learning. I'm never disappointed.
Amir M.
Data Platform Tech Lead
QuotationMarkI'm always learning. So when I got on to O'Reilly, I was like a kid in a candy store. There are playlists. There are answers. There's on-demand training. It's worth its weight in gold, in terms of what it allows me to do.
Mark W.
Embedded Software Engineer

You might also like

GNU Emacs Pocket Reference

GNU Emacs Pocket Reference

Debra Cameron
Learning GNU Emacs, Second Edition

Learning GNU Emacs, Second Edition

Debra Cameron, Bill Rosenblatt, Eric S. Raymond

Publisher Resources

ISBN: 9781449395056Errata Page