Locate32 v3.1 RC3l build 10.

8220
Copyright (C) 1997-2010 Janne Huttunen <janne.huttunen@locate32.net>
***************************************************************
Contains
========
0.
1.
2.
3.
4.
5.
6.
7.

About this release

Using Locate
License
Requirements
Installation and uninstallation
Problems with the help file
Acknowledgements
Release notes

0. About this release

If you found a bug, please use Locate32 flyspray (http://www.locate32.net/flyspr
ay) to report it.
Please check the existing reports first to see if someone else has already repor
ted the same problem.
Try to add a detailed description about what you have done and how that the cras
h/bug can be repeated
(e.g., did you use locate32.exe, locate.exe, or updtdb32.exe, your operating sys
tem, the exact strings
what you have used for searching, exact error messages, what happened and what y
ou 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 da
tabase,
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 defau
lt 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 ap
pear 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 ext
ract
file into some directory (XXX.zip packages). To uninstall the program, open Cont
rol 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 box
es, 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 syst
ems.
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 o
n 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 Phili
p 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 comp
uted using
L. Peter Deutsch's (ghost@aladdin.com) implementation of MD5 Algorithm.
Program uses Martin Pool's strnatcasecmp and strnatcmp functions (http://sourcef

rog.net/projects/natsort/) to
compare items in the results list using natural ordering when an alternative fun
tion 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 Brnstrm. The high col
or
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, co
mments, file and product version)
Templates for "File/Save Results" (see some example template file in tem
plates 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 set
tings 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 t
ryed 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" fie
ld), 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 simpl
e 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 com
puters
Fixed: error related to PCRE and UTF8 when searching folder names

'$'
-

Fixed:
Fixed:
Fixed:
Fixed:

date format errors

applications hangs if "Browse" pressed several times
locate.exe output encoding wrong with some Unicode characters
"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, th
e 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 c
ontains ';'), 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 t
o mean the selected file (e.g.,
can be used with Total Commander so that the selected file is also selec
ted in TC when "Open containing folder" is chosen.
New option "Prevent moving tooltips (use if tooltips steal focus)" in Ad
vanced 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 excl
ude 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 name
s 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 th
ese 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 me
nu 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 an
d 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" opt
ion in
Advanced settings). Use | to switch back to OR mode (e.g. "cat|dog")
An option for scheduled updates: Delay in seconds before starting update
s at startup:
Fixed: change color and change font buttons work again, so does Help but
ton 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:" fi
eld
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 f
or 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 database
s" is chosen"
Possible to specify icon for the main dialog (a new option in Advanced s
ettings)
Fixed: icons glown when "Find as you type is used"
Fixed: if Locate32 dialog was minimized when program is closed, the dial
og is hidden at startup
Some other fixes
3.1.8.2240:
Support for junctions and symbolic links. Junctions and symbolic links r
eferring to directories
are not scanned by default (use "&Scan directories which are junctions o
r symbolic links" option
in database settings to scan such directories).
New option in Advanced settings: "Avoid to access files when reading ico
ns". If this option
is enabled, icons are created based on given file extension and attribut
es instead of reading actual
file. Icons are also read this way if "Disable updating (file informatio
n 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 as
terisks" 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)": P
ossible 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 set
tings)
A database file name can contain %locatedir% which means the directory t
o which
Locate32 is installed (maybe be handy if installed on USB memory stick w
hich 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 pat
h 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 simila
r 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 l
ocate32.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

ocate32

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 (l
-Ax)

3.0.7.8190:
Fixed: When result files are executed, Locate uses the directory in whic
h the file is
as the directory directory
- database
(in
Fixed:settigs)
excludedtakes
fileinto
pattern
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 rele
ased 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 na
me 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 colu
mn
Improvements to help system: new actions for keyboard shortcuts (Show He
lp 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" acti
on 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 - (speci
fied 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 data
base
3.0.7.5130:
Changed behaviour: *.ext will search only files with extension ext altho
ugh
"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), Ctr
l+ 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" com
bos
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 sever
al
computers, or when you have several operation systems and each OS has di
fferent
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/foru
m).