Como depurar uma falha do emacs?

Estou depurando por que o emacs falha ao usar uma função de um pacote ¹ . O objetivo deste processo de depuração é obter dados úteis para enviar usando M-x report-emacs-bug.

Para obter ajuda sobre como depurar falhas do emacs, eu já consultei o Manual do Emacs - Crashing e Manual do Emacs - Após um Crash , mas eles não ajudaram.

O manual After A Crash se refere, emacs-buffer.gdbmas não tenho idéia de como usá-lo. Ao pedir ajuda ao google, me deparei com essa pergunta do emacs.SE e recompilei o emacs usando as -ggdb3bandeiras.

Como não tenho experiência anterior, gdbtentei algumas tentativas fracassadas de usar o emacs-buffer.gbdarquivo.

Aqui está o que eu tentei:

• gdb -x /path/to/emacs-buffer.gdb
• gdb -> file /path/to/emacs-buffer.gdb
• gdb -> source /path/to/emacs-buffer.gdb
• source /path/to/emacs-buffer.gdb

Em uma nota lateral, o emacs compilado com a -ggdb3bandeira leva cerca de 10 segundos a mais para carregar; antes, eram 5-6 segundos, agora cerca de 16 a 17 segundos. Eu sei os segundos exatos por causa de um código que calcula isso no meu init. É esperado um aumento no tempo de inicialização?

_{Nota de rodapé 1: o emacs falha constantemente quando undo-treetenta restaurar o histórico de desfazer de um arquivo .org específico (que não posso compartilhar publicamente). Eu tenho (setq undo-tree-auto-save-history t). Essa falha ocorre apenas no emacs git master, não no emacs 24.5. No emacs 24.5, undo-treegera um erro informando que não é possível carregar o histórico de desfazer (mesmo que exista o arquivo de histórico de desfazer), mas pelo menos a sessão do emacs não falha nessa versão.}

A maneira mais fácil de depurar uma falha do Emacs é iniciar o Emacs abaixo gdbe, em seguida, fazer o que for que reproduz a falha.

Supondo que você esteja construindo seu Emacs a partir da fonte, você deve passar CFLAGS="-O0 -g3"para o ./configurescript. Isso faz com que o compilador C desative as otimizações (que podem tornar as coisas confusas durante a depuração) e ativa o máximo de informações de depuração no executável. Corra makepara criar o Emacs.

Em seguida, inicie gdbde dentro do srcdiretório da sua árvore do Emacs:

$ cd ~/my-emacs-tree/src
$ gdb ./emacs

No OSX, você desejará passar --with-nspara o ./configurescript e iniciar o gdb no Emacs dentro do aplicativo criado:

$ cd ~/my-emacs-tree
$ make install
$ cd src
$ gdb nextstep/Emacs.app/Contents/MacOS/Emacs

O motivo para iniciar a partir do srcdiretório é que existe um .gdbinitarquivo que define definições úteis de funções do GDB para depurar o Emacs. Se esse arquivo foi carregado, você deve ver algo assim ao iniciar gdb:

DISPLAY = /private/tmp/com.apple.launchd.cNjhIdtUNd/org.macosforge.xquartz:0
TERM = xterm-256color
Breakpoint 1 at 0x1000ca444: file ../../src/emacs.c, line 353.
Breakpoint 2 at 0x1000e7e34: file ../../src/sysdep.c, line 926.

Digite rpara iniciar o Emacs. Você pode passar argumentos extras na mesma linha, por exemplo r --debug-init.

Em seguida, tente fazer o Emacs travar. Se ele travar, você verá uma observação gdbe será (gdb)novamente solicitado. Se o Emacs não travar, mas congelar, você pode bater C-zno terminal em que está executando gdbpara voltar ao prompt.

Uma vez no prompt, digite btpara obter um retorno. Como bônus, se o .gdbinitarquivo Emacs foi carregado corretamente, você verá um backtrace do Lisp após o backtrace C. Ambos os backtraces são coisas muito úteis para incluir M-x report-emacs-bug.

Há muito mais informações, incluindo como examinar o estado das variáveis, etc., no etc/DEBUGarquivo na árvore do Emacs. Você pode abri-lo digitando C-h C-ddentro do Emacs ou pode lê-lo online .