gav451/emacs.d
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Reorder sub-sections in the "Emacs Lisp Programming" section

Browse Source
This commit is contained in:
Gerard Vermeulen 2024-06-23 14:26:02 +02:00
parent 39cbbbd8fb
commit ff3bb1e756
1 changed files with 27 additions and 25 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

52
README.org
View File

@ -4381,6 +4381,31 @@ Here is a list of links describing how to program and debug [[info:elisp#Top][Em
Ref. [cite:@Monnier.ACM-PL.4.1] exposes the evolution of Emacs Lisp and explains
important Emacs Lisp idioms.
*** [[https://www.masteringemacs.org/article/evaluating-elisp-emacs][Evaluating Elisp in Emacs]]
:PROPERTIES:
:CUSTOM_ID: sec:elisp-evaluation
:END:
Listing [[lst:setup-ielm][setup ielm]] configures the [[https://wikemacs.org/wiki/IELM][Interactive Emacs Lisp Mode]] for better
interoperability with [[https://smartparens.readthedocs.io/en/latest/][smartparens]]: get help on the key bindings by means of
src_emacs-lisp[:results none]{(describe-function 'ielm)}.
#+caption[Setup =ielm=]:
#+caption: Setup =ielm=.
#+name: lst:setup-ielm
#+begin_src emacs-lisp -n :results silent
(with-eval-after-load 'ielm
(setopt ielm-dynamic-return nil))
#+end_src
*** [[info:elisp#Debugging][Debugging Emacs Lisp (info)]]
:PROPERTIES:
:CUSTOM_ID: sec:debugging
:END:
GAV: I fail to instrument the functions from the [[https://www.emacswiki.org/emacs/SourceLevelDebugger][source level debugger (edebug)]]
wiki entry as the [[info:elisp#Edebug][Edebug (info)]] manual explains.
*** [[info:emacs#Known Problems][Reading existing bug reports (info)]]
:PROPERTIES:
:CUSTOM_ID: sec:bug-reports
@ -4397,38 +4422,15 @@ access the [[https://lists.gnu.org/mailman/listinfo/bug-gnu-emacs][bug-gnu-emacs
;; (info "(debbugs) Top")
;; (info "(emacs) Bug Reference")
(ensure-package-installation 'debbugs)
(defvar bug-reference-url-format
"https://debbugs.gnu.org/cgi/bugreport.cgi?bug=%s"
"Format to use `gnu-debbugs' URL.")
(add-to-list 'safe-local-eval-forms '(bug-reference-mode +1))
(put 'bug-reference-mode 'safe-local-variable 'booleanp)
#+end_src
*** [[info:elisp#Debugging][Debugging Emacs Lisp (info)]]
:PROPERTIES:
:CUSTOM_ID: sec:debugging
:END:
GAV: I fail to instrument the functions from the [[https://www.emacswiki.org/emacs/SourceLevelDebugger][source level debugger (edebug)]]
wiki entry as in [[info:elisp#Edebug][Edebug (info)]].
*** [[https://www.masteringemacs.org/article/evaluating-elisp-emacs][Evaluating Elisp in Emacs]]
:PROPERTIES:
:CUSTOM_ID: sec:elisp-evaluation
:END:
Listing [[lst:setup-ielm][setup ielm]] configures the [[https://wikemacs.org/wiki/IELM][Interactive Emacs Lisp Mode]] for better
interoperability with [[https://smartparens.readthedocs.io/en/latest/][smartparens]]: get help on the key bindings by means of
src_emacs-lisp[:results none]{(describe-function 'ielm)}.
#+caption[Setup =ielm=]:
#+caption: Setup =ielm=.
#+name: lst:setup-ielm
#+begin_src emacs-lisp -n :results silent
(with-eval-after-load 'ielm
(setopt ielm-dynamic-return nil))
#+end_src
*** [[http://yummymelon.com/devnull/writing-better-elisp-docstrings.html][Writing Better Elisp Docstrings]]
:PROPERTIES:
:CUSTOM_ID: sec:describe-function-at-point