arsenetar/dupeguru
1
0
Fork 0
mirror of https://github.com/arsenetar/dupeguru.git synced 2026-01-22 14:41:39 +00:00
Code Releases Wiki Activity

[#130 state:fixed] Converted help file to Sphinx.

Browse Source 
--HG--
rename : help_me/CHANGELOG => help/changelog_me
rename : help_pe/CHANGELOG => help/changelog_pe
rename : help_se/CHANGELOG => help/changelog_se
This commit is contained in:
Virgil Dupras
2011-01-12 17:30:57 +01:00
parent 94104f4e03
commit d139157234
51 changed files with 587 additions and 1008 deletions
Download Patch File Download Diff File Expand all files Collapse all files

589
help/changelog_me Normal file
View File

@@ -0,0 +1,589 @@
=== 5.10.4 (2010-12-30)
* Fixed bug causing results to be corrupted after a scan cancellation. (#120)
* Fixed crash when fetching Fairware unpaid hours. (#121)
* Fixed crash when replacing files with hardlinks. (#122)
* Fixed crash when reading malformed aiff files. (#123)
=== 5.10.3 (2010-11-21)
* Fixed crash when reading malformed mp4 files. (#117 #118)
=== 5.10.2 (2010-10-06)
* Fixed delta column colors which were broken since 5.10.0.
* Fixed column sorting crash. (#108)
* Fixed occasional crash during scan. (#106)
=== 5.10.1 (2010-09-30)
* Re-licensed dupeGuru to BSD and made it `Fairware <http://open.hardcoded.net/about/>`__.
=== 5.10.0 (2010-09-27)
* Improved UI with a little revamp.
* Added the possibility to place hardlinks to references after having deleted duplicates. [Mac OS X, Linux] (#91)
* Added an option to ignore duplicates hardlinking to the same file. [Mac OS X, Linux] (#92)
* Added multiple selection in the "Add Directory" dialog. [Mac OS X] (#105)
* Fixed a bug preventing drag & drop from working in the Directories panel. [Windows, Linux]
* Fixed a crash on some badly formed Id3v2 tags. (#107)
=== 5.9.1 (2010-08-24)
* Fixed HTML exporting which was broken in 5.9.0.
* Fixed Xing-encoded mpeg decoding which was broken in 5.9.0.
=== 5.9.0 (2010-08-20)
* Added the ability to save results (and reload them) at arbitrary locations.
* Improved the way reference files in dupe groups are chosen. (#15)
* Remember size/position of all windows between launches. (#102)
* Fixed a bug sometimes preventing dupeGuru from reloading previous results.
* Fixed a bug sometimes causing the progress dialog to be stuck there. [Mac OS X] (#103)
* Removed the Creation Date column, which wasn't displaying the correct value anyway. (#101)
=== 5.8.1 (2010-07-16)
* Fixed a couple of crashes. (#95, #97, #100)
=== 5.8.0 (2010-04-14)
* Improved error messages when files can't be sent to trash, moved or copied.
* Added a custom command invocation action. (#12)
* Filters are now applied on whole paths. (#4)
=== 5.7.2 (2010-02-13)
* Fixed a crash upon quitting when support folder is not present. (#83)
* Fixed a crash during sorting. (#85)
* Fixed selection glitches, especially while renaming. (#93)
=== 5.7.1 (2010-01-19)
* The Mac OS X version of dupeGuru ME is now 64-bit!
* Improved memory usage for Contents scans. (#75)
* Improved scanning speed when ref directories are involved. (#77)
* Show a message dialog at the end of the scan if no duplicates are found. (#81)
* Re-added the "Remove Dead Tracks in iTunes" menu item which got lost in 5.7.0.
=== 5.7.0 (2009-12-18)
* Added drag & drop support in the Directories panel. (#9)
* Fixed a bug causing dupeGuru to be confused if a scanned file was moved during the scan. (#72)
* Clarified how directories' state are set by painting a combo box in the state cells. [Windows] (#76)
* Fixed some crashes. (#78 and #79)
* Dropped Mac OS X Tiger support.
=== 5.6.6 (2009-10-14)
* Improved directory selection in the Directories panel (Windows). (#56)
* Fixed a bug preventing dupeGuru from starting on certain machines (Windows). (#68)
* Fixed a crash during very big scans. (#70)
=== 5.6.5 (2009-10-04)
* Fixed crash with filtering when regular expressions were enabled. (#60)
* Fixed crash when setting directories' state. (Mac OS X) (#66)
* Fixed crash with Make Reference when certain filters were applied. (Mac OS X) (#55)
* Improved error handling during delete/move/copy actions. (#62 #65)
=== 5.6.4 (2009-09-07)
* Re-introduced the Export to XHTML feature to Windows.
* Improved Export to XHTML speed.
* Improved the grouping algorithm to reduce the number of discarded files in non-exact scans.
* Stopped showing the same file on the 2 sides of the details panel when a ref file is selected.
* Fixed crashes in the Directories panel.
=== 5.6.3 (2009-06-19)
* Fixed bugs with selection being jumpy during "Make Reference" actions and Power Marker switches.
* Fixed crash happening when a file with non-roman characters couldn't be analyzed.
* Fixed crash sometimes happening during the file collection phase in scanning.
* Restored double-click and right-click behavior lost in the PyQt move (Windows).
=== 5.6.2 (2009-06-10)
* Fixed an occasional crash on Copy/Move operations.
* Fixed bugs with iTunes integration.
=== 5.6.1 (2009-05-30)
* Fixed a bug causing a GUI freeze at the beginning of a scan with a lot of files.
* Fixed a bug that sometimes caused a crash when an action was cancelled, and then started again.
=== 5.6.0 (2009-05-23)
* Converted the Windows GUI to Qt.
* Improved the reliability of the scanning process.
=== 5.5.2 (2009-03-28)
* **Fixed** an occasional crash caused by permission issues.
* **Fixed** a bug where the "X discarded" notice would show a too large number of discarded duplicates.
=== 5.5.1 (2008-09-28)
* **Improved** support for AIFF files.
* **Improved** Remove Dead Tracks in iTunes for very large library (Mac OS X).
=== 5.5.0 (2008-09-10)
* **Added** support for AIFF files.
* **Added** a notice in the status bar when matches were discarded during the scan.
* **Improved** duplicate prioritization (smartly chooses which file you will keep).
* **Improved** scan progress feedback.
* **Improved** responsiveness of the user interface for certain actions.
=== 5.4.3 (2008-08-07)
* **Improved** the "Remove Dead Tracks in iTunes" feature.
* **Improved** the speed of results loading and saving.
* **Fixed** a crash sometimes occurring during duplicate deletion.
=== 5.4.2 (2008-06-20)
* **Improved** unicode handling for filenames and tags. dupeGuru ME will now find a lot more duplicates if your files have non-ascii characters in it.
* **Improved** MPEG files duration detection.
* **Fixed** "Clear Ignore List" crash in Windows.
=== 5.4.1 (2008-01-15)
* **Improved** scan, delete and move speed in situations where there were a lot of duplicates.
* **Fixed** occasional crashes when moving a lot of files at once.
=== 5.4.0 (2007-12-06)
* **Added** customizable tag scans.
* **Improved** the handling of low memory situations.
* **Improved** the directory panel. The "Remove" button changes to "Put Back" when an excluded directory is selected.
=== 5.3.2 (2007-11-26)
* **Added** the "Remove empty folders" option.
* **Fixed** results load/save issues.
* **Fixed** occasional status bar inaccuracies when the results are filtered.
=== 5.3.1 (2007-08-12)
* **Fixed** a crash with copy and move.
=== 5.3.0 (2007-07-01)
* **Added** post scan filtering.
* **Fixed** a small issue with AAC decoding.
* **Fixed** issues with the rename feature under Windows.
* **Fixed** some user interface annoyances under Windows.
=== 5.2.7 (2007-03-31)
* **Fixed** a crash sometimes happening while loading results.
=== 5.2.6 (2007-03-25)
* **Improved** UI responsiveness (using threads) under Mac OS X.
* **Improved** result load/save speed and memory usage.
* **Fixed** a "bad file descriptor" error occasionally popping up.
* **Fixed** a bug with non-latin directory names.
* **Fixed** a column mixup under Windows. The Artist column couldn't be shown.
* **Fixed** a bug causing the sorting under Power Marker mode not to work under Mac OS X.
=== 5.2.5 (2007-02-14)
* **Added** Re-orderable columns. In fact, I re-added the feature which was lost in the C# conversion in 5.2.0 (Windows).
* **Changed** the behavior of the scanning engine when setting the hardness to 100. It will now only match files that have their words in the same order.
* **Fixed** a bug with all the Delete/Move/Copy actions with certain kinds of files.
=== 5.2.4 (2007-01-10)
* **Fixed** a bug with the Move action.
* **Fixed** a "ghosting" bug. Dupes deleted by dupeGuru would sometimes come back in subsequent scans (Windows).
* **Fixed** a bug introduced in the last version that caused the status bar not to update when dupes were marked (Windows).
=== 5.2.3 (2007-01-04)
* **Fixed** bugs sometimes making dupeGuru crash when marking a dupe (Windows).
* **Fixed** some minor visual glitches (Windows).
=== 5.2.2 (2006-12-21)
* **Improved** Id3v2.4 tags decoding to support some malformed tags that iTunes sometimes produce.
* **Improved** the rename file dialog to exclude the extension from the original selection (so when you start typing your new filename, it doesn't overwrite it) (Windows).
* **Changed** some menu key shortcuts that created conflicts (Windows).
* **Fixed** a bug preventing files from "reference" directories to be displayed in blue in the results (Windows).
* **Fixed** a bug preventing some files to be sent to the recycle bin (Windows).
* **Fixed** a bug with the "Remove" button of the directories panel (Windows).
* **Fixed** a bug in the packaging preventing certain Windows configurations to start dupeGuru at all.
=== 5.2.1 (2006-11-18)
* **Fixed** a bug with directory states.
=== 5.2.0 (2006-11-17)
* **Changed** the Windows interface. It is now .NET based.
* **Added** an auto-update feature to the windows version.
* **Changed** the way power marking works. It is now a mode instead of a separate window.
* **Removed** the min word length/count options. These came from Mp3 Filter, and just aren't used anymore. Word weighting does pretty much the same job.
* **Fixed** a bug sometimes making delete and move operations stall.
=== 5.1.2 (2006-11-03)
* **Added** an auto-update feature in the Mac OS X version (with Sparkle).
* **Added** a "Remove Dead Tracks in iTunes" feature in the Mac OS X version.
* **Improved** speed and memory usage of the scanning engine, especially when the scan results in a lot of duplicates.
* **Improved** VBR mp3 support.
* **Fixed** a bug preventing some duplicate reports to be created correctly under Windows.
=== 5.1.1 (2006-09-29)
* **Fixed** a bug (no, not the same as in 5.1.0) preventing some duplicates to be found, especially in huge collections.
=== 5.1.0 (2006-09-26)
* **Added** XHTML export feature.
* **Fixed** a bug preventing some duplicates to be found when using the "Filename - Fields (No Order)" scan method.
=== 5.0.11 (2006-08-30)
* **Added** sticky columns.
* **Fixed** an issue with file caching between scans.
* **Fixed** an issue preventing some duplicates from being deleted/moved/copied.
=== 5.0.10 (2006-08-27)
* **Fixed** an issue with ignore list and unicode.
* **Fixed** an issue with file attribute fetching sometimes causing dupeGuru ME to crash.
* **Fixed** an issue in the directories panel under Windows.
=== 5.0.9 (2006-08-17)
* **Fixed** an issue in the duplicate seeking engine preventing some duplicates to be found.
* (Yeah, I'm in a bug fixing frenzy right now :) )
=== 5.0.8 (2006-08-16)
* **Fixed** an issue with the new track column occasionally causing crash.
* **Fixed** an issue with the handling of corrupted files that occasionally caused crash.
=== 5.0.7 (2006-08-12)
* **Improved** unicode support.
* **Improved** the "Reveal in Finder" ("Open Containing Folder" in Windows) feature so it selects the file in the folder it opens.
=== 5.0.6 (2006-08-08)
* **Added** the the Track Number detail column.
* **Improved** the ignore list system.
* **Fixed** a bug in the mp3 metadata decoding unit.
* dupeGuru Music Edition is now a Universal application on Mac OS X.
=== 5.0.5 (2006-07-28)
* **Improved** VBR mp3 metadata decoding.
* **Fixed** an issue that occasionally made dupeGuru ME crash on startup.
=== 5.0.4 (2006-06-26)
* **Fixed** an issue with Move and Copy features.
=== 5.0.3 (2006-06-17)
* **Improved** duplicate scanning speed.
* **Added** a warning that a file couldn't be renamed if a file with the same name already exists.
=== 5.0.2 (2006-06-06)
* **Added** "Rename Selected" feature.
* **Improved** MP3 metadata decoding.
* **Fixed** some minor issues with "Reload Last Results" feature.
* **Fixed** ignore list issues.
=== 5.0.1 (2006-05-26)
* **Fixed** occasional progress bar woes under Windows.
* Nothing has been changed in the Mac OS X version, but I want to keep version in sync.
=== 5.0.0 (2006-05-19)
* Complete rewrite
* Changed "Mp3 Filter" name to "dupeGuru Music Edition"
* Now runs on Mac OS X.
=== 4.2.6 (2006-04-13)
* **Fixed** a critical bug introduced in 4.2.5: Files couldn't be deleted anymore!
* **Fixed** some more issues with WMA decoding.
* **Fixed** an issue with profile wizard.
=== 4.2.5 (2006-04-11)
* **Added** a test zone in the Exclusions profile section.
* **Fixed** a bug with exclusion patterns.
* **Fixed** an issue occuring when reading some kinds of WMA files.
=== 4.2.4 (2006-02-16)
* **Fixed** MPL occasional issues when saving.
* **Fixed** m4p (protected AAC files) bitrate reading.
=== 4.2.3 (2005-10-15)
* **Improved** Added the "Add Custom Extension" button in the File Priority section of the profile editor.
=== 4.2.2 (2005-10-07)
* **Improved** Results management by adding the possibility to remove selected (not only checked) duplicates from the list.
* **Fixed** An issue with the "Switch with reference" feature.
* **Fixed** A stability issue with the result pane.
=== 4.2.1 (2005-09-06)
* **Fixed** A little bug with M4A/M4P support.
=== 4.2.0 (2005-08-30)
* **Added** M4A/M4P (iTunes format) support.
* **Added** "Field order doesn't matter" option in Comparison Options.
* **Added** A "Open directory containing this file" option in the result window's context menu.
* **Fixed** Some bugs with the "Load last results" function.
=== 4.1.5 (2005-03-22)
* **Fixed** Nasty bug in the wizard system.
* **Fixed** Yet another nasty bug in the Move/Copy option of the result pane.
=== 4.1.4 (2004-11-10)
* **Added** "Load last results" function.
* **Added** Customizable columns in the results window.
* **Fixed** A bug related to special characters in the XML profiles.
* **Fixed** The result window scroll didn't move properly on "Switch with ref.".
* **Fixed** A bug with the WMA plugin.
=== 4.1.3 (2004-10-30)
* **Added** Profile summary in the main window.
* **Added** An (Artist + title) ID3 tag comparison type.
* **Improved** The profile system by making it XML based.
=== 4.1.2 (2004-09-28)
* **Improved** Changed the ID3 tag comparison from (Artist + Title) to (Artist + Title + Album).
=== 4.1.1 (2004-09-22)
* **Fixed** A couple of bugs.
=== 4.1.0 (2004-08-28)
* **Added** A "special selection" wizard in the results window.
* **Improved** Changed the File content comparison system.
* **Fixed** A sorting bug in the directory tree displays
=== 4.0.6 (2004-08-10)
* **Improved** Redesigned the configuration wizard (again!).
=== 4.0.5 (2004-07-23)
* **Improved** Redesigned the profile directory frame.
* **Fixed** A quite big bug with file priority system.
* **Fixed** A bug with offline registration.
=== 4.0.4 (2004-07-15)
* **Fixed** A couple of minor bugs with profile directories/priorities.
* **Improved** Reduced, thus clarified, most of the text in the profile wizard.
=== 4.0.3 (2004-07-12)
* **Fixed** An issue with "Similar word threshold" setting, and boosted it's performance.
* **Fixed** Some issues with the registering system.
=== 4.0.2 (2004-07-10)
* **Fixed** A couple of obscure bugs.
* **Improved** Changed a couple of minor things in this help file.
=== 4.0.1 (2004-07-07)
* **Fixed** A couple of issues with the configuration wizard.
* **Fixed** A bug with the View Details button when not using WinXP.
=== 4.0.0 (2004-07-05)
Mp3 Filter has been rebuilt from scratch for this version. It features a completely new interface, a profile system and a redesigned configuration wizard.
=== 3.20 (2002-12-31)
I never made a history entry for this version, although it has been the version that went without changes for the most time (1 year and a half). I also lost track of when I made it, but a quick fix (3.20.0.5) has been made on 2002/12/31.
=== 3.16 (2002-08-14)
Enhanced the Mp3 List system with locking and improved searching.
=== 3.15 (2002-08-13)
Added Wizard, tips and installation program.
=== 3.14 (2002-08-12)
Added funny animation plugin and Windows Explorer shell extension.
=== 3.12 (2002-08-11)
Minor bugfixes + changed the Edit tag interface.
=== 3.11 (2002-08-10)
Added Import list feature + first 5kb of the files comparison.
=== 3.10 (2002-07-26)
Added extension plugins.
=== 3.01 (2002-01-30)
Fixed the ID3 Tag editor a bit. Changed the way comparison works: it now can use ID3 Tags.
=== 3.00 (2002-01-29)
The interface simply has been C-O-M-P-L-E-T-E-L-Y redesigned. Customization level is at it's maximum, too cool.
=== 2.21 (2002-01-28)
Added some speed ONCE AGAIN, improved the memory management and added a "favourite directories" feature. I also removed some confusing options. The final result is quite cute!
=== 2.20 (2002-01-27)
Interface has been COMPLETELY rebuilt. Now there are MUCH more place for everything! Several minor bugs has also been fixed Added mass ID3 tag editing.
=== 2.10 (2001-12-02)
Shareware again. Fixed some major bugs. Rebuilt (again) the mp3 list system, it's now much more flexible. Added a configuration wizard. Added a renaming preview. Well, it's a good update after all eh!
=== 2.01 (2001-12-01)
Added multi-language support. Added a "Send to recycle bin" option. Enhanced rename feature. Corrected some bugs with rename function. Enhanced list search function.
=== 2.00 (2001-11-30)
As 11 Sept 2001 entered in the History, the release date of this program will too! Ok, here is the list of Mp3 Filter version 2.00 godly features:
* **SPEED!!!!!!!!!!!!** Forget about what I said before. Previous versions were TURTLES compared to that one. (Imagine what other programs are eh! :P). What took 1 minute take 3-5 seconds now, and the more files you have to compare together, the better will be the files/time ratio will be!
* Multi-list system. It is now easier than ever to exchange lists with your friends and select songs!
* Cuter interface.
=== 1.61 (2001-06-29)
There was some stability issues with the internal player I was using. Mp3 Filter is now using Winamp. Thus, all files playable by Winamp are now playable by Mp3 Filter. Fixed some minor bugs. Changed the way word exclusion system work. AND added a song selection system. Now you can select songs from your mp3 list and copy them to your hard drive without having to worry about where are these songs.
=== 1.60 (2001-06-28)
The main theme of this update is efficiency. Mp3 Filter v1.53 was already pure speed, you will NOT believe this version''s one. 60% faster on ALL comparisons! Do not search for God anymore, you found Him and He even got an e-mail address: cathedly@hotmail.com :P. Ok, to tell you the truth I did not make Mp3 Filter 60 % faster, I made it 60% less slow. My previous algorithm wasn't bad, but I thought about another one (this one) that has much better performances. ALSO: Created an option form. Changed the results display (Added some info along with the results (size,length,bitrate). Added a word excluding system. Also added a backup system (Instead of deleting it, you can now move your file to the Mp3 Filter backup directory (Mp3 filter does not compare files in the backup directory).
=== 1.53 (2001-06-27)
Damnit, big update. Added the conditional file searching, file copying, and rethought the Mp3List system. That new Mp3List system is damn cool! It load instantly, even with HUGE lists, and it reduces the comparing time with list by 30 godly % !!! You're not gonna believe it! This program is now PURE SPEED!
=== 1.52 (2001-05-05)
Quite cool update too. This version now can check if new versions are available. I also grouped all options in the same menu. I moved the search function. This function is now a lot cooler. Instead of giving you a list of matching results, it shows you, in the Mp3 List Stats form, where the song is by positioning itself in the List Tree.
=== 1.51 (2001-05-04)
Waa! I'm so happy! I implemented a poll system to Mp3 Filter! Now you can answer my questions directly on the program! I can't wait to see if you, people, will answer!
=== 1.50 (2001-05-03)
MAJOR UPDATE. This one is quite cool :). You ever used the "Edit Mp3 List" feature? I improved it a lot. Now, when you add a CD to your list, it not only saves the CD name, but it also saves the whole CD directory system. So when you use 'Edit Mp3 List' now, you can browse your CDs as if you would browse anything. (There's only one problem: you must REbuild your mp3 list to make it fit with v1.5)
=== 1.46 (2001-05-02)
Added an equalizer. This equalizer has been a good reason to add an INI file to the program to store changed parameters.
=== 1.45 (2001-05-01)
Added a Banlist to the program. You write down a list of unwanted songs in your ban list and start a scan. This function will not compare as the rest does. If ALL words contained in a banlist line are in a filename, it will match.
=== 1.44 (2001-04-30)
I made the Mp3 Filter window to minimize when it compares so it can do it faster (a LOT faster). I also modified the program so it checks the playlist integrity each time there's a file deleted after a comparison). There was a bug with the v1.43. When you had the ID3 Tag window up and you closed the program, it would crash. Fixed that.
=== 1.43 (2001-04-29)
I noticed some days ago that people who had a good resolution but the option to enlarge the icons on, Mp3 Filter had some big problems to display its main form right. Since you cant resize the form without having the objects in to resize too, I had to fix it. I also implemented a MUCH faster file searching system. It takes less than 2 seconds to find all mp3 on my hard disk now.
=== 1.42 (2001-04-09)
Added some fun and useful feats. First, I made a cute playlist right-clickmenu with Play File, Edit Tag, Locate, Remove from list and delete from disk.I also added a recursive function to add songs to the playlist (Why didn't I thinkabout it before?? I have no clue...). I also made the Shuffle thing less.... random. (It builds a random list and play it, so before a song play again, all songs will be played (I added that feat some time after v1.41 release, but I didn't thought that it worth a version change, so I only announce it on 1.42))
=== 1.41 (2001-04-08)
I can't avoid it. there is always some bugs after a major update. I didn't thought about the fact that it was possible to make a playlist with unplayable files :) fixed that.
=== 1.40 (2001-04-07)
MAJOR UPDATE! You wanted a playlist. You got it in this version. Those big buttons were ugly? Made a cute standard menu. You didn't seem to want to buy that program. I gave up. Here is it. Freeware again.
=== 1.36 (2001-03-16)
Made it possible to play files that are listed after a "Find all Mp3 on this drive". It also tells what song is currently playing on the main title bar.
=== 1.35 (2001-03-15)
Added a system icon. Wow! it almost looks like winamp!
=== 1.34 (2001-03-14)
Added music progress bar and made the music playing continuous.
=== 1.33 (2001-03-13)
Added mass renaming functions.
=== 1.32 (2001-03-12)
Fixed some bugs with those useful function :) (and made the program shareware)
=== 1.31 (2001-03-11)
Added some useful functions.
=== 1.30 (2001-03-10)
MAJOR CHANGE. yeah! I scrapped those radio buttons, and extended the "recurse" function. Now, you only have 2 choices. Or you compare with your list, or you compare within the folder (and sub-folders). With that system, you can tell the program to just compare ALL mp3 in your hard drive. You just have to select your drive root, and press "Find dupe files in this folder" having "Recurse" checked.
=== 1.23 (2001-03-09)
Added the Music Control panel. I just love it. do you?
=== 1.22 (2001-03-08)
Fixed some inaccuracy with folder to folder comparison. (Will I be done fixing someday??) and made mp3 search slightly faster.
=== 1.21 (2001-03-07)
Added Mp3 Player (Didn't know it was so easy to include in a program! I woulda done this before if I knew...) and ID3 Tag Editor. Hum, The Mp3 Player has some problems reading some mp3s... know that.
=== 1.20 (2001-03-04)
When I removed the "find mp3 in my list" thing, some people told me it was useful. However, I still think that the old way to search mp3 was too messed up, so I just added a little textbox and a search button for quick search.
=== 1.18 (2001-03-03)
Damnit! why didn't I see it? There was a bug with displaying the right filename on the result boxes with List comparing. The results were switched! Thus, deleting was impossible after a List compare. Corrected it in 1.18.
=== 1.19 (2001-03-03)
When I read Yippee review (www.yippee.net thanks for review), I tried to somewhat improve it. What changed? This:
* Compare engine is less strict. if one word contains the other, it now match (now, "Limp Bizkit" and "Limp Bizkitt" would match)
* Removed some useless features to simplify the interface. "Save as..." (why did I put this on???) and "Find file in my list" (Easier to find a song with "Edit List")
* Added some hints to buttons and some explicative labels.
* "List Stats" changed to "Edit List" so you don't have to "hard change" your mp3 list.
=== 1.17 (2001-02-06)
I never thought that a software history would be useful for such a small program, but since Mp3 filter won't stop improving, I decided to start it. So 1.17 is the base version.

276
help/changelog_pe Normal file
View File

@@ -0,0 +1,276 @@
=== 1.11.3 (2010-12-31)
* Fixed bug causing results to be corrupted after a scan cancellation. (#120)
* Fixed crash when fetching Fairware unpaid hours. (#121)
* Fixed crash when replacing files with hardlinks. (#122)
* Fixed crash when iPhoto can't be found. (#125)
=== 1.11.2 (2010-10-07)
* Fixed delta column colors which were broken since 1.11.0.
* Fixed column sorting crash. (#108)
* Fixed occasional crash during scan. (#106)
=== 1.11.1 (2010-09-30)
* Re-licensed dupeGuru to BSD and made it `Fairware <http://open.hardcoded.net/about/>`__.
=== 1.11.0 (2010-09-27)
* Improved UI with a little revamp.
* Added the possibility to place hardlinks to references after having deleted duplicates. [Mac OS X, Linux] (#91)
* Added an option to ignore duplicates hardlinking to the same file. [Mac OS X, Linux] (#92)
* Added multiple selection in the "Add Directory" dialog. [Mac OS X] (#105)
* Fixed a bug preventing drag & drop from working in the Directories panel. [Windows, Linux]
=== 1.10.0 (2010-08-21)
* Added the ability to save results (and reload them) at arbitrary locations.
* Improved the way reference files in dupe groups are chosen. (#15)
* Remember size/position of all windows between launches. (#102)
* Fixed a bug sometimes preventing dupeGuru from reloading previous results.
* Fixed a bug sometimes causing the progress dialog to be stuck there. [Mac OS X] (#103)
* Removed the Creation Date column, which wasn't displaying the correct value anyway. (#101)
=== 1.9.1 (2010-07-17)
* Fixed a couple of crashes. (#95, #96, #97, #100)
=== 1.9.0 (2010-04-15)
* Improved error messages when files can't be sent to trash, moved or copied.
* Added a custom command invocation action. (#12)
* Filters are now applied on whole paths. (#4)
=== 1.8.6 (2010-04-08)
* Fixed a crash when performing very big scans.
* Fixed a rare crash during results loading. (#90)
=== 1.8.5 (2010-03-01)
* Fixed a bug preventing some iPhoto Libraries to be read. [Mac OS X]
* Improved results loading and saving speed.
=== 1.8.4 (2010-02-18)
* Fixed a glitch in the details panel causing it to sometimes show the wrong pictures.
=== 1.8.3 (2010-02-11)
* Fixed a crash when reading certain pictures. [Mac OS X] (#94)
* Fixed selection glitches, especially while renaming. (#93)
=== 1.8.2 (2010-02-06)
* dupeGuru Picture Edition is now 64-bit on Mac OS X!
* Improved scanning speed.
* Fixed a crash upon quitting when support folder is not present. (#83)
=== 1.8.1 (2010-01-15)
* Improved scanning speed when ref directories are involved. (#77)
* Show a message dialog at the end of the scan if no duplicates are found. (#81)
* Fixed a crash when adding the iPhoto library twice. [Mac OS X] (#80)
=== 1.8.0 (2009-12-16)
* Added drag & drop support in the Directories panel. (#9)
* Fixed a bug causing dupeGuru to be confused if a scanned file was moved during the scan. (#72)
* Clarified how directories' state are set by painting a combo box in the state cells. [Windows] (#76)
* Fixed some crashes. (#78 and #79)
* Dropped Mac OS X Tiger support.
=== 1.7.8 (2009-10-24)
* Fixed a bug sometimes causing some duplicates to be ignored during the scans. (#73)
=== 1.7.7 (2009-10-14)
* Improved directory selection in the Directories panel (Windows). (#56)
* Fixed a bug preventing dupeGuru from starting on certain machines (Windows). (#68)
* Fixed a crash during very big scans. (#70)
=== 1.7.6 (2009-10-03)
* Fixed a bug causing memory error when scanning a lot of pictures. (#58)
* Fixed bugs preventing some duplicates to be found. (#64 #67)
* Fixed a bug preventing some iPhoto Libraries to be read. (Mac OS X) (#61)
* Fixed crash with filtering when regular expressions were enabled. (#60)
* Fixed crash when setting directories' state. (Mac OS X) (#66)
* Fixed crash with Make Reference when certain filters were applied. (Mac OS X) (#55)
* Improved error handling during delete/move/copy actions. (#62 #65)
=== 1.7.5 (2009-09-07)
* Re-introduced the Export to XHTML feature to Windows.
* Improved Export to XHTML speed.
* Improved the grouping algorithm to reduce the number of discarded files in non-exact scans.
* Stopped showing the same file on the 2 sides of the details panel when a ref file is selected.
* Fixed crashes in the Directories panel.
=== 1.7.4 (2009-06-20)
* Fixed bugs with selection being jumpy during "Make Reference" actions and Power Marker switches.
* Fixed crash happening when a file with non-roman characters couldn't be analyzed.
* Fixed crash sometimes happening during the file collection phase in scanning.
* Fixed bugs with iPhoto integration.
* Restored double-click and right-click behavior lost in the PyQt move (Windows).
=== 1.7.3 (2009-06-07)
* Fixed an occasional crash on Copy/Move operations.
* Fixed bugs with iPhoto integration.
=== 1.7.2 (2009-05-27)
* Fixed a bug causing '.jpeg' files not to be scanned.
* Fixed a bug causing a GUI freeze at the beginning of a scan with a lot of files.
* Fixed a bug that sometimes caused a crash when an action was cancelled, and then started again.
* Improved scanning speed.
=== 1.7.1 (2009-05-26)
* Fixed a bug causing the "Match Scaled" preference to be inverted.
=== 1.7.0 (2009-05-20)
* Fixed the bug from 1.6.0 preventing PowerPC macs from running the application.
* Converted the Windows GUI to Qt, thus enabling multiprocessing and making the scanning process
faster.
=== 1.6.0 (2009-03-24)
* **Improved** scanning speed, mainly on OS X where all cores of the CPU are now used.
* **Fixed** an occasional crash caused by permission issues.
* **Fixed** a bug where the "X discarded" notice would show a too large number of discarded duplicates.
=== 1.5.0 (2008-09-10)
* **Added** a notice in the status bar when matches were discarded during the scan.
* **Improved** duplicate prioritization (smartly chooses which file you will keep).
* **Improved** scan progress feedback.
* **Improved** responsiveness of the user interface for certain actions.
=== 1.4.2 (2008-07-28)
* **Improved** iPhoto compatibility on Mac OS X.
* **Improved** the speed of results loading and saving.
* **Fixed** a crash sometimes occurring during duplicate deletion.
=== 1.4.1 (2008-04-12)
* **Improved** iPhoto Library loading feedback on Mac OS X.
* **Fixed** the directory selection dialog. Bundles can be selected again on Mac OS X.
* **Fixed** "Clear Ignore List" crash in Windows.
=== 1.4.0 (2008-02-20)
* **Added** iPhoto Library support on Mac OS X.
* **Fixed** occasional crashes when scanning corrupted pictures.
=== 1.3.4 (2008-01-12)
* **Improved** scan, delete and move speed in situations where there were a lot of duplicates.
* **Fixed** occasional crashes when moving a lot of files at once.
* **Fixed** an issue sometimes preventing the application from starting at all.
=== 1.3.3 (2007-12-03)
* **Improved** the handling of low memory situations.
* **Improved** the directory panel. The "Remove" button changes to "Put Back" when an excluded directory is selected.
* **Fixed** the directory selection dialog. iPhoto '08 library files can now be selected.
=== 1.3.2 (2007-11-24)
* **Added** the "Remove empty folders" option.
* **Fixed** results load/save issues.
* **Fixed** occasional status bar inaccuracies when the results are filtered.
=== 1.3.1 (2007-10-21)
* **Improved** results loading speed.
* **Improved** details panel's picture loading (made it asynchronous).
* **Fixed** a bug where the stats line at the bottom would sometimes go confused while having a filter active.
* **Fixed** a bug under Windows where some duplicate markings would be lost.
=== 1.3.0 (2007-09-22)
* **Added** post scan filtering.
* **Fixed** issues with the rename feature under Windows.
* **Fixed** some user interface annoyances under Windows.
=== 1.2.1 (2007-05-19)
* **Improved** UI responsiveness (using threads) under Mac OS X.
* **Improved** result load/save speed and memory usage.
=== 1.2.0 (2007-03-17)
* **Changed** the picture decoding libraries for both Mac OS X and Windows. The Mac OS X version uses the Core Graphics library and the Windows version uses the .NET framework imaging capabilities. This results in much faster scans. As a bonus, the Mac OS X version of dupeGuru PE now supports RAW images.
=== 1.1.6 (2007-02-11)
* **Added** Re-orderable columns. In fact, I re-added the feature which was lost in the C# conversion in 1.1.0 (Windows).
* **Fixed** a bug with all the Delete/Move/Copy actions with certain kinds of files.
=== 1.1.5 (2007-01-11)
* **Fixed** a bug with the Move action.
=== 1.1.4 (2007-01-09)
* **Fixed** a "ghosting" bug. Dupes deleted by dupeGuru would sometimes come back in subsequent scans (Windows).
* **Fixed** bugs sometimes making dupeGuru crash when marking a dupe (Windows).
* **Fixed** some minor visual glitches (Windows).
=== 1.1.3 (2006-12-23)
* **Improved** the caching system. This makes duplicate scans significantly faster.
* **Improved** the rename file dialog to exclude the extension from the original selection (so when you start typing your new filename, it doesn't overwrite it) (Windows).
* **Changed** some menu key shortcuts that created conflicts (Windows).
* **Fixed** a bug preventing files from "reference" directories to be displayed in blue in the results (Windows).
* **Fixed** a bug preventing some files to be sent to the recycle bin (Windows).
* **Fixed** a bug with the "Remove" button of the directories panel (Windows).
* **Fixed** a bug in the packaging preventing certain Windows configurations to start dupeGuru at all.
=== 1.1.2 (2006-11-18)
* **Fixed** a bug with directory states.
=== 1.1.1 (2006-11-17)
* **Fixed** a bug causing the ignore list not to be saved.
* **Fixed** a bug with selection under Power Marker mode.
=== 1.1.0 (2006-11-15)
* **Changed** the Windows interface. It is now .NET based.
* **Added** an auto-update feature to the windows version.
* **Changed** the way power marking works. It is now a mode instead of a separate window.
* **Changed** the "Size (MB)" column for a "Size (KB)" column. The values are now "ceiled" instead of rounded. Therefore, a size "0" is now really 0 bytes, not just a value too small to be rounded up. It is also the case for delta values.
* **Fixed** a bug sometimes making delete and move operations stall.
=== 1.0.5 (2006-10-12)
* **Added** an auto-update feature in the Mac OS X version (with Sparkle).
* **Fixed** a bug sometimes causing inaccuracies of the Match %.
=== 1.0.4 (2006-09-21)
* **Fixed** a bug with the cache system.
=== 1.0.3 (2006-09-15)
* **Added** the ability to search for scaled duplicates.
* **Added** a cache system for faster scans.
* **Improved** speed of the scanning engine.
=== 1.0.2 (2006-09-11)
* **Improved** speed of the scanning engine.
* **Improved** the display of pictures in the details panel (Windows).
=== 1.0.0 (2006-09-08)
* Initial release.

300
help/changelog_se Normal file
View File

@@ -0,0 +1,300 @@
=== 2.12.3 (2011-01-01)
* Fixed bug causing results to be corrupted after a scan cancellation. (#120)
* Fixed crash when fetching Fairware unpaid hours. (#121)
* Fixed crash when replacing files with hardlinks. (#122)
=== 2.12.2 (2010-10-05)
* Fixed delta column colors which were broken since 2.12.0.
* Fixed column sorting crash. (#108)
* Fixed occasional crash during scan. (#106)
=== 2.12.1 (2010-09-30)
* Re-licensed dupeGuru to BSD and made it `Fairware <http://open.hardcoded.net/about/>`__.
=== 2.12.0 (2010-09-26)
* Improved UI with a little revamp.
* Added the possibility to place hardlinks to references after having deleted duplicates. [Mac OS X, Linux] (#91)
* Added an option to ignore duplicates hardlinking to the same file. [Mac OS X, Linux] (#92)
* Added multiple selection in the "Add Directory" dialog. [Mac OS X] (#105)
* Fixed a bug preventing drag & drop from working in the Directories panel. [Windows, Linux]
=== 2.11.1 (2010-08-26)
* Fixed HTML exporting which was broken in 2.11.0.
=== 2.11.0 (2010-08-18)
* Added the ability to save results (and reload them) at arbitrary locations.
* Improved the way reference files in dupe groups are chosen. (#15)
* Remember size/position of all windows between launches. (#102)
* Fixed a bug sometimes preventing dupeGuru from reloading previous results.
* Fixed a bug sometimes causing the progress dialog to be stuck there. [Mac OS X] (#103)
* Removed the Creation Date column, which wasn't displaying the correct value anyway. (#101)
=== 2.10.1 (2010-07-15)
* Fixed a couple of crashes. (#95, #97, #100)
=== 2.10.0 (2010-04-13)
* Improved error messages when files can't be sent to trash, moved or copied.
* Added a custom command invocation action. (#12)
* Filters are now applied on whole paths. (#4)
=== 2.9.2 (2010-02-10)
* dupeGuru is now 64-bit on Mac OS X!
* Fixed a crash upon quitting when support folder is not present. (#83)
* Fixed a crash during sorting. (#85)
* Fixed selection glitches, especially while renaming. (#93)
=== 2.9.1 (2010-01-13)
* Improved memory usage for Contents scans. (#75)
* Improved scanning speed when ref directories are involved. (#77)
* Show a message dialog at the end of the scan if no duplicates are found. (#81)
* Fixed a bug sometimes causing the small files threshold pref to be ignored. [Mac OS X] (#75)
=== 2.9.0 (2009-11-03)
* Significantly improved speed and memory usage of big contents-based scans.
* Added drag & drop support in the Directories panel. (#9)
* Fixed a bug causing dupeGuru to be confused if a scanned file was moved during the scan. (#72)
* Dropped support for Mac OS X 10.4 (Tiger)
=== 2.8.2 (2009-10-14)
* Improved directory selection in the Directories panel (Windows). (#56)
* Fixed a bug preventing dupeGuru from starting on certain machines (Windows). (#68)
* Fixed a crash during very big scans. (#70)
=== 2.8.1 (2009-10-02)
* Fixed crash with filtering when regular expressions were enabled. (#60)
* Fixed crash when setting directories' state. (Mac OS X) (#66)
* Fixed crash with Make Reference when certain filters are applied. (Mac OS X) (#55)
* Improved error handling during delete/move/copy actions. (#62 #65)
=== 2.8.0 (2009-09-07)
* Added support for all kinds of bundle (not just applications) (Mac OS X) (#11)
* Re-introduced the Export to XHTML feature to Windows. (#14)
* Improved Export to XHTML speed. (#14)
* Improved Contents scanning speed for large files. (#33)
* Improved the grouping algorithm to reduce the number of discarded files in non-exact scans. (#51)
* Stopped showing the same file on the 2 sides of the details panel when a ref file is selected. (#50)
* Fixed crashes in the Directories panel. (#46)
=== 2.7.3 (2009-06-20)
* Fixed bugs with selection being jumpy during "Make Reference" actions and Power Marker
switches. (#3)
* Fixed crash happening when a file with non-roman characters couldn't be analyzed. (#30)
* Fixed crash sometimes happening during the file collection phase in scanning. (#38)
* Restored double-click and right-click behavior lost in the PyQt move (Windows). (#34 #35)
=== 2.7.2 (2009-06-10)
* Fixed an occasional crash on Copy/Move operations. (#16)
* Added automatic exclusion for sensible folders (like system folders). (#20)
* Fixed an occasional crash when application files were part of the results (Mac OS X). (#25)
=== 2.7.1 (2009-05-29)
* Fixed a bug causing crashes when having application files in the results.
* Fixed a bug causing a GUI freeze at the beginning of a scan with a lot of files.
* Fixed a bug that sometimes caused a crash when an action was cancelled, and then started again.
=== 2.7.0 (2009-05-25)
* Converted the Windows GUI to Qt.
* Improved the reliability of the scanning process.
=== 2.6.1 (2009-03-27)
* **Fixed** an occasional crash caused by permission issues.
* **Fixed** a bug where the "X discarded" notice would show a too large number of discarded
duplicates.
=== 2.6.0 (2008-09-10)
* **Added** a small file threshold preference.* **Added** a notice in the status bar when matches were discarded during the scan.
* **Improved** duplicate prioritization (smartly chooses which file you will keep).
* **Improved** scan progress feedback.
* **Improved** responsiveness of the user interface for certain actions.
=== 2.5.4 (2008-08-10)
* **Improved** the speed of results loading and saving.
* **Fixed** a crash sometimes occurring during duplicate deletion.
=== 2.5.3 (2008-07-08)
* **Improved** unicode handling for filenames. dupeGuru will now find a lot more duplicates if your files have non-ascii characters in it.
* **Fixed** "Clear Ignore List" crash in Windows.
=== 2.5.2 (2008-01-10)
* **Improved** the handling of low memory situations.
* **Improved** the directory panel. The "Remove" button changes to "Put Back" when an excluded directory is selected.
* **Improved** scan, delete and move speed in situations where there were a lot of duplicates.
* **Fixed** occasional crashes when moving bundles (such as .app files).
* **Fixed** occasional crashes when moving a lot of files at once.
=== 2.5.1 (2007-11-22)
* **Added** the "Remove empty folders" option.
* **Fixed** results load/save issues.
* **Fixed** occasional status bar inaccuracies when the results are filtered.
=== 2.5.0 (2007-09-15)
* **Added** post scan filtering.
* **Fixed** issues with the rename feature under Windows
* **Fixed** some user interface annoyances under Windows
=== 2.4.8 (2007-04-14)
* **Improved** UI responsiveness (using threads) under Mac OS X.
* **Improved** result load/save speed and memory usage.
=== 2.4.7 (2007-03-10)
* **Fixed** a "bad file descriptor" error occasionally popping up.* **Fixed** a bug with non-latin directory names.
=== 2.4.6 (2007-02-10)
* **Added** Re-orderable columns. In fact, I re-added the feature which was lost in the C# conversion in 2.4.0 (Windows).
* **Changed** the behavior of the scanning engine when setting the hardness to 100. It will now only match files that have their words in the same order.
* **Fixed** a bug with all the Delete/Move/Copy actions with certain kinds of files.
=== 2.4.5 (2007-01-11)
* **Fixed** a bug with the Move action.
=== 2.4.4 (2007-01-07)
* **Fixed** a "ghosting" bug. Dupes deleted by dupeGuru would sometimes come back in subsequent scans (Windows).
* **Fixed** bugs sometimes making dupeGuru crash when marking a dupe (Windows).
* **Fixed** some minor visual glitches (Windows).
=== 2.4.3 (2006-12-08)
* **Fixed** a mishandling of ".app" files (OS X).
* **Fixed** a bug preventing files from "reference" directories to be displayed in blue in the results (Windows).
* **Fixed** a bug preventing some files to be sent to the recycle bin (Windows).
* **Fixed** a bug in the packaging preventing certain Windows configurations to start dupeGuru at all.
=== 2.4.2 (2006-11-18)
* **Fixed** a bug with directory states.
=== 2.4.1 (2006-11-15)
* **Fixed** a bug causing the ignore list not to be saved.
* **Fixed** a bug sometimes making delete and move operations stall.
=== 2.4.0 (2006-11-10)
* **Changed** the Windows interface. It is now .NET based.
* **Added** an auto-update feature to the windows version.
* **Changed** the way power marking works. It is now a mode instead of a separate window.
* **Changed** the "Size (MB)" column for a "Size (KB)" column. The values are now "ceiled" instead of rounded. Therefore, a size "0" is now really 0 bytes, not just a value too small to be rounded up. It is also the case for delta values.
* **Removed** the min word length/count options. These came from Mp3 Filter, and just aren't used anymore. Word weighting does pretty much the same job.
=== 2.3.4 (2006-11-07)
* **Improved** speed and memory usage of the scanning engine, again. Does it mean there was a lot of improvements to be made? Nah...
=== 2.3.3 (2006-11-02)
* **Improved** speed and memory usage of the scanning engine, especially when the scan results in a lot of duplicates.
* Now I wonder if Sparkle is going to work well...
=== 2.3.2 (2006-10-16)
* **Added** an auto-update feature in the Mac OS X version (with Sparkle).* **Fixed** a bug preventing some duplicate reports to be created correctly under Windows.
=== 2.3.1 (2006-10-02)
* **Fixed** a bug preventing some duplicates to be found, especially when scanning lots of files.
=== 2.3.0 (2006-09-22)
* **Added** XHTML export feature.
=== 2.2.10 (2006-08-31)
* **Added** sticky columns.
* **Fixed** an issue with file caching between scans.
* **Fixed** an issue preventing some duplicates from being deleted/moved/copied.
=== 2.2.9 (2006-08-27)
* **Fixed** an issue with ignore list and unicode.
* **Fixed** an issue with file attribute fetching sometimes causing dupeGuru to crash.* **Fixed** an issue in the directories panel under Windows.
=== 2.2.8 (2006-08-17)
* **Fixed** an issue in the duplicate seeking engine preventing some duplicates to be found.
=== 2.2.7 (2006-08-12)
* **Improved** unicode support.
* **Improved** the "Reveal in Finder" ("Open Containing Folder" in Windows) feature so it selects the file in the folder it opens.
=== 2.2.6 (2006-08-07)
* **Improved** the ignore list system.
* dupeGuru is now a Universal application on Mac OS X.
=== 2.2.5 (2006-07-26)
* **Improved** application (.app) dupe detection on Mac OS X.
* **Fixed** an issue that occasionally made dupeGuru crash on startup.
=== 2.2.4 (2006-06-27)
* **Fixed** an issue with Move and Copy features.
=== 2.2.3 (2006-06-15)
* **Improved** duplicate scanning speed.
* **Added** a warning that a file couldn't be renamed if a file with the same name already exists.
=== 2.2.2 (2006-06-07)
* **Added** "Rename Selected" feature.
* **Fixed** some minor issues with "Reload Last Results" feature.
* **Fixed** ignore list issues.
=== 2.2.1 (2006-05-22)
* **Fixed** occasional progress bar woes under Windows.
* **Fixed** a bug in the registration system under Windows.* Nothing has been changed in the Mac OS X version, but I want to keep version in sync.
=== 2.2.0 (2006-05-10)
* **Added** destination path re-creation options.
* **Added** an ignore list.
* **Changed** the main icon.
* **Improved** dramatically the delta values feature.
=== 2.1.2 (2006-04-18)
* **Added** the "Match similar words" option.
* **Fixed** Power marking issues under Mac.
=== 2.1.1 (2006-04-14)
* **Added** the "Display delta values" option.
* **Improved** Power marking sorting speed under Mac.
* **Fixed** Power marking sorting issues.
=== 2.1.0 (2006-04-03)
* **Added** the Power Marker feature.
* **Fixed** a column sorting bug. The results would sometimes lose their sort order.
* **Fixed** a bug with the Make Reference feature. The results sometimes wasn't correctly refreshed after the reference switch.
=== 2.0.1 (2006-03-23)
* **Fixed** an issue occasionally occurring when trying to reload results from removable media that is no longer present.
=== 2.0.0 (2006-03-17)
* Complete rewrite.
* Now runs on Mac OS X.
=== 1.0.0 (2004-09-24)
* Initial release.

6
help/en/changelog.rst Normal file
View File

@@ -0,0 +1,6 @@
:tocdepth: 1
Changelog
=========
{changelog}

223
help/en/conf.py Normal file
View File

@@ -0,0 +1,223 @@
# -*- coding: utf-8 -*-
#
# dupeGuru documentation build configuration file, created by
# sphinx-quickstart on Wed Jan 12 13:20:15 2011.
#
# This file is execfile()d with the current directory set to its containing dir.
#
# Note that not all possible configuration values are present in this
# autogenerated file.
#
# All configuration values have a default; values that are commented out
# serve to show the default.
import sys, os
# If extensions (or modules to document with autodoc) are in another directory,
# add these directories to sys.path here. If the directory is relative to the
# documentation root, use os.path.abspath to make it absolute, like shown here.
#sys.path.insert(0, os.path.abspath('.'))
# -- General configuration -----------------------------------------------------
# If your documentation needs a minimal Sphinx version, state it here.
#needs_sphinx = '1.0'
# Add any Sphinx extension module names here, as strings. They can be extensions
# coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
extensions = []
# Add any paths that contain templates here, relative to this directory.
templates_path = ['_templates']
# The suffix of source filenames.
source_suffix = '.rst'
# The encoding of source files.
#source_encoding = 'utf-8-sig'
# The master toctree document.
master_doc = 'index'
# General information about the project.
project = u'{appname}'
copyright = u'2011, Hardcoded Software'
# The version info for the project you're documenting, acts as replacement for
# |version| and |release|, also used in various other places throughout the
# built documents.
#
# The short X.Y version.
version = '{version}'
# The full version, including alpha/beta/rc tags.
release = version
edition = '{edition}'
tags.add('edition_{0}'.format(edition))
rst_epilog = u"""
.. |appname| replace:: {appname}
.. _homepage: {homepage}
"""
# The language for content autogenerated by Sphinx. Refer to documentation
# for a list of supported languages.
#language = None
# There are two options for replacing |today|: either, you set today to some
# non-false value, then it is used:
#today = ''
# Else, today_fmt is used as the format for a strftime call.
#today_fmt = '%B %d, %Y'
# List of patterns, relative to source directory, that match files and
# directories to ignore when looking for source files.
exclude_patterns = ['_build']
# The reST default role (used for this markup: `text`) to use for all documents.
#default_role = None
# If true, '()' will be appended to :func: etc. cross-reference text.
#add_function_parentheses = True
# If true, the current module name will be prepended to all description
# unit titles (such as .. function::).
#add_module_names = True
# If true, sectionauthor and moduleauthor directives will be shown in the
# output. They are ignored by default.
#show_authors = False
# The name of the Pygments (syntax highlighting) style to use.
pygments_style = 'sphinx'
# A list of ignored prefixes for module index sorting.
#modindex_common_prefix = []
# -- Options for HTML output ---------------------------------------------------
# The theme to use for HTML and HTML Help pages. See the documentation for
# a list of builtin themes.
html_theme = 'default'
# Theme options are theme-specific and customize the look and feel of a theme
# further. For a list of options available for each theme, see the
# documentation.
#html_theme_options = {}
# Add any paths that contain custom themes here, relative to this directory.
#html_theme_path = []
# The name for this set of Sphinx documents. If None, it defaults to
# "<project> v<release> documentation".
#html_title = None
# A shorter title for the navigation bar. Default is the same as html_title.
#html_short_title = None
# The name of an image file (relative to this directory) to place at the top
# of the sidebar.
#html_logo = None
# The name of an image file (within the static path) to use as favicon of the
# docs. This file should be a Windows icon file (.ico) being 16x16 or 32x32
# pixels large.
#html_favicon = None
# Add any paths that contain custom static files (such as style sheets) here,
# relative to this directory. They are copied after the builtin static files,
# so a file named "default.css" will overwrite the builtin "default.css".
html_static_path = ['_static']
# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
# using the given strftime format.
#html_last_updated_fmt = '%b %d, %Y'
# If true, SmartyPants will be used to convert quotes and dashes to
# typographically correct entities.
#html_use_smartypants = True
# Custom sidebar templates, maps document names to template names.
#html_sidebars = {}
# Additional templates that should be rendered to pages, maps page names to
# template names.
#html_additional_pages = {}
# If false, no module index is generated.
html_domain_indices = False
# If false, no index is generated.
html_use_index = False
# If true, the index is split into individual pages for each letter.
#html_split_index = False
# If true, links to the reST sources are added to the pages.
html_show_sourcelink = False
# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
#html_show_sphinx = True
# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
#html_show_copyright = True
# If true, an OpenSearch description file will be output, and all pages will
# contain a <link> tag referring to it. The value of this option must be the
# base URL from which the finished HTML is served.
#html_use_opensearch = ''
# This is the file name suffix for HTML files (e.g. ".xhtml").
#html_file_suffix = None
# Output file base name for HTML help builder.
htmlhelp_basename = 'dupeGurudoc'
# -- Options for LaTeX output --------------------------------------------------
# The paper size ('letter' or 'a4').
#latex_paper_size = 'letter'
# The font size ('10pt', '11pt' or '12pt').
#latex_font_size = '10pt'
# Grouping the document tree into LaTeX files. List of tuples
# (source start file, target name, title, author, documentclass [howto/manual]).
latex_documents = [
('index', 'dupeGuru.tex', u'dupeGuru Documentation',
u'Hardcoded Software', 'manual'),
]
# The name of an image file (relative to this directory) to place at the top of
# the title page.
#latex_logo = None
# For "manual" documents, if this is true, then toplevel headings are parts,
# not chapters.
#latex_use_parts = False
# If true, show page references after internal links.
#latex_show_pagerefs = False
# If true, show URL addresses after external links.
#latex_show_urls = False
# Additional stuff for the LaTeX preamble.
#latex_preamble = ''
# Documents to append as an appendix to all manuals.
#latex_appendices = []
# If false, no module index is generated.
#latex_domain_indices = True
# -- Options for manual page output --------------------------------------------
# One entry per manual page. List of tuples
# (source start file, name, description, authors, manual section).
man_pages = [
('index', 'dupeguru', u'dupeGuru Documentation',
[u'Hardcoded Software'], 1)
]

24
help/en/credits.rst Normal file
View File

@@ -0,0 +1,24 @@
Credits
=======
Below is the list of people who contributed, directly or indirectly to dupeGuru.
| **Virgil Dupras, Developer** (`Website <http://www.hardcoded.net>`__)
| **Jérôme Cantin, Icon designer**
| Icons in dupeGuru are from him
| **Python, Programming language** (`Website <http://www.python.org>`__)
| The bestest of the bests
| **PyObjC, Python-to-Cocoa bridge** (`Website <http://pyobjc.sourceforge.net>`__)
| Used for the Mac OS X version
| **PyQt, Python-to-Qt bridge** (`Website <http://www.riverbankcomputing.co.uk>`__)
| Used for the Windows version
| **Sparkle, Auto-update library** (`Website <http://andymatuschak.org/pages/sparkle>`__)
| Used for the Mac OS X version
| **You, dupeGuru user**
| You rock.

21
help/en/directories.rst Normal file
View File

@@ -0,0 +1,21 @@
Directories
===========
There is a panel in dupeGuru called **Directories**. You can open it by clicking on the **Directories** button. This directory contains the list of the directories that will be scanned when you click on **Start Scanning**.
This panel is quite straightforward to use. If you want to add a directory, click on **Add**. If you added directories before, a popup menu with a list of recent directories you added will pop. You can click on one of them to add it directly to your list. If you click on the first item of the popup menu, **Add New Directory...**, you will be prompted for a directory to add. If you never added a directory, no menu will pop and you will directly be prompted for a new directory to add.
To remove a directory, select the directory to remove and click on **Remove**. If a subdirectory is selected when you click remove, the selected directory will be set to **excluded** state (see below) instead of being removed.
Directory states
----------------
Every directory can be in one of these 3 states:
* **Normal:** Duplicates found in these directories can be deleted.
* **Reference:** Duplicates found in this directory **cannot** be deleted. Files in reference directories will be in a blue color in the results.
* **Excluded:** Files in this directory will not be included in the scan.
The default state of a directory is, of course, **Normal**. You can use **Reference** state for a directory if you want to be sure that you won't delete any file from it.
When you set the state of a directory, all subdirectories of this directory automatically inherit this state unless you explicitly set a subdirectory's state.

126
help/en/faq.rst Normal file
View File

@@ -0,0 +1,126 @@
Frequently Asked Questions
==========================
What is |appname|?
------------------
.. only:: edition_se
dupeGuru is a tool to find duplicate files on your computer. It can scan either filenames or content. The filename scan features a fuzzy matching algorithm that can find duplicate filenames even when they are not exactly the same.
.. only:: edition_me
dupeGuru Music Edition is a tool to find duplicate songs in your music collection. It can base its scan on filenames, tags or content. The filename and tag scans feature a fuzzy matching algorithm that can find duplicate filenames or tags even when they are not exactly the same.
.. only:: edition_pe
dupeGuru Picture Edition (PE for short) is a tool to find duplicate pictures on your computer. Not only can it find exact matches, but it can also find duplicates among pictures of different kind (PNG, JPG, GIF etc..) and quality.
What makes it better than other duplicate scanners?
---------------------------------------------------
The scanning engine is extremely flexible. You can tweak it to really get the kind of results you want. You can read more about dupeGuru tweaking option at the :doc:`Preferences page <preferences>`.
How safe is it to use dupeGuru?
-------------------------------
Very safe. dupeGuru has been designed to make sure you don't delete files you didn't mean to delete. First, there is the reference directory system that lets you define directories where you absolutely **don't** want dupeGuru to let you delete files there, and then there is the group reference system that makes sure that you will **always** keep at least one member of the duplicate group.
What are the demo limitations of dupeGuru?
------------------------------------------
None, |appname| is `Fairware <http://open.hardcoded.net/about/>`_.
The mark box of a file I want to delete is disabled. What must I do?
--------------------------------------------------------------------
You cannot mark the reference (The first file) of a duplicate group. However, what you can do is to promote a duplicate file to reference. Thus, if a file you want to mark is reference, select a duplicate file in the group that you want to promote to reference, and click on **Actions-->Make Selected Reference**. If the reference file is from a reference directory (filename written in blue letters), you cannot remove it from the reference position.
I have a directory from which I really don't want to delete files.
------------------------------------------------------------------
If you want to be sure that dupeGuru will never delete file from a particular directory, just open the **Directories panel**, select that directory, and set its state to **Reference**.
What is this '(X discarded)' notice in the status bar?
------------------------------------------------------
In some cases, some matches are not included in the final results for security reasons. Let me use an example. We have 3 file: A, B and C. We scan them using a low filter hardness. The scanner determines that A matches with B, A matches with C, but B does **not** match with C. Here, dupeGuru has kind of a problem. It cannot create a duplicate group with A, B and C in it because not all files in the group would match together. It could create 2 groups: one A-B group and then one A-C group, but it will not, for security reasons. Lets think about it: If B doesn't match with C, it probably means that either B, C or both are not actually duplicates. If there would be 2 groups (A-B and A-C), you would end up delete both B and C. And if one of them is not a duplicate, that is really not what you want to do, right? So what dupeGuru does in a case like this is to discard the A-C match (and adds a notice in the status bar). Thus, if you delete B and re-run a scan, you will have a A-C match in your next results.
I want to mark all files from a specific directory. What can I do?
------------------------------------------------------------------
Enable the :doc:`Power Marker <power_marker>` mode and click on the Directory column to sort your duplicates by Directory. It will then be easy for you to select all duplicates from the same directory, and then press Space to mark all selected duplicates.
I want to remove all files that are more than 300 KB away from their reference file. What can I do?
---------------------------------------------------------------------------------------------------
* Enable the :doc:`Power Marker <power_marker>` mode.
* Enable the **Delta Values** mode.
* Click on the "Size" column to sort the results by size.
* Select all duplicates below -300.
* Click on **Remove Selected from Results**.
* Select all duplicates over 300.
* Click on **Remove Selected from Results**.
I want to make my latest modified files reference files. What can I do?
-----------------------------------------------------------------------
* Enable the :doc:`Power Marker <power_marker>` mode.
* Enable the **Delta Values** mode.
* Click on the "Modification" column to sort the results by modification date.
* Click on the "Modification" column again to reverse the sort order (see Power Marker page to know why).
* Select all duplicates over 0.
* Click on **Make Selected Reference**.
I want to mark all duplicates containing the word "copy". How do I do that?
-------------------------------------------------------------------------------------
* **Windows**: Click on **Actions --> Apply Filter**, then type "copy", then click OK.
* **Mac OS X**: Type "copy" in the "Filter" field in the toolbar.
* Click on **Mark --> Mark All**.
(ME) I want to remove all songs that are more than 3 seconds away from their reference file. What can I do?
-----------------------------------------------------------------------------------------------------------
* Enable the :doc:`Power Marker <power_marker>` mode.
* Enable the **Delta Values** mode.
* Click on the "Time" column to sort the results by time.
* Select all duplicates below -00:03.
* Click on **Remove Selected from Results**.
* Select all duplicates over 00:03.
* Click on **Remove Selected from Results**.
(ME) I want to make my highest bitrate songs reference files. What can I do?
----------------------------------------------------------------------------
* Enable the :doc:`Power Marker <power_marker>` mode.
* Enable the **Delta Values** mode.
* Click on the "Bitrate" column to sort the results by bitrate.
* Click on the "Bitrate" column again to reverse the sort order (see Power Marker page to know why).
* Select all duplicates over 0.
* Click on **Make Selected Reference**.
(ME) I don't want [live] and [remix] versions of my songs counted as duplicates. How do I do that?
--------------------------------------------------------------------------------------------------
If your comparison threshold is low enough, you will probably end up with live and remix versions of your songs in your results. There's nothing you can do to prevent that, but there's something you can do to easily remove them from your results after the scan: post-scan filtering. If, for example, you want to remove every song with anything inside square brackets []:
* **Windows**: Click on **Actions --> Apply Filter**, then type "[*]", then click OK.
* **Mac OS X**: Type "[*]" in the "Filter" field in the toolbar.
* Click on **Mark --> Mark All**.
* Click on **Actions --> Remove Selected from Results**.
I tried to send my duplicates to Trash, but dupeGuru is telling me it can't do it. Why? What can I do?
------------------------------------------------------------------------------------------------------
Most of the time, the reason why dupeGuru can't send files to Trash is because of file permissions. You need *write* permissions on files you want to send to Trash. If you're not familiar with the command line, you can use utilities such as `BatChmod <http://macchampion.com/arbysoft/BatchMod>`_ to fix your permissions.
If dupeGuru still gives you troubles after fixing your permissions, there have been some cases where using "Move Marked to..." as a workaround did the trick. So instead of sending your files to Trash, you send them to a temporary folder with the "Move Marked to..." action, and then you delete that temporary folder manually.
.. only:: edition_pe
If you're trying to delete *iPhoto* pictures, then the reason for the failure is different. The deletion fails because dupeGuru can't communicate with iPhoto. Be aware that for the deletion to work correctly, you're not supposed to play around iPhoto while dupeGuru is working. Also, sometimes, the Applescript system doesn't seem to know where to find iPhoto to launch it. It might help in these cases to launch iPhoto *before* you send your duplicates to Trash.
If all of this fail, `contact HS support <http://www.hardcoded.net/support>`_, we'll figure it out.

28
help/en/index.rst Normal file
View File

@@ -0,0 +1,28 @@
|appname| help
===============
.. only:: edition_se or edition_me
|appname| is a tool to find duplicate files on your computer. It can scan either filenames or contents. The filename scan features a fuzzy matching algorithm that can find duplicate filenames even when they are not exactly the same.
.. only:: edition_pe
dupeGuru Picture Edition (PE for short) is a tool to find duplicate pictures on your computer. Not only can it find exact matches, but it can also find duplicates among pictures of different kind (PNG, JPG, GIF etc..) and quality.
Although dupeGuru can easily be used without documentation, reading this file will help you to master it. If you are looking for guidance for your first duplicate scan, you can take a look at the :doc:`Quick Start <quick_start>` section.
It is a good idea to keep |appname| updated. You can download the latest version on its `homepage`_.
Contents:
.. toctree::
:maxdepth: 2
quick_start
directories
preferences
results
power_marker
faq
changelog
credits

31
help/en/power_marker.rst Normal file
View File

@@ -0,0 +1,31 @@
Power Marker
============
You will probably not use the Power Marker feature very often, but if you get into a situation where you need it, you will be pretty happy that this feature exists.
What is it?
-----------
When the Power Marker mode is enabled, the duplicates are shown without their respective reference file. You can select, mark and sort this list, just like in normal mode.
So, what is it for?
-------------------
The dupeGuru results, when in normal mode, are sorted according to duplicate groups' **reference file**. This means that if you want, for example, to mark all duplicates with the "exe" extension, you cannot just sort the results by "Kind" to have all exe duplicates together because a group can be composed of more than one kind of files. That is where Power Marker comes into play. To mark all your "exe" duplicates, you just have to:
* Enable the Power marker mode.
* Add the "Kind" column with the "Columns" menu.
* Click on that "Kind" column to sort the list by kind.
* Locate the first duplicate with a "exe" kind.
* Select it.
* Scroll down the list to locate the last duplicate with a "exe" kind.
* Hold Shift and click on it.
* Press Space to mark all selected duplicates.
Power Marker and delta values
-----------------------------
The Power Marker unveil its true power when you use it with the **Delta Values** switch turned on. When you turn it on, relative values will be displayed instead of absolute ones. So if, for example, you want to remove from your results all duplicates that are more than 300 KB away from their reference, you could sort the Power Marker by Size, select all duplicates under -300 in the Size column, delete them, and then do the same for duplicates over 300 at the bottom of the list.
You could also use it to change the reference priority of your duplicate list. When you make a fresh scan, if there are no reference directories, the reference file of every group is the biggest file. If you want to change that, for example, to the latest modification time, you can sort the Power Marker by modification time in **descending** order, select all duplicates with a modification time delta value higher than 0 and click on **Make Selected Reference**. The reason why you must make the sort order descending is because if 2 files among the same duplicate group are selected when you click on **Make Selected Reference**, only the first of the list will be made reference, the other will be ignored. And since you want the last modified file to be reference, having the sort order descending assures you that the first item of the list will be the last modified.

59
help/en/preferences.rst Normal file
View File

@@ -0,0 +1,59 @@
Preferences
===========
.. only:: edition_se
**Scan Type:** This option determines what aspect of the files will be compared in the duplicate scan. If you select **Filename**, dupeGuru will compare every filenames word-by-word and, depending on the other settings below, it will determine if enough words are matching to consider 2 files duplicates. If you select **Content**, only files with the exact same content will match.
**Filter Hardness:** If you chose the **Filename** scan type, this option determines how similar two filenames must be for dupeGuru to consider them duplicates. If the filter hardness is, for example 80, it means that 80% of the words of two filenames must match. To determine the matching percentage, dupeGuru first counts the total number of words in **both** filenames, then count the number of words matching (every word matching count as 2), and then divide the number of words matching by the total number of words. If the result is higher or equal to the filter hardness, we have a duplicate match. For example, "a b c d" and "c d e" have a matching percentage of 57 (4 words matching, 7 total words).
.. only:: edition_me
**Scan Type:** This option determines what aspect of the files will be compared in the duplicate scan. The nature of the duplicate scan varies greatly depending on what you select for this option.
* **Filename:** Every song will have its filename split into words, and then every word will be compared to compute a matching percentage. If this percentage is higher or equal to the **Filter Hardness** (see below for more details), dupeGuru will consider the 2 songs duplicates.
* **Filename - Fields:** Like **Filename**, except that once filename have been split into words, these words are then grouped into fields. The field separator is " - ". The final matching percentage will be the lowest matching percentage among the fields. Thus, "An Artist - The Title" and "An Artist - Other Title" would have a matching percentage of 50 (With a **Filename** scan, it would be 75).
* **Filename - Fields (No Order):** Like **Filename - Fields**, except that field order doesn't matter. For example, "An Artist - The Title" and "The Title - An Artist" would have a matching percentage of 100 instead of 0.
* **Tags:** This method reads the tag (metadata) of every song and compare their fields. This method, like the **Filename - Fields**, considers the lowest matching field as its final matching percentage.
* **Content:** This scan method use the actual content of the songs to determine which are duplicates. For 2 songs to match with this method, they must have the **exact same content**.
* **Audio Content:** Same as content, but only the audio content is compared (without metadata).
**Filter Hardness:** If you chose a filename or tag based scan type, this option determines how similar two filenames/tags must be for dupeGuru to consider them duplicates. If the filter hardness is, for example 80, it means that 80% of the words of two filenames must match. To determine the matching percentage, dupeGuru first counts the total number of words in **both** filenames, then count the number of words matching (every word matching count as 2), and then divide the number of words matching by the total number of words. If the result is higher or equal to the filter hardness, we have a duplicate match. For example, "a b c d" and "c d e" have a matching percentage of 57 (4 words matching, 7 total words).
**Tags to scan:** When using the **Tags** scan type, you can select the tags that will be used for comparison.
.. only:: edition_se or edition_me
**Word weighting:** If you chose the **Filename** scan type, this option slightly changes how matching percentage is calculated. With word weighting, instead of having a value of 1 in the duplicate count and total word count, every word have a value equal to the number of characters they have. With word weighting, "ab cde fghi" and "ab cde fghij" would have a matching percentage of 53% (19 total characters, 10 characters matching (4 for "ab" and 6 for "cde")).
**Match similar words:** If you turn this option on, similar words will be counted as matches. For example "The White Stripes" and "The White Stripe" would have a match % of 100 instead of 66 with that option turned on. **Warning:** Use this option with caution. It is likely that you will get a lot of false positives in your results when turning it on. However, it will help you to find duplicates that you wouldn't have found otherwise. The scan process also is significantly slower with this option turned on.
.. only:: edition_pe
**Filter Hardness:** The higher is this setting, the "harder" is the filter (In other words, the less results you get). Most pictures of the same quality match at 100% even if the format is different (PNG and JPG for example.). However, if you want to make a PNG match with a lower quality JPG, you will have to set the filer hardness to lower than 100. The default, 95, is a sweet spot.
**Match scaled pictures together:** If you check this box, pictures of different dimensions will be allowed in the same duplicate group.
**Can mix file kind:** If you check this box, duplicate groups are allowed to have files with different extensions. If you don't check it, well, they aren't!
**Ignore duplicates hardlinking to the same file:** If this option is enabled, dupeGuru will verify duplicates to see if they refer to the same `inode <http://en.wikipedia.org/wiki/Inode>`_. If they do, they will not be considered duplicates. (Only for OS X and Linux)
**Use regular expressions when filtering:** If you check this box, the filtering feature will treat your filter query as a **regular expression**. Explaining them is beyond the scope of this document. A good place to start learning it is `regular-expressions.info <http://www.regular-expressions.info>`_.
**Remove empty folders after delete or move:** When this option is enabled, folders are deleted after a file is deleted or moved and the folder is empty.
**Copy and Move:** Determines how the Copy and Move operations (in the Action menu) will behave.
* **Right in destination:** All files will be sent directly in the selected destination, without trying to recreate the source path at all.
* **Recreate relative path:** The source file's path will be re-created in the destination directory up to the root selection in the Directories panel. For example, if you added ``/Users/foobar/SomeFolder`` to your Directories panel and you move ``/Users/foobar/SomeFolder/SubFolder/SomeFile.ext`` to the destination ``/Users/foobar/MyDestination``, the final destination for the file will be ``/Users/foobar/MyDestination/SubFolder`` (``SomeFolder`` has been trimmed from source's path in the final destination.).
* **Recreate absolute path:** The source file's path will be re-created in the destination directory in it's entirety. For example, if you move ``/Users/foobar/SomeFolder/SubFolder/SomeFile.ext`` to the destination ``/Users/foobar/MyDestination``, the final destination for the file will be ``/Users/foobar/MyDestination/Users/foobar/SomeFolder/SubFolder``.
In all cases, dupeGuru nicely handles naming conflicts by prepending a number to the destination filename if the filename already exists in the destination.
**Custom Command:** This preference determines the command that will be invoked by the "Invoke Custom Command" action. You can invoke any external application through this action. This can be useful if, for example, you have a nice diffing application installed.
The format of the command is the same as what you would write in the command line, except that there are 2 placeholders: **%d** and **%r**. These placeholders will be replaced by the path of the selected dupe (%d) and the path of the selected dupe's reference file (%r).
If the path to your executable contains space characters, you should enclose it in "" quotes. You should also enclose placeholders in quotes because it's very possible that paths to dupes and refs will contain spaces. Here's an example custom command::
"C:\Program Files\SuperDiffProg\SuperDiffProg.exe" "%d" "%r"

15
help/en/quick_start.rst Normal file
View File

@@ -0,0 +1,15 @@
Quick Start
===========
To get you quickly started with dupeGuru, let's just make a standard scan using default preferences.
* Click on **Directories**.
* Click on **Add**.
* Choose a directory you want to scan for duplicates.
* Click on **Start Scanning**.
* Wait until the scan process is over.
* Look at every duplicate (The files that are indented) and verify that it is indeed a duplicate to the group's reference (The file above the duplicate that is not indented and have a disabled mark box).
* If a file is a false duplicate, select it and click on **Actions-->Remove Selected from Results**.
* Once you are sure that there is no false duplicate in your results, click on **Edit-->Mark All**, and then **Actions-->Send Marked to Recycle bin**.
That is only a basic scan. There are a lot of tweaking you can do to get different results and several methods of examining and modifying your results. To know about them, just read the rest of this help file.

72
help/en/results.rst Normal file
View File

@@ -0,0 +1,72 @@
Results
=======
When dupeGuru is finished scanning for duplicates, it will show its results in the form of duplicate group list.
About duplicate groups
----------------------
A duplicate group is a group of files that all match together. Every group has a **reference file** and one or more **duplicate files**. The reference file is the first file of the group. Its mark box is disabled. Below it, and indented, are the duplicate files.
You can mark duplicate files, but you can never mark the reference file of a group. This is a security measure to prevent dupeGuru from deleting not only duplicate files, but their reference. You sure don't want that, do you?
What determines which files are reference and which files are duplicates is first their directory state. A files from a reference directory will always be reference in a duplicate group. If all files are from a normal directory, the size determine which file will be the reference of a duplicate group. dupeGuru assumes that you always want to keep the biggest file, so the biggest files will take the reference position.
You can change the reference file of a group manually. To do so, select the duplicate file you want to promote to reference, and click on **Actions-->Make Selected Reference**.
Reviewing results
-----------------
Although you can just click on **Edit-->Mark All** and then **Actions-->Send Marked to Recycle bin** to quickly delete all duplicate files in your results, it is always recommended to review all duplicates before deleting them.
To help you reviewing the results, you can bring up the **Details panel**. This panel shows all the details of the currently selected file as well as its reference's details. This is very handy to quickly determine if a duplicate really is a duplicate. You can also double-click on a file to open it with its associated application.
If you have more false duplicates than true duplicates (If your filter hardness is very low), the best way to proceed would be to review duplicates, mark true duplicates and then click on **Actions-->Send Marked to Recycle bin**. If you have more true duplicates than false duplicates, you can instead mark all files that are false duplicates, and use **Actions-->Remove Marked from Results**.
Marking and Selecting
---------------------
A **marked** duplicate is a duplicate with the little box next to it having a check-mark. A **selected** duplicate is a duplicate being highlighted. The multiple selection actions can be performed in dupeGuru in the standard way (Shift/Command/Control click). You can toggle all selected duplicates' mark state by pressing **space**.
Delta Values
------------
If you turn this switch on, some columns will display the value relative to the duplicate's reference instead of the absolute values. These delta values will also be displayed in a different color so you can spot them easily. For example, if a duplicate is 1.2 MB and its reference is 1.4 MB, the Size column will display -0.2 MB. This option is a killer feature when combined with the :doc:`Power Marker <power_marker>`.
Filtering
---------
dupeGuru supports post-scan filtering. With it, you can narrow down your results so you can perform actions on a subset of it. For example, you could easily mark all duplicates with their filename containing "copy" from your results using the filter.
**Windows:** To use the filtering feature, click on Actions --> Apply Filter, write down the filter you want to apply and click OK. To go back to unfiltered results, click on Actions --> Cancel Filter.
**Mac OS X:** To use the filtering feature, type your filter in the "Filter" search field in the toolbar. To go back to unfiltered result, blank out the field, or click on the "X".
In simple mode (the default mode), whatever you type as the filter is the string used to perform the actual filtering, with the exception of one wildcard: **\***. Thus, if you type "[*]" as your filter, it will match anything with [] brackets in it, whatever is in between those brackets.
For more advanced filtering, you can turn "Use regular expressions when filtering" on. The filtering feature will then use **regular expressions**. A regular expression is a language for matching text. Explaining them is beyond the scope of this document. A good place to start learning it is `regular-expressions.info <http://www.regular-expressions.info>`_.
Matches are case insensitive in both simple and regexp mode.
For the filter to match, your regular expression don't have to match the whole filename, it just have to contain a string matching the expression.
You might notice that not all duplicates in the filtered results will match your filter. That is because as soon as one single duplicate in a group matches the filter, the whole group stays in the results so you can have a better view of the duplicate's context. However, non-matching duplicates are in "reference mode". Therefore, you can perform actions like Mark All and be sure to only mark filtered duplicates.
Action Menu
-----------
* **Start Duplicate Scan:** Starts a new duplicate scan.
* **Clear Ignore List:** Remove all ignored matches you added. You have to start a new scan for the newly cleared ignore list to be effective.
* **Export Results to XHTML:** Take the current results, and create an XHTML file out of it. The columns that are visible when you click on this button will be the columns present in the XHTML file. The file will automatically be opened in your default browser.
* **Send Marked to Trash:** Send all marked duplicates to trash, obviously.
* **Delete Marked and Replace with Hardlinks:** Sends all marked duplicates to trash, but after having done that, the deleted files are replaced by a `hard link <http://en.wikipedia.org/wiki/Hard_link>`_ to the reference file. (Only for OS X and Linux)
* **Move Marked to...:** Prompt you for a destination, and then move all marked files to that destination. Source file's path might be re-created in destination, depending on the "Copy and Move" preference.
* **Copy Marked to...:** Prompt you for a destination, and then copy all marked files to that destination. Source file's path might be re-created in destination, depending on the "Copy and Move" preference.
* **Remove Marked from Results:** Remove all marked duplicates from results. The actual files will not be touched and will stay where they are.
* **Remove Selected from Results:** Remove all selected duplicates from results. Note that all selected reference files will be ignored, only duplicates can be removed with this action.
* **Make Selected Reference:** Promote all selected duplicates to reference. If a duplicate is a part of a group having a reference file coming from a reference directory (in blue color), no action will be taken for this duplicate. If more than one duplicate among the same group are selected, only the first of each group will be promoted.
* **Add Selected to Ignore List:** This first removes all selected duplicates from results, and then add the match of that duplicate and the current reference in the ignore list. This match will not come up again in further scan. The duplicate itself might come back, but it will be matched with another reference file. You can clear the ignore list with the Clear Ignore List command.
* **Open Selected with Default Application:** Open the file with the application associated with selected file's type.
* **Reveal Selected in Finder:** Open the folder containing selected file.
* **Invoke Custom Command:** Invokes the external application you've set up in your preferences using the current selection as arguments in the invocation.
* **Rename Selected:** Prompts you for a new name, and then rename the selected file.