From a528b71e55b2b244a5dd35318713ccb20398cbbf Mon Sep 17 00:00:00 2001 From: Mathias Dahl Date: Sat, 11 Feb 2006 22:17:36 +0000 Subject: [PATCH] Added more documentation for tumme. --- man/dired.texi | 62 +++++++++++++++++++++++++++++++++++--------------- 1 file changed, 44 insertions(+), 18 deletions(-) diff --git a/man/dired.texi b/man/dired.texi index 21cce9f378..d391e4566f 100644 --- a/man/dired.texi +++ b/man/dired.texi @@ -1146,37 +1146,56 @@ C-c}. @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 provides for simple viewing of thumbnails of image files. It +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 to 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{DEL} + The quickest way to try out Tumme is to use the command +@code{tumme}. It will prompt for a directory where there are images +files. All images in that directory will get thumbnail files created +for them, and the thumbnails will be displayed in the ``thumbnail +buffer''. + + Because thumbnails are created on the fly and before they can be +displayed, the above command might take a long time, especially the +first time, if the directory contains many image files. If the number +of image files is higher than +@code{tumme-show-all-from-dir-max-files}, the command will be aborted. +To work around this you can instead mark the files you want to look +at, using @kbd{m} as usual in Dired, and then type @kbd{C-t d} +(@code{tumme-display-thumbs}). + + Regardless of which command you chose to display the thumbnails, a +new buffer will open up, displaying thumbnail images of the files that +were marked in dired. The new buffer will be the active one. + + With point in the thumbnail buffer, type @kbd{RET} +(@code{tumme-display-thumbnail-original-image}) to display a sized +version of it in another window. The image will be sized to fit the +window. Use the arrow 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{DEL} (@code{tumme-display-previous-thumbnail-original}) backs up to the -previous thumbnail and displays the image. +previous thumbnail and displays that instead. 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. +the image in an external viewer. To use the latter, +@code{tumme-external-viewer} must be configured. 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} +for deletion in the dired buffer. If you just want visually 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. + More advanced features include commands for using ``tags'' (another +name for ``keyword'' or ``label'') 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 @@ -1185,8 +1204,15 @@ 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}). + After marking image files with a certain tag, they can be viewed as +explained earlier, by typing @key{C-t d}. + Tumme also provide simple image manipulation commands, like rotating -thumbnails and original image files. +thumbnails and original image files. In the thumbnail buffer, type +@kbd{L} to rotate the original image 90 degrees anti clockwise, and +@kbd{R} to rotate it 90 degrees clockwise. + + @node Misc Dired Features @section Other Dired Features -- 2.20.1