aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorChong Yidong2007-04-22 13:58:31 +0000
committerChong Yidong2007-04-22 13:58:31 +0000
commit8e5220efda3b43f8fac060be6bbadf42bb55009e (patch)
tree2dd2324a33aaa3bbe82e22ca9720b75bd48ea992
parent191aba93b466d952ac66a73ced832017db03bba9 (diff)
downloademacs-8e5220efda3b43f8fac060be6bbadf42bb55009e.tar.gz
emacs-8e5220efda3b43f8fac060be6bbadf42bb55009e.zip
(Thumbnails): Node moved to Image-Dired.
-rw-r--r--man/misc.texi73
1 files changed, 2 insertions, 71 deletions
diff --git a/man/misc.texi b/man/misc.texi
index a2c62d0dd2a..c4cdea4359d 100644
--- a/man/misc.texi
+++ b/man/misc.texi
@@ -2235,7 +2235,7 @@ not use it.
2235key bindings. 2235key bindings.
2236@end table 2236@end table
2237 2237
2238@node Hyperlinking, Thumbnails, Emulation, Top 2238@node Hyperlinking, Dissociated Press, Emulation, Top
2239@section Hyperlinking and Navigation Features 2239@section Hyperlinking and Navigation Features
2240 2240
2241@cindex hyperlinking 2241@cindex hyperlinking
@@ -2401,76 +2401,7 @@ Display a menu of files and URLs mentioned in current buffer, then
2401find the one you select (@code{ffap-menu}). 2401find the one you select (@code{ffap-menu}).
2402@end table 2402@end table
2403 2403
2404@node Thumbnails, Dissociated Press, Hyperlinking, Top 2404@node Dissociated Press, Amusements, Hyperlinking, Top
2405@section Viewing Images as Thumbnails
2406@cindex thumbnails mode
2407@cindex thumbnails
2408
2409 Thumbnails is a facility for browsing image files. It provides viewing
2410the images either as thumbnails or in full size, either inside Emacs
2411or through an external viewer.
2412
2413 To enter Thumbnails, type @kbd{M-x thumbnails}. It prompts for a directory;
2414specify one that has images files. This creates thumbnails for all
2415the images in that directory, and displays them all in the ``thumbnail
2416buffer.'' This takes a long time if the directory contains many image
2417files, and it asks for confirmation if the number of image files
2418exceeds @code{thumbnails-show-all-from-dir-max-files}.
2419
2420@kindex C-t d @r{(Thumbnails)}
2421@findex thumbnails-display-thumbs
2422 You can also enter Thumbnails through Dired. Mark the image files you
2423want to look at, using @kbd{m} as usual, then type @kbd{C-t d}
2424(@code{thumbnails-display-thumbs}). This too creates and switches to
2425a buffer containing thumbnails, corresponding to the marked files.
2426
2427 With point in the thumbnail buffer, type @kbd{RET}
2428(@code{thumbnails-display-thumbnail-original-image}) to display a sized
2429version of it in another window. This sizes the image to fit the
2430window. Use the arrow keys to move around in the buffer. For easy
2431browsing, type @kbd{SPC} (@code{thumbnails-display-next-thumbnail-original})
2432to advance and display the next image. Typing @kbd{DEL}
2433(@code{thumbnails-display-previous-thumbnail-original}) backs up to the
2434previous thumbnail and displays that instead.
2435
2436@vindex thumbnails-external-viewer
2437 To view and the image in its original size, either provide a prefix
2438argument (@kbd{C-u}) before pressing @kbd{RET}, or type @kbd{C-@key{RET}}
2439(@code{thumbnails-thumbnail-display-external}) to display the image in an
2440external viewer. You must first configure
2441@code{thumbnails-external-viewer}.
2442
2443 You can delete images through Thumbnails also. Type @kbd{d}
2444(@code{thumbnails-flag-thumb-original-file}) to flag the image file for
2445deletion in the Dired buffer. You can also delete the thumbnail image
2446from the thumbnail buffer with @kbd{C-d} (@code{thumbnails-delete-char}).
2447
2448 More advanced features include @dfn{image tags}, which are metadata
2449used to categorize image files. The tags are stored in a plain text
2450file configured by @code{thumbnails-db-file}.
2451
2452 To tag image files, mark them in the dired buffer (you can also mark
2453files in Dired from the thumbnail buffer by typing @kbd{m}) and type
2454@kbd{C-t t} (@code{thumbnails-tag-files}). You will be prompted for a tag.
2455To mark files having a certain tag, type @kbd{C-t f}
2456(@code{thumbnails-mark-tagged-files}). After marking image files with a
2457certain tag, you can use @kbd{C-t d} to view them.
2458
2459 You can also tag a file directly from the thumbnail buffer by typing
2460@kbd{t t} and you can remove a tag by typing @kbd{t r}. There is also
2461a special ``tag'' called ``comment'' for each file (it is not a tag in
2462the exact same sense as the other tags, it is handled slightly
2463different). That is used to enter a comment or description about the
2464image. You comment a file from the thumbnail buffer by typing
2465@kbd{c}. You will be prompted for a comment. Type @kbd{C-t c} to add
2466a comment from Dired (@code{thumbnails-dired-comment-files}).
2467
2468 Thumbnails also provides simple image manipulation. In the thumbnail
2469buffer, type @kbd{L} to rotate the original image 90 degrees anti
2470clockwise, and @kbd{R} to rotate it 90 degrees clockwise. This
2471rotation is lossless, and uses an external utility called JpegTRAN.
2472
2473@node Dissociated Press, Amusements, Thumbnails, Top
2474@section Dissociated Press 2405@section Dissociated Press
2475 2406
2476@findex dissociated-press 2407@findex dissociated-press