Added a clarification when passing files instead of directories as arguments.

[finddup.git] / finddup.1

diff --git a/finddup.1 b/finddup.1
index 7eb9b76..dbe9641 100644 (file)
--- a/finddup.1
+++ b/finddup.1
@@ -10,7 +10,7 @@ finddup \- Find files common to two directories (or not)
 
 .SH "SYNOPSIS"
 
-\fBfinddup\fP [OPTION]... [DIR1 [[and:|not:]DIR2]]
+\fBfinddup\fP [OPTION]... [DIR-OR-FILE1 [[and:|not:]DIR-OR-FILE2]]
 
 .SH "DESCRIPTION"
 
@@ -21,7 +21,8 @@ one as default.
 With two directories, it prints either the files common to both DIR1
 and DIR2 or, with the `not:' prefix, the ones present in DIR1 and not
 in DIR2. The `and:' prefix is assumed by default and necessary only if
-you have a directory name starting with `not:'.
+you have a directory name starting with `not:'. Files are handled like
+directories containing a single file.
 
 This command compares files by first comparing their sizes, hence goes
 reasonably fast.
@@ -60,6 +61,9 @@ do not show the file group IDs
 \fB-t\fR, \fB--time-sort\fR
 sort files in each group according to the modification times
 .TP
+\fB-q\fR, \fB--trim-first\fR
+do not print the first file in each group
+.TP
 \fB-p\fR, \fB--show-progress\fR
 show progress information in stderr
 .TP
@@ -114,6 +118,14 @@ List duplicated files in directory ./blah/, show a progress bar,
 ignore empty files, and ignore files and directories starting with a
 dot.
 
+.B finddup -qtg
+
+.fi
+List all files which are duplicated in the current directory, do not
+show the oldest in each each group of identical ones, and do not show
+group numbers. This is what you could use to list what files to
+remove.
+
 .P
 .B finddup sources not:/mnt/backup