[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/dired-duplicates 3cdb20c714 6/7: Update README.org
|
From: |
ELPA Syncer |
|
Subject: |
[elpa] externals/dired-duplicates 3cdb20c714 6/7: Update README.org |
|
Date: |
Thu, 9 Nov 2023 09:57:41 -0500 (EST) |
branch: externals/dired-duplicates
commit 3cdb20c7140592eef72563b8025edf44c9ac34aa
Author: Harald Judt <h.judt@gmx.at>
Commit: Harald Judt <h.judt@gmx.at>
Update README.org
Signed-off-by: Harald Judt <h.judt@gmx.at>
---
README.org | 25 +++++++++++++++----------
1 file changed, 15 insertions(+), 10 deletions(-)
diff --git a/README.org b/README.org
index 1f1abd9d4e..8431514f42 100644
--- a/README.org
+++ b/README.org
@@ -3,9 +3,9 @@
* Description
This Emacs package helps to find duplicate files on local and remote
filesystems. It is similar to the fdupes command-line utility but written in
-Emacs Lisp and should also work on every remote filesystem that TRAMP supports
-and where executable commands can be called remotely. The most common use case
-for this is probably finding and deleting unneeded duplicate files.
+Emacs Lisp and should also work on every remote filesystem that TRAMP supports.
+The most common use case for this is probably finding and deleting unneeded
+duplicate files.
dired-duplicates works by first searching files of the same size, then invoking
the calculation of the checksum for these files, and finally presenting the
@@ -19,15 +19,20 @@ lines, but this grouping can also be deactivated by setting
the custom variable
* Requirements
For performance reasons, a checksum program like =md5= or =sha256sum= will be
-used for generating checksums of file contents and therefore needs to be
-available and executable on the local and/or remote hosts. That way, no files
-need to be read over possibly slow networks, thus calculating the checksum will
-be much faster when directly executed on remote hosts. The name of the
-checksum program can be customized.
+used for generating checksums of file contents if available and executable on
+the local and/or remote hosts. That way, no files need to be read over
+possibly slow networks, thus calculating the checksum will be much faster when
+directly executed on remote hosts. The name of the checksum program can be
+customized. If unavailable, the file contents will be inserted into a temp
+buffer and the checksum will be calculated using the =secure-hash= functions
+with an appropriate algorithm. While this works everywhere, it is generally
+slower and could cause out-of-memory problems so there is a customizable
+=dired-duplicates-internal-checksumming-size-limit= setting. Files bigger than
+this setting will not be processed, and a warning will be issued instead.
* Installation
-The package can be installed from MELPA via the Emacs package manager,
-e.g. ~package-install~. Or you use the following use-package snippet:
+The package can be installed from MELPA or GNU ELPA via the Emacs package
+manager, e.g. ~package-install~. Or you use the following use-package snippet:
#+BEGIN_SRC emacs-lisp
(use-package dired-duplicates)
#+END_SRC
- [elpa] externals/dired-duplicates updated (f821380a4f -> 349eebbd8b), ELPA Syncer, 2023/11/09
- [elpa] externals/dired-duplicates aa658b93d5 3/7: Always set the correct keymap as parent keymap, ELPA Syncer, 2023/11/09
- [elpa] externals/dired-duplicates 80a6243e01 1/7: Implement fallback to internal hashing function, ELPA Syncer, 2023/11/09
- [elpa] externals/dired-duplicates 349eebbd8b 7/7: Bump version to 0.2, ELPA Syncer, 2023/11/09
- [elpa] externals/dired-duplicates 2533a39dd9 4/7: Reorder assignment of the revert-buffer-function, ELPA Syncer, 2023/11/09
- [elpa] externals/dired-duplicates 9335c22d88 2/7: Do not truncate directory names in messages, ELPA Syncer, 2023/11/09
- [elpa] externals/dired-duplicates 3cdb20c714 6/7: Update README.org,
ELPA Syncer <=
- [elpa] externals/dired-duplicates 41492269b7 5/7: Prevent use of internal hash functions for files exceeding a certain limit, ELPA Syncer, 2023/11/09