From: Manuel Giraud via "Bug reports for GNU Emacs, the Swiss army knife of text editors" <bug-gnu-emacs@gnu.org>
To: Eli Zaretskii <eliz@gnu.org>
Cc: 61624@debbugs.gnu.org
Subject: bug#61624: 30.0.50; [PATCH] More doc on image-dired-dired-*
Date: Sun, 19 Feb 2023 14:16:34 +0100 [thread overview]
Message-ID: <87a619sslp.fsf@ledu-giraud.fr> (raw)
In-Reply-To: <83y1otx3m4.fsf@gnu.org> (Eli Zaretskii's message of "Sun, 19 Feb 2023 14:05:07 +0200")
[-- Attachment #1: Type: text/plain, Size: 141 bytes --]
Eli Zaretskii <eliz@gnu.org> writes:
> Thanks. I have a few comments:
Hi Eli,
Here is a new version that adresses most of your comments.
[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: 0001-More-doc-on-image-dired-dired-bug-61624.patch --]
[-- Type: text/x-patch, Size: 3987 bytes --]
From ecfd819be00aaeb04171df0858752ae55ac1333b Mon Sep 17 00:00:00 2001
From: Manuel Giraud <manuel@ledu-giraud.fr>
Date: Sun, 19 Feb 2023 12:19:02 +0100
Subject: [PATCH] More doc on image-dired-dired-* (bug#61624)
* doc/emacs/dired.texi (Image-Dired): Some fixes and more
documentation about image-dired-dired-* commands.
---
doc/emacs/dired.texi | 36 +++++++++++++++++++++++++-----------
1 file changed, 25 insertions(+), 11 deletions(-)
diff --git a/doc/emacs/dired.texi b/doc/emacs/dired.texi
index cae8207990e..d78443271b6 100644
--- a/doc/emacs/dired.texi
+++ b/doc/emacs/dired.texi
@@ -1655,11 +1655,11 @@ Image-Dired
@findex image-dired-display-previous
With point in the thumbnail buffer, you can type @key{RET}
(@code{image-dired-display-this}) to display the image in another
-window. Use the arrow keys to move around in the thumbnail buffer.
-For easy browsing, use @key{SPC} (@code{image-dired-display-next}) to
-advance and display the next image. Typing @key{DEL}
-(@code{image-dired-display-previous}) backs up to the previous
-thumbnail and displays that instead.
+window. Use the standard Emacs movement key bindings or the arrow
+keys to move around in the thumbnail buffer. For easy browsing, use
+@key{SPC} (@code{image-dired-display-next}) to advance and display the
+next image. Typing @key{DEL} (@code{image-dired-display-previous})
+backs up to the previous thumbnail and displays that instead.
@vindex image-dired-external-viewer
Type @kbd{C-@key{RET}}
@@ -1669,10 +1669,20 @@ Image-Dired
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
+for deletion in the Dired buffer. You can also remove the thumbnail
image from the thumbnail buffer with @kbd{C-d}
(@code{image-dired-delete-char}).
+@findex image-dired-dired-toggle-marked-thumbs
+@findex image-dired-dired-display-external
+@findex image-dired-dired-display-image
+ You could also use Image-Dired for ``inline'' operations (i.e.,
+right into the Dired buffer). Type @kbd{C-t C-t}, and the thumbnails
+of the selected images in Dired will appear in front of their names
+(@code{image-dired-dired-toggle-marked-thumbs}). @kbd{C-t i} and
+@kbd{C-t x} will display the image under the point in Emacs or with
+the external viewer, respectively.
+
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-tags-db-file}.
@@ -1684,14 +1694,18 @@ Image-Dired
(@code{image-dired-mark-tagged-files}). After marking image files
with a certain tag, you can use @kbd{C-t d} to view them.
+@findex image-dired-dired-comment-files
+@findex image-dired-dired-edit-comment-and-tags
You can also tag a file directly from the thumbnail buffer by typing
-@kbd{t 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
-differently). That is used to enter a comment or description about the
-image. You comment a file from the thumbnail buffer by typing
+@kbd{t 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
+differently). That is used to enter a comment or description about
+the image. You comment a file from the thumbnail buffer by typing
@kbd{c}. You will be prompted for a comment. Type @kbd{C-t c} to add
a comment from Dired (@code{image-dired-dired-comment-files}).
+@kbd{C-t e} will bring a buffer to edit comment and tags
+(@code{image-dired-dired-edit-comment-and-tags}).
@vindex image-dired-thumb-visible-marks
Files that are marked in Dired will also be marked in Image-Dired if
--
2.39.1
[-- Attachment #3: Type: text/plain, Size: 765 bytes --]
[...]
>> 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
>> +for deletion in the Dired buffer. You can also remove the thumbnail
>> image from the thumbnail buffer with @kbd{C-d}
>> (@code{image-dired-delete-char}).
>
> Not sure I understand the reason for this. "Deletion" goes together
> with "delete", so why use "remove" instead?
You're right that it goes with "delete" from the command name but I
thought that "remove" is better because no file is deleted from this
operation. Only the thumbnail is removed from the thumbnails buffer.
Maybe my english is a bit off here.
--
Manuel Giraud
next prev parent reply other threads:[~2023-02-19 13:16 UTC|newest]
Thread overview: 10+ messages / expand[flat|nested] mbox.gz Atom feed top
2023-02-19 11:37 bug#61624: 30.0.50; [PATCH] More doc on image-dired-dired-* Manuel Giraud via Bug reports for GNU Emacs, the Swiss army knife of text editors
2023-02-19 12:05 ` Eli Zaretskii
2023-02-19 13:16 ` Manuel Giraud via Bug reports for GNU Emacs, the Swiss army knife of text editors [this message]
2023-02-19 13:36 ` Eli Zaretskii
2023-02-19 13:59 ` Manuel Giraud via Bug reports for GNU Emacs, the Swiss army knife of text editors
2023-02-19 15:10 ` Eli Zaretskii
2023-02-19 13:45 ` Stefan Kangas
2023-02-19 14:01 ` Manuel Giraud via Bug reports for GNU Emacs, the Swiss army knife of text editors
2023-02-19 15:15 ` Eli Zaretskii
2023-02-19 16:29 ` Stefan Kangas
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=87a619sslp.fsf@ledu-giraud.fr \
--to=bug-gnu-emacs@gnu.org \
--cc=61624@debbugs.gnu.org \
--cc=eliz@gnu.org \
--cc=manuel@ledu-giraud.fr \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.