From d5905ab9153b05107c63731053cf97681d4c61e7 Mon Sep 17 00:00:00 2001 From: Mathias Dahl Date: Thu, 9 Feb 2006 00:02:11 +0000 Subject: [PATCH] Tumme documentation. --- man/ChangeLog | 4 ++++ man/dired.texi | 48 ++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 52 insertions(+) diff --git a/man/ChangeLog b/man/ChangeLog index 4f93bc48498..e5ebb72c2c5 100644 --- a/man/ChangeLog +++ b/man/ChangeLog @@ -1,3 +1,7 @@ +2006-02-09 Mathias Dahl + + * dired.texi (Tumme): Basic documentation for Tumme added. + 2006-02-08 Romain Francoise * faq.texi (Top): Remove paragraph about the FAQ being a diff --git a/man/dired.texi b/man/dired.texi index a432d681918..be733f9924d 100644 --- a/man/dired.texi +++ b/man/dired.texi @@ -40,6 +40,8 @@ files. * Updating: Dired Updating. Discarding lines for files of no interest. * Find: Dired and Find. Using `find' to choose the files for Dired. * Wdired:: Operating on files by editing the Dired buffer. +* Tumme:: Image file and thumbnail viewing and + manipulation from the Dired buffer. * Misc: Misc Dired Features. Various other features. @end menu @@ -1140,6 +1142,52 @@ you can change @samp{-rw-r--r--} to @samp{-rw-rw-rw-} to make a file world-writable. These changes also take effect when you type @kbd{C-c C-c}. +@node Tumme +@section Thumbnail and image file viewing and manipulation + +@cindex tumme mode + Tumme provides for simple viewing of thumbnails if image files. It +also provides viewing of the original file, sized or in full size, +inside Emacs or in an external viewer. + + Tumme aims to be both easy to use for a beginner but also powerful +and useful for an experienced user. + + To try out Tumme, mark some image files in Dired and type @kbd{C-t +d} (@code{tumme-display-thumbs}). With point in the thumbnail buffer, +type @kbd{RET} (@code{tumme-display-thumbnail-original-image}) to +display a sized version of it. Use the keys to move around in the +buffer. For easy browing, type @kbd{SPC} +(@code{tumme-display-next-thumbnail-original}) to advance and display +the next image. Typing @kbd{SPC} +(@code{tumme-display-previous-thumbnail-original}) backs up to the +previous thumbnail and displays the image. + + If you want to see the image in its original size, either provide a +prefix argument (@kbd{C-u}) before pressing @kbd{RET}, or type +@kbd{C-return} (@code{tumme-thumbnail-display-external}) to display +the image in an external viewer. + + If you find in image that you want to delete, type @kbd{d} +(@code{tumme-flag-thumb-original-file}) and the file will be flagged +for deletion in the dired buffer. If you just want to delete the +thumbnail image from the thumbnail buffer, type @kbd{C-d} +(@code{tumme-delete-char}). + + More advanced features include commands for using ``tags'' (labels, +or categories) to tag image files and to search for image files with a +certain tag. + + The tags put on image files are stored in a database file and can be +used for marking image files. For example, you can let Tumme mark all +files in the current directory tagged with the tag `flowers'. To tag +image files, mark them in the dired buffer and type @kbd{C-t t} +(@code{tumme-tag-files}). To mark files having a certain tag, type +@kbd{C-t f} (@code{tumme-mark-tagged-files}). + + Tumme also provide simple image manipulation commands, like rotating +thumbnails and original image files. + @node Misc Dired Features @section Other Dired Features -- 2.39.2