aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--doc/emacs/files.texi16
-rw-r--r--doc/emacs/misc.texi8
-rw-r--r--etc/NEWS47
-rw-r--r--lisp/doc-view.el16
-rw-r--r--lisp/image-mode.el6
5 files changed, 55 insertions, 38 deletions
diff --git a/doc/emacs/files.texi b/doc/emacs/files.texi
index 7318667403f..56ce7fdea19 100644
--- a/doc/emacs/files.texi
+++ b/doc/emacs/files.texi
@@ -2113,8 +2113,6 @@ point. Partial Completion mode offers other features extending
2113 2113
2114@findex image-mode 2114@findex image-mode
2115@findex image-toggle-display 2115@findex image-toggle-display
2116@findex image-next-file
2117@findex image-previous-file
2118@cindex images, viewing 2116@cindex images, viewing
2119 Visiting image files automatically selects Image mode. In this 2117 Visiting image files automatically selects Image mode. In this
2120major mode, you can type @kbd{C-c C-c} (@code{image-toggle-display}) 2118major mode, you can type @kbd{C-c C-c} (@code{image-toggle-display})
@@ -2136,6 +2134,19 @@ window, so this is only necessary if you customize the default
2136behavior by using the options @code{image-auto-resize} and 2134behavior by using the options @code{image-auto-resize} and
2137@code{image-auto-resize-on-window-resize}. 2135@code{image-auto-resize-on-window-resize}.
2138 2136
2137@findex image-transform-fit-both
2138@findex image-transform-set-scale
2139@findex image-transform-reset
2140To resize the image manually you can use the command
2141@code{image-transform-fit-both} bound to @kbd{s b}
2142that fits the image to both the window height and width.
2143To scale the image specifying a scale factor, use the command
2144@code{image-transform-set-scale} bound to @kbd{s s}.
2145To reset all transformations to the initial state, use
2146@code{image-transform-reset} bound to @kbd{s 0}.
2147
2148@findex image-next-file
2149@findex image-previous-file
2139You can press @kbd{n} (@code{image-next-file}) and @kbd{p} 2150You can press @kbd{n} (@code{image-next-file}) and @kbd{p}
2140(@code{image-previous-file}) to visit the next image file and the 2151(@code{image-previous-file}) to visit the next image file and the
2141previous image file in the same directory, respectively. 2152previous image file in the same directory, respectively.
@@ -2204,7 +2215,6 @@ can be used to transform the image in question to @acronym{PNG} before
2204displaying. GraphicsMagick, ImageMagick and @command{ffmpeg} are 2215displaying. GraphicsMagick, ImageMagick and @command{ffmpeg} are
2205currently supported for image conversions. 2216currently supported for image conversions.
2206 2217
2207
2208@findex thumbs-mode 2218@findex thumbs-mode
2209@cindex mode, Thumbs 2219@cindex mode, Thumbs
2210 The Image-Dired package can also be used to view images as 2220 The Image-Dired package can also be used to view images as
diff --git a/doc/emacs/misc.texi b/doc/emacs/misc.texi
index dceb8d3ca5b..47f195d0b20 100644
--- a/doc/emacs/misc.texi
+++ b/doc/emacs/misc.texi
@@ -617,12 +617,12 @@ of pages to display. A slice is a rectangle within the page area;
617once you specify a slice in DocView, it applies to whichever page you 617once you specify a slice in DocView, it applies to whichever page you
618look at. 618look at.
619 619
620 To specify the slice numerically, type @kbd{s s} 620 To specify the slice numerically, type @kbd{c s}
621(@code{doc-view-set-slice}); then enter the top left pixel position 621(@code{doc-view-set-slice}); then enter the top left pixel position
622and the slice's width and height. 622and the slice's width and height.
623@c ??? how does this work? 623@c ??? how does this work?
624 624
625 A more convenient graphical way to specify the slice is with @kbd{s 625 A more convenient graphical way to specify the slice is with @kbd{c
626m} (@code{doc-view-set-slice-using-mouse}), where you use the mouse to 626m} (@code{doc-view-set-slice-using-mouse}), where you use the mouse to
627select the slice. Simply press and hold the left mouse button at the 627select the slice. Simply press and hold the left mouse button at the
628upper-left corner of the region you want to have in the slice, then 628upper-left corner of the region you want to have in the slice, then
@@ -631,10 +631,10 @@ button.
631 631
632 The most convenient way is to set the optimal slice by using 632 The most convenient way is to set the optimal slice by using
633BoundingBox information automatically determined from the document by 633BoundingBox information automatically determined from the document by
634typing @kbd{s b} (@code{doc-view-set-slice-from-bounding-box}). 634typing @kbd{c b} (@code{doc-view-set-slice-from-bounding-box}).
635 635
636@findex doc-view-reset-slice 636@findex doc-view-reset-slice
637 To cancel the selected slice, type @kbd{s r} 637 To cancel the selected slice, type @kbd{c r}
638(@code{doc-view-reset-slice}). Then DocView shows the entire page 638(@code{doc-view-reset-slice}). Then DocView shows the entire page
639including its entire margins. 639including its entire margins.
640 640
diff --git a/etc/NEWS b/etc/NEWS
index 65ac6d2a2f3..1eb391f1350 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -866,6 +866,11 @@ its functions.
866*** A new user option 'doc-view-pdftotext-program-args' has been added 866*** A new user option 'doc-view-pdftotext-program-args' has been added
867to allow controlling how the conversion to text is done. 867to allow controlling how the conversion to text is done.
868 868
869+++
870*** The prefix key 's' was changed to 'c' for slicing commands
871to avoid conflicts with image-mode key 's'. The new key 'c' still
872has good mnemonics of "cut", "clip", "crop".
873
869** Ido 874** Ido
870 875
871--- 876---
@@ -3524,11 +3529,31 @@ functions.
3524according to the orientation in the Exif data, if any. 3529according to the orientation in the Exif data, if any.
3525 3530
3526+++ 3531+++
3532*** The command 'image-rotate' now accepts a prefix argument.
3533With a prefix argument, 'image-rotate' now rotates the image at point
353490 degrees counter-clockwise, instead of the default clockwise.
3535
3536+++
3527*** In 'image-mode' the image is resized automatically to fit in window. 3537*** In 'image-mode' the image is resized automatically to fit in window.
3528By default, the image will resize upon first display and whenever the 3538By default, the image will resize upon first display and whenever the
3529window's dimensions change. Two user options 'image-auto-resize' and 3539window's dimensions change. Two user options 'image-auto-resize' and
3530'image-auto-resize-on-window-resize' control the resizing behavior 3540'image-auto-resize-on-window-resize' control the resizing behavior
3531(including the possibility to disable auto-resizing). 3541(including the possibility to disable auto-resizing). A new key
3542prefix 's' contains the commands that can be used to fit the image to
3543the window manually.
3544
3545---
3546*** Some 'image-mode' variables are now buffer-local.
3547The image parameters 'image-transform-rotation',
3548'image-transform-scale' and 'image-transform-resize' are now declared
3549buffer-local, so each buffer could have its own values for these
3550parameters.
3551
3552+++
3553*** Three new 'image-mode' commands have been added: 'm', which marks
3554the file in the dired buffer(s) for the directory the file is in; 'u',
3555which unmarks the file; and 'w', which pushes the current buffer's file
3556name to the kill ring.
3532 3557
3533--- 3558---
3534*** New library image-converter. 3559*** New library image-converter.
@@ -3549,26 +3574,6 @@ These now default to using 'image-mode'.
3549some years back. It now respects 'imagemagick-types-inhibit' as a way 3574some years back. It now respects 'imagemagick-types-inhibit' as a way
3550to disable that. 3575to disable that.
3551 3576
3552---
3553*** Some 'image-mode' variables are now buffer-local.
3554The image parameters 'image-transform-rotation',
3555'image-transform-scale' and 'image-transform-resize' are now declared
3556buffer-local, so each buffer could have its own values for these
3557parameters.
3558
3559+++
3560*** Three new 'image-mode' commands have been added: 'm', which marks
3561the file in the dired buffer(s) for the directory the file is in; 'u',
3562which unmarks the file; and 'w', which pushes the current buffer's file
3563name to the kill ring.
3564
3565+++
3566*** The command 'image-rotate' now accepts a prefix argument.
3567With a prefix argument, 'image-rotate' now rotates the image at point
356890 degrees counter-clockwise, instead of the default clockwise.
3569
3570*** 'image-mode' has a new key prefix 's' for transformation commands.
3571
3572** Modules 3577** Modules
3573 3578
3574--- 3579---
diff --git a/lisp/doc-view.el b/lisp/doc-view.el
index 8dd0d93071e..714fdf8b088 100644
--- a/lisp/doc-view.el
+++ b/lisp/doc-view.el
@@ -59,16 +59,16 @@
59;; will be remembered and applied to all pages of the current 59;; will be remembered and applied to all pages of the current
60;; document. This enables you to cut away the margins of a document 60;; document. This enables you to cut away the margins of a document
61;; to save some space. To select a slice you can use 61;; to save some space. To select a slice you can use
62;; `doc-view-set-slice' (bound to `s s') which will query you for the 62;; `doc-view-set-slice' (bound to `c s') which will query you for the
63;; coordinates of the slice's top-left corner and its width and 63;; coordinates of the slice's top-left corner and its width and
64;; height. A much more convenient way to do the same is offered by 64;; height. A much more convenient way to do the same is offered by
65;; the command `doc-view-set-slice-using-mouse' (bound to `s m'). 65;; the command `doc-view-set-slice-using-mouse' (bound to `c m').
66;; After invocation you only have to press mouse-1 at the top-left 66;; After invocation you only have to press mouse-1 at the top-left
67;; corner and drag it to the bottom-right corner of the desired slice. 67;; corner and drag it to the bottom-right corner of the desired slice.
68;; Even more accurate and convenient is to use 68;; Even more accurate and convenient is to use
69;; `doc-view-set-slice-from-bounding-box' (bound to `s b') which uses 69;; `doc-view-set-slice-from-bounding-box' (bound to `c b') which uses
70;; the BoundingBox information of the current page to set an optimal 70;; the BoundingBox information of the current page to set an optimal
71;; slice. To reset the slice use `doc-view-reset-slice' (bound to `s 71;; slice. To reset the slice use `doc-view-reset-slice' (bound to `c
72;; r'). 72;; r').
73;; 73;;
74;; You can also search within the document. The command `doc-view-search' 74;; You can also search within the document. The command `doc-view-search'
@@ -433,10 +433,10 @@ Typically \"page-%s.png\".")
433 ;; Killing the buffer (and the process) 433 ;; Killing the buffer (and the process)
434 (define-key map (kbd "K") 'doc-view-kill-proc) 434 (define-key map (kbd "K") 'doc-view-kill-proc)
435 ;; Slicing the image 435 ;; Slicing the image
436 (define-key map (kbd "s s") 'doc-view-set-slice) 436 (define-key map (kbd "c s") 'doc-view-set-slice)
437 (define-key map (kbd "s m") 'doc-view-set-slice-using-mouse) 437 (define-key map (kbd "c m") 'doc-view-set-slice-using-mouse)
438 (define-key map (kbd "s b") 'doc-view-set-slice-from-bounding-box) 438 (define-key map (kbd "c b") 'doc-view-set-slice-from-bounding-box)
439 (define-key map (kbd "s r") 'doc-view-reset-slice) 439 (define-key map (kbd "c r") 'doc-view-reset-slice)
440 ;; Searching 440 ;; Searching
441 (define-key map (kbd "C-s") 'doc-view-search) 441 (define-key map (kbd "C-s") 'doc-view-search)
442 (define-key map (kbd "<find>") 'doc-view-search) 442 (define-key map (kbd "<find>") 'doc-view-search)
diff --git a/lisp/image-mode.el b/lisp/image-mode.el
index 6ce4e74c7ed..08f04f1d7fb 100644
--- a/lisp/image-mode.el
+++ b/lisp/image-mode.el
@@ -452,12 +452,12 @@ call."
452 452
453 ;; Transformation keys 453 ;; Transformation keys
454 (define-key map "sf" 'image-mode-fit-frame) 454 (define-key map "sf" 'image-mode-fit-frame)
455 (define-key map "sb" 'image-transform-fit-both)
456 (define-key map "sh" 'image-transform-fit-to-height) 455 (define-key map "sh" 'image-transform-fit-to-height)
457 (define-key map "sw" 'image-transform-fit-to-width) 456 (define-key map "sw" 'image-transform-fit-to-width)
457 (define-key map "sb" 'image-transform-fit-both)
458 (define-key map "ss" 'image-transform-set-scale)
458 (define-key map "sr" 'image-transform-set-rotation) 459 (define-key map "sr" 'image-transform-set-rotation)
459 (define-key map "s0" 'image-transform-reset) 460 (define-key map "s0" 'image-transform-reset)
460 (define-key map "ss" 'image-transform-set-scale)
461 461
462 ;; Multi-frame keys 462 ;; Multi-frame keys
463 (define-key map (kbd "RET") 'image-toggle-animation) 463 (define-key map (kbd "RET") 'image-toggle-animation)
@@ -512,6 +512,8 @@ call."
512 :help "Resize image to match the window width"] 512 :help "Resize image to match the window width"]
513 ["Fit to Window Height and Width" image-transform-fit-both 513 ["Fit to Window Height and Width" image-transform-fit-both
514 :help "Resize image to match the window height and width"] 514 :help "Resize image to match the window height and width"]
515 ["Set Scale..." image-transform-set-scale
516 :help "Resize image by specified scale factor"]
515 ["Rotate Image..." image-transform-set-rotation 517 ["Rotate Image..." image-transform-set-rotation
516 :help "Rotate the image"] 518 :help "Rotate the image"]
517 ["Reset Transformations" image-transform-reset 519 ["Reset Transformations" image-transform-reset