From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Manuel Giraud via "Bug reports for GNU Emacs, the Swiss army knife of text editors" Newsgroups: gmane.emacs.bugs Subject: bug#61624: 30.0.50; [PATCH] More doc on image-dired-dired-* Date: Sun, 19 Feb 2023 12:37:25 +0100 Message-ID: <87edqlsx6y.fsf@ledu-giraud.fr> Reply-To: Manuel Giraud Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="18346"; mail-complaints-to="usenet@ciao.gmane.io" To: 61624@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sun Feb 19 12:38:26 2023 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1pTi1R-0004Zn-3i for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 19 Feb 2023 12:38:25 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1pTi17-0001xe-TQ; Sun, 19 Feb 2023 06:38:05 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1pTi16-0001xR-4F for bug-gnu-emacs@gnu.org; Sun, 19 Feb 2023 06:38:04 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1pTi14-00013g-J6 for bug-gnu-emacs@gnu.org; Sun, 19 Feb 2023 06:38:03 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1pTi14-00015k-1x for bug-gnu-emacs@gnu.org; Sun, 19 Feb 2023 06:38:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Manuel Giraud Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 19 Feb 2023 11:38:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 61624 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.16768066614159 (code B ref -1); Sun, 19 Feb 2023 11:38:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 19 Feb 2023 11:37:41 +0000 Original-Received: from localhost ([127.0.0.1]:45843 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pTi0i-000151-9s for submit@debbugs.gnu.org; Sun, 19 Feb 2023 06:37:41 -0500 Original-Received: from lists.gnu.org ([209.51.188.17]:37690) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pTi0f-00014p-H3 for submit@debbugs.gnu.org; Sun, 19 Feb 2023 06:37:38 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1pTi0e-0001uH-Vy for bug-gnu-emacs@gnu.org; Sun, 19 Feb 2023 06:37:37 -0500 Original-Received: from ledu-giraud.fr ([51.159.28.247]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1pTi0b-0000yU-Bi for bug-gnu-emacs@gnu.org; Sun, 19 Feb 2023 06:37:36 -0500 DKIM-Signature: v=1; a=ed25519-sha256; c=simple/simple; s=ed25519; bh=IfGY75xY Rj9U4534auveucy9tYI1OOqA1R0uqOCB7JA=; h=date:subject:to:from; d=ledu-giraud.fr; b=GM8uoJfwT5+YpmCrxx6Cqvl4evOuyzFfjZ9OrbgpQ28etwHpFR H02LU8kfCwFJM3LzPEj9I1r1pE2Hk8+Y5DAQ== DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; s=rsa; bh=IfGY75xYRj9U4534 auveucy9tYI1OOqA1R0uqOCB7JA=; h=date:subject:to:from; d=ledu-giraud.fr; b=okmAFWQHLpsSkk65wdPP/XTX/2ZAjgjzZRCw04wkrbdpbsvVaC wQykQlwj3CGSw2MOFrEBSB8LDOmLUPptomVgKHXJVv9p3opuYPggFiiZnDiAtYnM6G3XOI 0+UngrSTDewblERDnTjE024Rv2zqRq3QRF1KT9cHDS/Cyxr6ZCNMkdX5Ov+HLD3ZqwNW2T fGtS+Bcy5bhlI9SugfrWbqO8kp6iPtJ+IRJols6QvugHKEPdldGWGNhz4p6+yQmSzKBHIZ 1WFsf6tXxixeXBtAwmzYl/EqvLoMtXaXLXXVw7dWHeXxvJqBX1mJ25PMP/Pnl21mcjA9VM 2OZGon8tAmFw== Original-Received: from computer ( [10.1.1.1]) by ledu-giraud.fr (OpenSMTPD) with ESMTPSA id e9d1ed4e (TLSv1.3:TLS_AES_256_GCM_SHA384:256:NO); Sun, 19 Feb 2023 12:37:30 +0100 (CET) Received-SPF: pass client-ip=51.159.28.247; envelope-from=manuel@ledu-giraud.fr; helo=ledu-giraud.fr X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:256053 Archived-At: --=-=-= Content-Type: text/plain Hi, Here is more documentation on some image-dired-dired-* commands. --=-=-= Content-Type: text/x-patch Content-Disposition: attachment; filename=0001-More-doc-on-image-dired-dired.patch >From ff2109d7202ad2bbad00edd2a2ab21e4917ca7a3 Mon Sep 17 00:00:00 2001 From: Manuel Giraud Date: Sun, 19 Feb 2023 12:19:02 +0100 Subject: [PATCH] More doc on image-dired-dired-* * doc/emacs/dired.texi (Image-Dired): Some fix 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..fed8867387e 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 shortcuts 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,29 +1669,43 @@ 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 @dfn{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 into 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}. 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 -@kbd{C-t t} (@code{image-dired-tag-files}). This reads the tag name +@kbd{C- tt} (@code{image-dired-tag-files}). This reads the tag name in the minibuffer. 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. +@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 +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 --=-=-= Content-Type: text/plain In GNU Emacs 30.0.50 (build 1, x86_64-unknown-openbsd7.2, cairo version 1.17.8) of 2023-02-19 built on computer Repository revision: ff2109d7202ad2bbad00edd2a2ab21e4917ca7a3 Repository branch: mgi/image-dired-doc Windowing system distributor 'The X.Org Foundation', version 11.0.12101006 System Description: OpenBSD computer 7.2 GENERIC.MP#1052 amd64 Configured using: 'configure --prefix=/home/manuel/emacs --bindir=/home/manuel/bin --with-x-toolkit=no --without-sound --without-compress-install CPPFLAGS=-I/usr/local/include LDFLAGS=-L/usr/local/lib' Configured features: CAIRO DBUS FREETYPE GIF GLIB GMP GNUTLS GSETTINGS HARFBUZZ JPEG JSON LCMS2 LIBOTF LIBXML2 MODULES NOTIFY KQUEUE OLDXMENU PDUMPER PNG RSVG SQLITE3 THREADS TIFF TREE_SITTER WEBP X11 XDBE XIM XINPUT2 XPM ZLIB Important settings: value of $LC_ALL: en_US.UTF-8 locale-coding-system: utf-8-unix Major mode: Dired by name Minor modes in effect: global-git-commit-mode: t magit-auto-revert-mode: t gnus-dired-mode: t display-time-mode: t display-battery-mode: t server-mode: t shell-dirtrack-mode: t repeat-mode: t desktop-save-mode: t global-eldoc-mode: t show-paren-mode: t electric-indent-mode: t mouse-wheel-mode: t menu-bar-mode: t file-name-shadow-mode: t global-font-lock-mode: t font-lock-mode: t blink-cursor-mode: t buffer-read-only: t line-number-mode: t indent-tabs-mode: t transient-mark-mode: t auto-composition-mode: t auto-encryption-mode: t auto-compression-mode: t Load-path shadows: /home/manuel/.emacs.d/elpa/ef-themes-0.10.0/theme-loaddefs hides /home/manuel/emacs/share/emacs/30.0.50/lisp/theme-loaddefs /home/manuel/.emacs.d/elpa/transient-0.3.7/transient hides /home/manuel/emacs/share/emacs/30.0.50/lisp/transient Features: (shadow sort mail-extr emacsbug whitespace magit-extras magit-patch pulse face-remap magit-bookmark magit-submodule magit-obsolete magit-blame magit-stash magit-reflog magit-bisect magit-push magit-pull magit-fetch magit-clone magit-remote magit-commit magit-sequence magit-notes magit-worktree magit-tag magit-merge magit-branch magit-reset magit-files magit-refs magit-status magit magit-repos magit-apply magit-wip magit-log which-func magit-diff smerge-mode diff git-commit log-edit pcvs-util add-log magit-core magit-autorevert magit-margin magit-transient magit-process with-editor magit-mode transient magit-git magit-section magit-utils dash org-indent vc-dir ewoc vc mhtml-mode js c-ts-common reveal pascal vc-hg conf-mode css-mode sgml-mode facemenu imenu sh-script smie treesit executable oc-basic ol-eww eww url-queue mm-url ol-rmail ol-mhe ol-irc ol-info ol-gnus nnselect ol-docview doc-view jka-compr image-mode exif ol-bibtex bibtex ol-bbdb ol-w3m ol-doi org-link-doi paredit edmacro gnus-dired autorevert filenotify vc-git diff-mode bug-reference texinfo texinfo-loaddefs time battery exwm-randr xcb-randr exwm-config ido exwm exwm-input xcb-keysyms xcb-xkb exwm-manage exwm-floating xcb-cursor xcb-render exwm-layout exwm-workspace exwm-core xcb-ewmh xcb-icccm xcb xcb-xproto xcb-types xcb-debug kmacro server stimmung-themes modus-operandi-theme modus-themes ytdious osm bookmark mingus libmpdee reporter edebug debug backtrace transmission color calc-bin calc-ext calc calc-loaddefs rect calc-macs w3m-load supercite regi ebdb-message ebdb-gnus gnus-msg gnus-art mm-uu mml2015 mm-view mml-smime smime gnutls dig gnus-sum shr pixel-fill kinsoku url-file svg dom gnus-group gnus-undo gnus-start gnus-dbus gnus-cloud nnimap nnmail mail-source utf7 nnoo gnus-spec gnus-int gnus-range message sendmail yank-media puny rfc822 mml mml-sec epa epg rfc6068 epg-config mm-decode mm-bodies mm-encode mail-parse rfc2231 rfc2047 rfc2045 ietf-drums gmm-utils mailheader gnus-win gnus nnheader gnus-util mail-utils range mm-util mail-prsvr ebdb-mua ebdb-com crm ebdb-format ebdb mailabbrev eieio-opt cl-extra help-mode speedbar ezimage dframe eieio-base pcase timezone visual-basic-mode cl web-mode derived disp-table erlang-start smart-tabs-mode skeleton cc-mode cc-fonts cc-guess cc-menus cc-cmds cc-styles cc-align cc-engine cc-vars cc-defs slime-asdf grep slime-tramp tramp tramp-loaddefs trampver tramp-integration cus-edit cus-load wid-edit files-x tramp-compat shell parse-time iso8601 ls-lisp slime-fancy slime-indentation slime-cl-indent cl-indent slime-trace-dialog slime-fontifying-fu slime-package-fu slime-references slime-compiler-notes-tree advice slime-scratch slime-presentations bridge slime-macrostep macrostep slime-mdot-fu slime-enclosing-context slime-fuzzy slime-fancy-trace slime-fancy-inspector slime-c-p-c slime-editing-commands slime-autodoc slime-repl slime-parse slime apropos compile text-property-search etags fileloop xref project arc-mode archive-mode pp hyperspec thingatpt slime-autoloads org-agenda org-element org-persist xdg org-id avl-tree generator org-refile org ob ob-tangle ob-ref ob-lob ob-table ob-exp org-macro org-src ob-comint org-pcomplete pcomplete comint ansi-osc ansi-color ring org-list org-footnote org-faces org-entities time-date noutline outline icons ob-emacs-lisp ob-core ob-eval org-cycle org-table org-keys oc org-loaddefs find-func ol rx org-fold org-fold-core org-compat org-version org-macs format-spec view mule-util cal-china lunar solar cal-dst cal-bahai cal-islam cal-hebrew holidays holiday-loaddefs vc-dispatcher vc-svn appt diary-lib diary-loaddefs cal-menu calendar cal-loaddefs dired-aux dired-x dired dired-loaddefs notifications dbus xml repeat easy-mmode desktop frameset stimmung-themes-autoloads rust-mode-autoloads ebdb-autoloads magit-autoloads debbugs-autoloads git-commit-autoloads magit-section-autoloads ef-themes-autoloads with-editor-autoloads paredit-autoloads dash-autoloads ytdious-autoloads transmission-autoloads transient-autoloads exwm-autoloads hyperbole-autoloads detached-autoloads info package browse-url url url-proxy url-privacy url-expand url-methods url-history url-cookie generate-lisp-file url-domsuf url-util mailcap url-handlers url-parse auth-source cl-seq eieio eieio-core cl-macs password-cache json subr-x map byte-opt gv bytecomp byte-compile url-vars cl-loaddefs cl-lib rmc iso-transl tooltip cconv eldoc paren electric uniquify ediff-hook vc-hooks lisp-float-type elisp-mode mwheel term/x-win x-win term/common-win x-dnd tool-bar dnd fontset image regexp-opt fringe tabulated-list replace newcomment text-mode lisp-mode prog-mode register page tab-bar menu-bar rfn-eshadow isearch easymenu timer select scroll-bar mouse jit-lock font-lock syntax font-core term/tty-colors frame minibuffer nadvice seq simple cl-generic indonesian philippine cham georgian utf-8-lang misc-lang vietnamese tibetan thai tai-viet lao korean japanese eucjp-ms cp51932 hebrew greek romanian slovak czech european ethiopic indian cyrillic chinese composite emoji-zwj charscript charprop case-table epa-hook jka-cmpr-hook help abbrev obarray oclosure cl-preloaded button loaddefs theme-loaddefs faces cus-face macroexp files window text-properties overlay sha1 md5 base64 format env code-pages mule custom widget keymap hashtable-print-readable backquote threads dbusbind kqueue lcms2 dynamic-setting system-font-setting font-render-setting cairo xinput2 x multi-tty make-network-process emacs) Memory information: ((conses 16 739117 59159) (symbols 48 58769 2) (strings 32 193263 13383) (string-bytes 1 6191582) (vectors 16 112218) (vector-slots 8 2243696 120250) (floats 8 1056 393) (intervals 56 16282 427) (buffers 984 104)) -- Manuel Giraud --=-=-=--