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

[finddup.git] / finddup.1

diff --git a/finddup.1 b/finddup.1
index 8a284ec..dbe9641 100644 (file)
--- a/finddup.1
+++ b/finddup.1
@@ -1,4 +1,4 @@
-.TH "FINDDUP" "1.1" "Apr 2010" "Francois Fleuret" "User Commands"
+.TH "FINDDUP" "1.2" "Apr 2011" "Francois Fleuret" "User Commands"
 
 \" This man page was written by Francois Fleuret <francois@fleuret.org>
 \" and is distributed under a Creative Commons Attribution-Share Alike
@@ -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
@@ -72,6 +76,11 @@ files with same inode are considered as different
 \fB-e \fI<command>\fR, \fB--exec \fI<command>\fR
 execute the provided command for each group of identical files, with
 their names as arguments
+.TP
+\fB-f \fI<string>\fR, \fB--result-prefix \fI<string>\fR
+for each group of identical files, write one result file whose name is
+the given prefix string followed by the group number, and containing
+one file name per line
 
 .SH "BUGS"
 
@@ -109,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