fdupes-1.11

CONTRIBUTORS

@@ -0,0 +1,5 @@
+Adrian Bridgett <[email protected]>:
+   - provided the original version of the fdupes manpage
+   - suggested comparing file sizes before calling
+     md5sum program (big performance boost)
+

Makefile

@@ -1,5 +1,6 @@
 INSTALLDIR = /usr/local/bin
-VERSION = 1.1
+MANPAGEDIR = /usr/man
+VERSION = 1.11
 
 fdupes: fdupes.c
 	gcc fdupes.c -o fdupes -DVERSION=\"$(VERSION)\"
@@ -9,6 +10,7 @@ test: fdupes
 
 install: fdupes
 	cp fdupes $(INSTALLDIR)
+	cp fdupes.1 $(MANPAGEDIR)/man1
 
 tarball: clean
 	tar --directory=.. -c -z -v -f ../fdupes-$(VERSION).tar.gz fdupes
@@ -18,3 +20,5 @@ clean:
 	rm -f fdupes
 	rm -f *~
 
+love:
+	@echo You\'re not my type. Go find a human partner.

README

@@ -6,7 +6,7 @@ within specified directories.
 
 Usage
 --------------------------------------------------------------------
-Usage: fdupes [options] <DIRECTORY> [DIRECTORY]...
+Usage: fdupes [options] DIRECTORY...
 
  -r --recurse	include files residing in subdirectories
  -q --quiet  	hide progress indicator
@@ -25,15 +25,14 @@ groups are then separated from each other by blank lines.
 
 When using -d or --delete, care should be taken to insure against
 accidental data loss. While no information will be immediately
-lost, using the -s or --symlink option or specifying a certain 
-directory more than once can lead to confusing information
-being presented to the user when prompted for files to preserve.
-When using options -s or --symlyink, a user could accidentally 
-preserve a symlink while deleting the file it points to.
-Furthermore, when specifying a particular directory more than
-once, all files within that directory will be listed as their 
-own duplicates, leading to data loss should a user preserve a 
-file without its "duplicate" (the file itself!).
+lost, using this option together with -s or --symlink can lead 
+to confusing information being presented to the user when prompted
+for files to preserve. Specifically, a user could accidentally
+preserve a symlink while deleting the file it points to. A similar
+problem arises when specifying a particular directory more than 
+once. All files within that directory will be listed as their own
+duplicates, leading to data loss should a user preserve a file 
+without its "duplicate" (the file itself!).
 
 
 Requirements

fdupes.1

@@ -0,0 +1,76 @@
+.TH FDUPES 1
+.\" NAME should be all caps, SECTION should be 1-8, maybe w/ subsection
+.\" other parms are allowed: see man(7), man(1)
+.SH NAME
+fdupes \- finds duplicate files in a given set of directories
+.SH SYNOPSIS
+.B fdupes
+[
+.I options
+]
+.I DIRECTORY
+\|.\|.\|.
+
+.SH "DESCRIPTION"
+Searches the given path for duplicate files. Such files are found by
+comparing
+.BR md5sum (1)
+checksums and then a byte-by-byte comparison.
+
+.SH OPTIONS
+.TP
+.B -r --recurse
+include files residing in subdirectories
+.TP
+.B -q --quiet
+hide progress indicator
+.TP
+.B -1 --sameline
+list duplicates on a single line
+.TP
+.B -s --symlinks
+follow symlinked directories
+.TP
+.B -d --delete
+prompt user for files to preserve, deleting all others (see
+.B CAVEATS
+below)
+.TP
+.B -v --version
+display fdupes version
+.TP
+.B -h --help
+displays help
+.SH "SEE ALSO"
+.\" Always quote multiple words for .SH
+.BR md5sum (1)
+.SH NOTES
+Unless
+.B -1
+or
+.B --sameline
+is specified, duplicate files are listed
+together in groups, each file displayed on a separate line. The
+groups are then separated from each other by blank lines.
+.SH CAVEATS
+When using
+.B \-d
+or
+.BR \-\-delete ,
+care should be taken to insure against
+accidental data loss.
+
+When used together with options
+.B \-s
+or
+.BR \-\-symlink ,
+a user could accidentally
+preserve a symlink while deleting the file it points to.
+
+Furthermore, when specifying a particular directory more than
+once, all files within that directory will be listed as their
+own duplicates, leading to data loss should a user preserve a
+file without its "duplicate" (the file itself!).
+.SH AUTHOR
+Adrian Lopez <[email protected]>
+