[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] Changes to emacs/man/dired.texi,v
From: |
Chong Yidong |
Subject: |
[Emacs-diffs] Changes to emacs/man/dired.texi,v |
Date: |
Sun, 22 Apr 2007 13:56:11 +0000 |
CVSROOT: /sources/emacs
Module name: emacs
Changes by: Chong Yidong <cyd> 07/04/22 13:56:11
Index: dired.texi
===================================================================
RCS file: /sources/emacs/emacs/man/dired.texi,v
retrieving revision 1.62
retrieving revision 1.63
diff -u -b -r1.62 -r1.63
--- dired.texi 11 Apr 2007 20:57:52 -0000 1.62
+++ dired.texi 22 Apr 2007 13:56:11 -0000 1.63
@@ -44,6 +44,7 @@
* 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.
+* Image-Dired:: Viewing image thumbnails in Dired
* Misc: Misc Dired Features. Various other features.
@end menu
@@ -920,6 +921,9 @@
subdirectory's contents. Use @kbd{C-u k} on the subdirectory header
line to delete the subdirectory. @xref{Dired Updating}.
+
+
+
@ifnottex
@include dired-xtra.texi
@end ifnottex
@@ -1174,6 +1178,78 @@
world-writable. These changes also take effect when you type @kbd{C-c
C-c}.
address@hidden Image-Dired
address@hidden Viewing Image Thumbnails in Dired
address@hidden image-dired mode
address@hidden image-dired
+
+ Image-Dired is a facility for browsing image files. It provides viewing
+the images either as thumbnails or in full size, either inside Emacs
+or through an external viewer.
+
address@hidden C-t d @r{(Image-Dired)}
address@hidden image-dired-display-thumbs
+ To enter Image-Dired, mark the image files you want to look at in
+the Dired buffer, using @kbd{m} as usual. Then type @kbd{C-t d}
+(@code{image-dired-display-thumbs}). This creates and switches to a
+buffer containing image-dired, corresponding to the marked files.
+
+ You can also enter Image-Dired directly by typing @kbd{M-x
+image-dired}. This prompts for a directory; specify one that has
+images files. This creates thumbnails for all the images in that
+directory, and displays them all in the ``thumbnail buffer.'' This
+takes a long time if the directory contains many image files, and it
+asks for confirmation if the number of image files exceeds
address@hidden
+
+ With point in the thumbnail buffer, type @kbd{RET}
+(@code{image-dired-display-thumbnail-original-image}) to display a
+sized version of it in another window. This sizes the image to fit
+the window. Use the arrow keys to move around in the buffer. For
+easy browsing, type @kbd{SPC}
+(@code{image-dired-display-next-thumbnail-original}) to advance and
+display the next image. Typing @kbd{DEL}
+(@code{image-dired-display-previous-thumbnail-original}) backs up to
+the previous thumbnail and displays that instead.
+
address@hidden image-dired-external-viewer
+ To view and the image in its original size, either provide a prefix
+argument (@kbd{C-u}) before pressing @kbd{RET}, or type
address@hidden@key{RET}} (@code{image-dired-thumbnail-display-external}) to
+display the image in an external viewer. You must first configure
address@hidden
+
+ You can delete images through Image-Dired also. Type @kbd{d}
+(@code{image-dired-flag-thumb-original-file}) to flag the image file
+for deletion in the Dired buffer. You can also delete the thumbnail
+image from the thumbnail buffer with @kbd{C-d}
+(@code{image-dired-delete-char}).
+
+ More advanced features include @dfn{image tags}, which are metadata
+used to categorize image files. The tags are stored in a plain text
+file configured by @code{image-dired-db-file}.
+
+ To tag image files, mark them in the dired buffer (you can also mark
+files in Dired from the thumbnail buffer by typing @kbd{m}) and type
address@hidden t} (@code{image-dired-tag-files}). You will be prompted for
+a tag. To mark files having a certain tag, type @kbd{C-t f}
+(@code{image-dired-mark-tagged-files}). After marking image files
+with a certain tag, you can use @kbd{C-t d} to view them.
+
+ You can also tag a file directly from the thumbnail buffer by typing
address@hidden t} and you can remove a tag by typing @kbd{t r}. There is also
+a special ``tag'' called ``comment'' for each file (it is not a tag in
+the exact same sense as the other tags, it is handled slightly
+different). That is used to enter a comment or description about the
+image. You comment a file from the thumbnail buffer by typing
address@hidden You will be prompted for a comment. Type @kbd{C-t c} to add
+a comment from Dired (@code{image-dired-dired-comment-files}).
+
+ Image-Dired also provides simple image manipulation. 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. This
+rotation is lossless, and uses an external utility called JpegTRAN.
+
@node Misc Dired Features
@section Other Dired Features
- [Emacs-diffs] Changes to emacs/man/dired.texi,v, Karl Berry, 2007/04/11
- [Emacs-diffs] Changes to emacs/man/dired.texi,v,
Chong Yidong <=
- [Emacs-diffs] Changes to emacs/man/dired.texi,v, Karl Berry, 2007/04/25
- [Emacs-diffs] Changes to emacs/man/dired.texi,v, Karl Berry, 2007/04/28
- [Emacs-diffs] Changes to emacs/man/dired.texi,v, Glenn Morris, 2007/04/28