comparison man/dired.texi @ 68808:96e90465d41f

Added more documentation for tumme.

68807:7ba97c461db7

@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 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}
(@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

@cindex Adding to the kill ring in Dired.

68808:96e90465d41f

@node Tumme
@section Thumbnail and image file viewing and manipulation

@cindex tumme mode
  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.

  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 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.  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 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'' (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
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}).

  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.  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

@cindex Adding to the kill ring in Dired.