Locate32 v3.1 RC3l build 10.8220
Copyright (C) 1997-2010 Janne Huttunen <janne.huttunen@locate32.net>
***************************************************************
Contains
========
0. About this release
1. Using Locate
2. License
3. Requirements
4. Installation and uninstallation
5. Problems with the help file
6. Acknowledgements
7. Release notes
0. About this release
If you found a bug, please use Locate32 flyspray (http://www.locate32.net/flyspray) to report it.
Please check the existing reports first to see if someone else has already reported the same problem.
Try to add a detailed description about what you have done and how that the crash/bug can be repeated
(e.g., did you use locate32.exe, locate.exe, or updtdb32.exe, your operating system, the exact strings
what you have used for searching, exact error messages, what happened and what you expected to happen
(this is not always clear)).
1. Using Locate
Locate is a program that can be used to find files from your hard disks. Before you
can use program you must create a database containing file names. To create a database,
use choose Update databases in locate32.exe or run updtdb32.exe. Check Databases tab in
Settings dialog, for example, to index more drives than local drives.
For more help run updtdb32 -h or locate -h.
2. License
The program is distributed under the terms of the "BSD" licence, as specified
below.
THE "BSD" LICENCE
-----------------
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
* Redistributions of source code must retain the above copyright notice,
this list of conditions and the following disclaimer.
* Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.
* The name author may be used to endorse or
promote products derived from this software without specific prior
written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE.
3. Requirements
Program requires Windows 98, Windows NT 4.0 or later.
To retrieve image dimensions (uses imghnd.dll), GDI+ must be installed (by default it is
included only to Windows XP or later). To install GDI+ to your system, download a correct patch
from microsoft.com.
If GDI+ is not installed, "gdiplus.dll file does not found" error message may appear when imghnd.dll
is tried to be loaded. To prevent this set registry key "Load imagehandler" to 0 (dword value)
in HKEY_CURRENT_USER\Software\Update\Locate32.
4. Installation and uninstallation
To install this program execute the installer (locate32-XXX.exe packages) or extract
file into some directory (XXX.zip packages). To uninstall the program, open Control Panel and
select Add/Remove Programs. Select Locate and press Add/Remove button.
You can modify installation routine as follows. The installation program has the
following command line arguments:
-w don't show wizard
-q don't show installation progress dialogs
-d file read installation options from file
Options "-w" and "-q" combined together does not show any dialogs or message boxes, unless
an error occur. For "-d", a file is a text file, for example, of the form:
[VARIABLES]
#Destination path
DESTINATIONPATH=%p\Locate32
# Icon group
ICONGROUP=Locate
# User's own icon group or all user
ICONUSERGROUP=FALSE
# Don't show frame
SHOWFRAME=FALSE
# Check boxes
DESKTOPICONS=FALSE
QUICKBARICONS=TRUE
REGENTRIES=TRUE
OPENREADME=FALSE
EXECUTELOCATE32=FALSE
EXECUTEUPDTDB32=FALSE
RUNATSTARTUP=FALSE
UPDATEATSTARTUP=FALSE
[SELECTIONS]
LOCATE32=TRUE
LOCATE=TRUE
UPDTDB32=TRUE
LANEN=TRUE
5. Problems with the help file
Users have been notified that the chm help file cannot be viewed on Windows systems.
This problem is probable related on the Windows security update 896358 which may block
the chm file. To unblock the help file, run Windows Explorer and choose Locate32's directory,
right-click on locate32.chm file, select Properties from the popup menu, click on the Unblock
button below the Advanced button on the General page and click Apply button.
For more information, see:
http://support.microsoft.com/kb/902225/
6. Acknowledgements
Regular expression support is provided by the PCRE (Perl Compatible Regular
Expressions) library package, which is an open source software, written by Philip Hazel,
and copyright by the University of Cambridge, England. PCRE is available in:
ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/
MD5 sums (RFC 1321, http://userpages.umbc.edu/~mabzug1/cs/md5/md5.html) are computed using
L. Peter Deutsch's (ghost@aladdin.com) implementation of MD5 Algorithm.
Program uses Martin Pool's strnatcasecmp and strnatcmp functions (http://sourcefrog.net/projects/natsort/) to
compare items in the results list using natural ordering when an alternative funtion from shell is not available
(e.g. in Win2k) or if the search is case sensitive.
The installation program uses bzip2 version 1.0.3 by Julian Seward (jseward@acm.org).
The locate logo shown in the About dialog is made by Fredrik Bränström. The high color
icons are made by Hexaae. Thank you both!
7. Release notes
The list of changes between releases:
3.1.10.8220 (preRC4):
- Loading comments from descript.ion file
- Tooltips shows more informatin (database, title, author, description, comments, file and product version)
- Templates for "File/Save Results" (see some example template file in templates directory)
- "Save data to clipboard" (Special submenu): same options to format data as with Save Results
- It is possible to use keyboard shortcuts to open specifig tab in the settings dialog
- It is possible to open context menu for parent folder (a new option for "Open context menu"-subaction).
This is not yet assigned by default, so go to "View / Select details" or keyboard shortcut settings to assign it.
- Slashes '/' given in directory names are replaces with back slashes '\' (e.g. "Named:" and
"Look in:" fields and in parameters of locate.exe)
- Added Stop button to the update tooltip
- Added "Update title bar when executing search" option (Advanced settings) for instant searching
- Added "Enable shell extension fix" option to Advanced settings. Can be tryed if unexpected crashes occur
- Added new command line arguments for Locate32.exe: '-nf' clears "Named:" field, '-nt' sets
"Type:" to "(no extension)" ('-t ""' can new be used to clear "Type" field), and '-P0',
'-P1', ... can be used to choose 'Everywhere' in 'Look in' (see the help file for more information).
- Added "Update databases of selected files" to Special menu
- New icons (thanks to Hexaae) and loading some icons from shell32.dll and imageres.dll
- Fixed: locate.exe now understands, say, -t "exe com txt"
- Fixed: "Open Containing folder" and "Special"-menu were missing in simple File MenuCommand
- Fixed: problem with filesizes over 4GB in minimum/maximum when bytes are used
- Fixed: Up and Down buttons in Save Results
- Fixed: "Add Folder" button in database options allows now to specify computers
- Fixed: error related to PCRE and UTF8 when searching folder names
- Fixed: date format errors
- Fixed: applications hangs if "Browse" pressed several times
- Fixed: locate.exe output encoding wrong with some Unicode characters
- Fixed: "updtdb32.exe -d database.dbs" updating network share containing '$'
- Fixed: handling files before 1.1.1980 was arbitrary
- Some other fixes and changes
3.1.8.9210 (RC3):
- Options menu renamed to Tools and "Delete Private data" feature added
- Added a notification message when language is changed, language settings tab shows version for translations
- Stop button enabled with search while typing
- Preliminary support for template files in "Save Results" (see templates directory)
- Improved error messages in status bar (including "Search while typing")
- Fixed: when Avant Browser is used as Web Browser, "Open" in context menu do nothing
- Fixed: may work with Windows 98 and NT 4
- Fixed: renaming failed with unicode files
- Fixed (locate.exe): '-p' argument allows now '..' in directory name
3.1.8.8030 (RC2):
- Added a command line argument "-V" to select list view move
- Added possiblity temporally use selected databases with
"Find using databases" (not only one time)
- "Copy MD5 sums to clipboard" added to Special menu (under File)
- Fixed: if comma or semicolor was given in Extensions field, programs was hanged/crashed
- Fixed: command line argument "-U" caused program to crash
- Fixed: incorrect icons were shown for drives
- If directry contains an exe file and subdirectory wiht the same name, the exe file was
executed when directory was double-clicked
3.1.8.7200 (RC1):
- Wildcards * and ? are allowed in extensions
- Possible to save results using Unicode (UTF-16) or UTF-8 character sets
- If several directories are given in "Look In:" (or the given directory contains ';'), selecting directory
using Browse button won't replace the directories in "Look In:" but adds the selected directory to end
- For the command in "Use another program to open directories", %f added to mean the selected file (e.g.,
can be used with Total Commander so that the selected file is also selected in TC when "Open containing folder" is chosen.
- New option "Prevent moving tooltips (use if tooltips steal focus)" in Advanced settings (see the help file for meaning)
- Fixed: searches failed if file name has uppercase characters
- Some other minor improvements and fixes (error messages, ...)
3.1.8.6150:
- Possible to use minus '-' in "Extensions:" and "Look In:" fields to exclude extensions and directories in searches
(e.g. "-tmp -log" and "-C:\Temp")
- Possible to sort files in the results list such that digits in file names are considered as numbers (natural ordering).
Ordering method can be changed in Advanced settings (natural ordering is default from now on)
- Possible to search option in Advanced settings
- Extension column for the results list
- "Drive or directory "XXX' is unavailable ..." error message asks if you want to remove the directory from
database settings so that it won't be used in future searches
- Fixed: if directories had similar names, files in some directories of these directories may have not been not returned
3.1.8.5260:
- New options in database settings -> Advanced: "Exclude only the content of directory (directory
itself will be included)".
- Close button for the update status toolip
- Improvements to the help file: options in keyboard shortcuts and Select details dialog
- Added new "variables" (like %f and %e) for "Execute Command" action
- Some bug fixes
3.1.8.4270:
- New options in Advanced settings: "Simple File menu (no shell context menu items)"
(Miscellaneous settings) and "Search if field is changed by command line or by
shell menu" (Search as you type).
- Fixed: problems with keyboard shortcuts
- Fixed: typing unicode characters
- Fixed: when Locate32 is set to execute a file when it's clicked, drag and dropping
also opened the dropped file
- Some other fixes
3.1.8.3260:
- Thumbnails: the results list has two new modes "Large Icons" and "Extra Large Icons"
(previous "Large Icons" mode has been renamed to "Medium Icons"). These modes shown
images as a thumbnails. Thumbnails are also shown in "Medium Icons" mode if
"Show thumbnails also in "Medium Icons" mode" option in Advanced settins is enabled.
The sizes of "Large Icons" and "Extra Large Icons" modes can be changed in Advanced
settings.
- Possible to choose AND mode for default ("Use AND mode as a default" option in
Advanced settings). Use | to switch back to OR mode (e.g. "cat|dog")
- An option for scheduled updates: Delay in seconds before starting updates at startup:
- Fixed: change color and change font buttons work again, so does Help button in
the Database options dialog.
3.1.8.3220:
- Fixed: incompatibility issue with SuperCopier2
- Fixed: Alt+N and Alt+T also added 'N' and 'T' to "Named:" and "Type:" field
- Fixed: track file system changes (for the results list) will skip ntuser.dat.log file
(reduced significantly CPU usage )
- Fixed: the dialog icon was not visible always
- Changed: update status tooltip will show mapped name (if given)
3.1.8.3090:
- Windows search: protocol support: possible to use Locate32 as a default desktop search application
(requires Vista SP1). See README.txt in regs folder in the zip archive for more information.
- New option (Advanced settings): "If extension is given, file name should match to the extension"
- New option (Advanced settings): "Ask confirmatioon when "Update databases" is chosen"
- Possible to specify icon for the main dialog (a new option in Advanced settings)
- Fixed: icons glown when "Find as you type is used"
- Fixed: if Locate32 dialog was minimized when program is closed, the dialog is hidden at startup
- Some other fixes
3.1.8.2240:
- Support for junctions and symbolic links. Junctions and symbolic links referring to directories
are not scanned by default (use "&Scan directories which are junctions or symbolic links" option
in database settings to scan such directories).
- New option in Advanced settings: "Avoid to access files when reading icons". If this option
is enabled, icons are created based on given file extension and attributes instead of reading actual
file. Icons are also read this way if "Disable updating (file information from database)" is chosen
(even if "Use Simple icons" is not used).
- New options to "Pressed when:" list in the keyboard shortcuts: ´""Find as you type" is active" and
""Find as you type" is not active".
- Some fixes
3.1.8.2210:
- New option for "Find as you type": "Required characters in a search term until searching:"
- New option in Advanced settings: "Show column headers in all view modes" (Vista only)
- New feature: if you hold Ctrl down when clicking "Replace spaces with asterisks" field,
you can specify which characters are replaced
- Some other fixes and changes
3.1.8.2160:
- Improvements to "Find as you type" (previously "Search while typing)": Possible to set delay for search while typing
and option to change the focus to the result list when Up or Down key is pressed
- New option in Advanced settings: If asterisks given, search as if "Match whole name" is enabled
- Improvements to the help file: If F1 or '?' is pressed (in the settings), the help file
file is opened from the right position. Options in Advanced settings are also described.
- Several other minor changes
3.1.8.2111:
- Search while typing (enable "Enable while typing" option in Advanced settings)
- A database file name can contain %locatedir% which means the directory to which
Locate32 is installed (maybe be handy if installed on USB memory stick which drive
letter may change)
- Some minor fixes
3.0.8.1200:
- Added "Last update" column to Databases tab in the settings dialog
- When Locate32 is searching file at the same time when a database file is going to
be written, writing is delayed until searching is done.
- The range for "Locate dialog transparency" and "Transparency" (tooltips) is now 0-100.
- Fixed: "searching in file" text when ANSI codepage is used in databases.
- Fixed: Locate32 dialog hanged when first line in lookin field is UNC path to offline server
- Fixed: freezing when "Find now" is pressed at the same time when
database is written
3.0.7.12310:
- Improved parsing of Include/Exclude files pattern
- Fixed: background monitoring for the result list caused some problems
- Fixed: other fixes (crashes etc...)
3.0.7.12260:
- The help file: corrected typographical errors (thanks to Elijah Koziev), new content and
other improvements
- Fixed: updating result list items was suddenly stopped
- Fixed: lots of ???? marks in translations using cyrillic or other similar alphabets
3.0.7.12160:
- Added "Include directories pattern" to Advanced database settings.
- Fixed: locate.exe didn't work (again)
- Fixed: argument '-U' didn't work
- Fixed problems with database settings export/import
- Several other fixes
3.0.7.11250:
- Added "Include files pattern" to Advanced database settings.
- Fixed: if Locate32 dialog is maximized, the dialog will be restored if locate32.exe was executed using
some command line argument.
- Fixed: command line arguments '-P' and '-p' works now with computer name (e.g., "locate32 -P\\server")
3.0.7.11040:
- Fixed: some command line arguments for Locate32 didn't work
- Changed: renaming files using Windows style renaming is now cancelled if whole name is removed
3.0.7.9220:
- Fixed: locate.exe did not work
- Fixed: updating did loose GDI object and caused OS to hang
- Fixed: sorting commandline argument (-ld) didn't work
- Possible to enable control at startup by using command line arguments (locate32 -Ax)
3.0.7.8190:
- Fixed: When result files are executed, Locate uses the directory in which the file is
as the directory directory
- Fixed: excluded file pattern
(in database settigs) takes into account files files
3.0.7.7010:
- New option in Advanced settings: Use space as a separator for searches. If this option
is enabled, you can use space as separator.
- New option in Advanced settings: Do not show system tray icon
- Fixed: Start menu appeared when Win+F key is pressed so that Win is released before F (the solution
is "Send a key release event before Win key is handled (use with Win+F)"-option in the Advanced dialog
of the Keyboard settings, enable this option or reset Shortcuts).
- Fixed: enable checkbox didn't work in the database settings tab
3.0.7.6170:
- Help file improved.
- Fixed: Remove presets didn't work.
- Fixed: the result list lost focus if application is changed when file name was edited.
- Fixed: if search from directories "C:\Foo" and "D:\bar", files from "C:\bar" was
also returned.
3.0.7.6030
- Compressed (C) and encrypted (E) attributes are shown in attributes column
- Improvements to help system: new actions for keyboard shortcuts (Show Help for Item,
Close Help, Show Topics, Show Index, Table of Contents, Search). To get F1 key working
as usually, reset keyboard shortcuts or assign "Show Help for Item" action for F1 key.
F1 in menu will open a help page for menu item. Anyway, the help file is still quite
plain so there is help topics for only few items.
- About box is fixed.
3.0.7.5270:
- Preliminary help file.
- Logical operations + (specified string must exists in name) and - (specified string must not
exists in name). Note that you should enable "Allow logical operations (+ and -)" option in Advanced
settings.
- Fixed: export database setting to a database didn't work with databases which uses unicode
character set. Furthermore, this feature also copies the content of database
3.0.7.5130:
- Changed behaviour: *.ext will search only files with extension ext although
"Match whole name" is not chosen (not ext* as before)
- New actions in keyboard shortcuts: Stop locating or close dialog, Select N'th file,
Execute N'th file
- By default (after installation or when Reset shortcut is chosen), Ctrl+N is associated
with Activate Named: field (will also activate Name & Location tab), Ctrl+§ is associated
with Activate Result list, ESC is accosiated with Stop locating or close dialog and F3
is associated with Show dialog and path from explorer
- Some minor fixes
3.0.7.5060:
- New option: "Do not save list items in "Named", "Type" and "Look In" combos
- Fixed: empty tooltip appeared when locate32 was ran with -U argument
- Fixed: "Don't show deleted files" option didn't work
3.0.7.4220:
- Sorting improved, an option for not reading information from files while sorting
(except that information which cannot be found from database).
- A new option: "Do not resolve icon for local drives"
3.0.7.4090:
- Default database location changed! Now databases are, by default,
in X:\Documents and Settings\USERNAME\Application Data\Locate32
- Fixed: update tooltip location with multiple monitors
- Fixed: dates were not shown correctly in Autoupdate list.
- Some other fixes
3.0.7.3250:
- For each drive and directory which are included into a database, you
can specify a name which is used in the database (e.g. C: drive can be
called WINDOWS etc.). This makes possible to use same databases in several
computers, or when you have several operation systems and each OS has different
drive order.
- Several minor fixes and changes
3.0.7.2110:
- "Show dialog and path from Explorer" action for keyboard shortcuts
- Fixed: several memory leaks and open handles (those may have caused
that external drives have been prevented to be disconnected
- locate.exe: non-ascii characters have not been shown correctly
3.0.7.1210:
- Didn't work in WinNT
- Fixed problems with Select Databases dialog
- Fixed (I hope): updating failed and program needs to be closed.
3.0.7.1060:
- Final version 3.0
- Fixed some issues with Vista
- Minor fixes
For changes before the final version, see Readme file for 3.0.7.1060.
The todo list is moved to Locate32's support forum (http://www.locate32.net/forum).