Compare commits

...

2 Commits

View File

@ -227,7 +227,6 @@ of [[info:emacs#Saving Customizations][saving customizations (info)]].
next-error-message-highlight t
recentf-max-saved-items history-length
recentf-mode t
save-place-mode t
savehist-mode t
scroll-bar-mode nil
tab-always-indent 'complete
@ -1840,10 +1839,11 @@ Listing [[lst:configure-nov]] configures [[https://depp.brause.cc/nov.el/][nov.e
The [[https://github.com/vedang/pdf-tools][pdf-tools]] package exploits the [[https://github.com/freedesktop/poppler][poppler]] library to render and to let you
annotate [[https://en.wikipedia.org/wiki/PDF][PDF]] files. It also exploits the [[https://wiki.contextgarden.net/SyncTeX][SyncTeX]] library to link anchors in [[https://en.wikipedia.org/wiki/PDF][PDF]]
files produced with LaTeX to the original LaTeX sources. In order to use
[[https://github.com/vedang/pdf-tools][pdf-tools]], you have to type {{{kbd(M-x pdf-tools-install)}}} after installation
of [[https://github.com/vedang/pdf-tools][pdf-tools]] from [[https://melpa.org/][MELPA]] or after each update of [[https://github.com/freedesktop/poppler][poppler]] to build or rebuild the
=epdfinfo= executable that serves the [[https://en.wikipedia.org/wiki/PDF][PDF]] files to Emacs. Table
files produced with LaTeX to the original LaTeX sources. Listing
[[lst:setup-pdf-tools]] loads =bookmark= in order to use [[https://github.com/vedang/pdf-tools][pdf-tools]] with
[[https://github.com/nicolaisingh/saveplace-pdf-view][saveplace-pdf-view]]. Building or rebuilding the =epdfinfo= executable that
serves the [[https://en.wikipedia.org/wiki/PDF][PDF]] files to Emacs is necessary after installation of [[https://github.com/vedang/pdf-tools][pdf-tools]] from
[[https://melpa.org/][MELPA]] or after each update of [[https://github.com/freedesktop/poppler][poppler]]. Table
[[tab:pdf-view-mode-commands-and-bindings]] lists important local map key bindings
in ~pdf-view-mode~. Note: ~image-save~ saves the page under point to a ~png~
file.
@ -1852,10 +1852,13 @@ file.
#+caption: Setup =pdf-tools=.
#+name: lst:setup-pdf-tools
#+begin_src emacs-lisp -n :results silent
(when (ensure-package-installation 'pdf-tools)
(when (ensure-package-installation 'pdf-tools 'saveplace-pdf-view)
;; Enable `save-place-mode' after loading those two libraries.
(require 'bookmark) ; Prevent unexpected Emacs setup weirdness.
(require 'saveplace-pdf-view) ; Like the documentation.
(save-place-mode +1) ; Like the documentation.
;; Use `pdf-loader-install' for faster startup than with `pdf-tools-install'.
(pdf-loader-install)
(with-eval-after-load 'pdf-view
(setopt pdf-view-display-size 'fit-page
pdf-view-use-scaling (eq system-type 'darwin))))
@ -4418,16 +4421,15 @@ wiki entry as the [[info:elisp#Edebug][Edebug (info)]] manual explains.
:CUSTOM_ID: sec:bug-reports
:END:
Listing [[lst:bug-reports]] ensures the installation of the =debbugs= extension
package to access the [[https://debbugs.gnu.org/][GNU Bug Tracker]] and sets up [[info:emacs#Bug Reference][Bug Reference Mode (info)]] to
access the [[https://lists.gnu.org/mailman/listinfo/bug-gnu-emacs][bug-gnu-emacs]] mailing list.
Listing [[lst:bug-reports]] ensures the installation of the [[info:debbugs#Top][Debbugs (info)]] extension
package to access the [[https://debbugs.gnu.org/][GNU Bug Tracker]], sets up [[info:emacs#Bug Reference][Bug Reference Mode (info)]] to
access the [[https://lists.gnu.org/mailman/listinfo/bug-gnu-emacs][bug-gnu-emacs]] mailing list, and enables [[info:emacs#Goto Address mode][Goto Address mode (info)]] to
open web links in source blocks.
#+caption[Setup reading existing bug reports]:
#+caption: Setup reading existing bug reports.
#+name: lst:bug-reports
#+begin_src emacs-lisp -n :results silent
;; (info "(debbugs) Top")
;; (info "(emacs) Bug Reference")
(ensure-package-installation 'debbugs)
(defvar bug-reference-url-format
@ -4437,8 +4439,7 @@ access the [[https://lists.gnu.org/mailman/listinfo/bug-gnu-emacs][bug-gnu-emacs
(add-to-list 'safe-local-eval-forms '(bug-reference-mode +1))
(put 'bug-reference-mode 'safe-local-variable 'booleanp)
;; (info "(emacs) Goto Address mode")
(add-hook 'emacs-lisp-mode-hook #'goto-address-mode)
(add-hook 'org-mode-hook #'goto-address-mode)
#+end_src
*** [[http://yummymelon.com/devnull/writing-better-elisp-docstrings.html][Writing Better Elisp Docstrings]]