bug#61624: 30.0.50; [PATCH] More doc on image-dired-dired-*

[Stefan Kangas]

Manuel Giraud via "Bug reports for GNU Emacs, the Swiss army knife of
text editors" <bug-gnu-emacs@gnu.org> writes:

> +@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}).

I'm not sure that the comment/tag features are worth the space in the
Emacs manual, but I won't protest if there's a demand for it.  (I don't
use them myself, so I might be biased here.)

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

To my mind, it makes sense to use two different words, because it
clarifies the difference between the two types of operations slightly.