procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

; Improve documentation of last change

Browse source 
* lisp/doc-view.el (doc-view-register-alist)
(doc-view-page-to-register, doc-view-jump-to-register): Doc fixes.

* etc/NEWS:
* doc/emacs/misc.texi (DocView Navigation): Improve wording.
(Bug#73293)
This commit is contained in:
Eli Zaretskii 2024-09-28 12:11:57 +03:00
parent fb3aa69356
commit 9c994537cf
3 changed files with 11 additions and 9 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

3
doc/emacs/misc.texi
View file

@ -593,6 +593,7 @@ can further customize how @code{imenu} items are formatted and
displayed using the variables @code{doc-view-imenu-format} and
@code{doc-view-imenu-flatten}.
@cindex registers, in DocView mode
@findex doc-view-page-to-register
@findex doc-view-jump-to-register
@kindex m @r{(DocView mode)}
@ -600,7 +601,7 @@ displayed using the variables @code{doc-view-imenu-format} and
You can save the current page to a register with @kbd{m}
(@code{doc-view-page-to-register}) (@pxref{Registers}). However, these
registers are not shared across buffers and stay local to the DocView
buffer. You can later jump to the register with @kbd{'}
buffer. You can later jump to the saved page with @kbd{'}
(@code{doc-view-jump-to-register}).
@node DocView Searching

8
etc/NEWS
View file

@ -346,10 +346,10 @@ DocView now creates a dedicated buffer to display it. 'C-c C-c' gets you
back to real DocView buffer if it still exists.
+++
*** New commands to save and restore pages in buffer local registers.
Docview can store current page to buffer local registers with the new
command 'doc-view-page-to-register' (bound to 'm'), and later can be
restored with 'doc-view-jump-to-register' (bound to ''').
*** New commands to save and restore pages in buffer-local registers.
Docview can store current page to buffer-local registers with the new
command 'doc-view-page-to-register' (bound to 'm'), and later the stored
page can be restored with 'doc-view-jump-to-register' (bound to ''').
** Tramp

9
lisp/doc-view.el
View file

@ -2476,11 +2476,12 @@ See the command `doc-view-mode' for more information on this mode."
(defvar-local doc-view-register-alist nil
"Register alist containing only doc-view registers for current buffer.
Each doc-view register entry is of the form (doc-view . ALIST) where
ALIST has the keys `buffer', `file', and `page'. `buffer' is the buffer
the `file' is visiting. `page' is the page number to be show.")
ALIST has the keys `buffer', `file', and `page'. The value of `buffer'
is the buffer which visits the file specified by the value of `file'.
The value of `page' is the page stored in the register.")
(defun doc-view-page-to-register (register)
"Store the current page to the register REGISTER."
"Store the current page to the specified REGISTER."
(interactive
(let ((register-alist doc-view-register-alist))
(list (register-read-with-preview "Page to register: "))))
@ -2493,7 +2494,7 @@ the `file' is visiting. `page' is the page number to be show.")
(setq doc-view-register-alist register-alist)))
(defun doc-view-jump-to-register (register)
"Jump to the register REGISTER."
"Jump to the specified REGISTER."
(interactive
(let ((register-alist doc-view-register-alist))
(list (register-read-with-preview "Jump to register: "))))