                             The SimFuz Manual
  ------------------------------------------------------------------------

VERSION 0.31 - Build 1


  1. What is SimFuz and how it works ?
  2. How to use SimFuz ?
  3. The history
  4. The Future of SimFuz
  5. Registering as Comerce?
  6. Discalimer
  7. The format of the listfile
  8. The Author

  ------------------------------------------------------------------------

What is SimFuz and how it works ?
SimFuz is a little free/comerce-ware Application that allows the user to
create a specific set of files and pathes to search in.
Unlike as in normal search, SimFuz searches linewise and with a simple
Fuzzy-Algorithm. So you can specify any Searchstings though you don't know
the right writing. To tell SimFuz how to differenciate, you have to specify
the minimum thershold in percent.
If you leave SimFuz with saving, the same filesset and options will be
loaded on next start, providing you are starting it from the same directory
again. SimFuz saves the fileset in a textfile named: simfzcfg.txt.
Additional there is now the possibility to search many different formats by
importing Modules (DLL). Information for programmers, on howto develop such
a DLL will be avalible on the SimFuz- Homepage.

  ------------------------------------------------------------------------

How to use SimFuz
If you are starting SimFuz you will see two listboxes and some switches.
The listbox at the bottom is called the FILELISTBOX. In fact this FILEBOX
is used to specify files or paths to be searched. They can be inserted by
using the Drag & Drop - Feature of Windows (i.e. using the Explorer),
manually by using the editfield and the Add-Button or only by using the
"..."-Button.
Before you insert a Path, you have to specify whether you will SimFuz the
path to be browsed every search or only once. For using the last methode,
you can switch the "static files"-Check. Then every path will be recursed
by the given leveldepth and the filemask for files, which then will be
inserted. Otherwise only the pathname will be inserted and the given level
and filter-parameters will be assigned.
When adding files you can turn on a check for the filetype. If it is turned
on, the "incoming" files will be compared by their extension and if they
are not known, they won't be searched.

The current acceptes types by SimFuz are:

   * Textfiles (*.txt)
   * HTML-Files (*.htm;*.html)
   * DBF- Database-Files (*.dbf)
   * DOC - Word-Files (*.doc)
   * MP3 - MPEG Layer 3 Tags version 1.1

By clicking the 'configure types'-Button below the 'Check type' - Checkbox
you will be able to suppress or enable the search of the given searchable
filetypes. Additional, there is the possibility to specify filemasks and
extensions to be searched. The configuration will be saved.

If you are using textfiles and you know that they were created on a
PC-DOS-Machine you can use the OemConvert-Switch. Very interisting for
german users who want to use old docs with "Umlaute".
Once you have specified the searchfiles you can start the search after
typing the argument and hitting the GO-Button. Additionally you can specify
the minimal compare-thershold in percent. If the "Check type"-Check is
turned on, the searched files will be converted while searching. (if they
are in known formats)

The Result will now be displayed in the RESULTBOX. By clicking on the "%",
"Filename" and "Line"-Column-Header you can sort the list by that subject.
If you click on the "Contents"-Column-Header the whole box will be adjusted
in size.

Doubleclicking on the Resultbox will cause a new opening Window, which will
display the file +100 and -100 lines of the file (highlighting the clicked
line) in a simple format.

Using the right mousebutton on the resultbox will open a Popupmenu, which
lets you start the File, clicked on, with the Shell. (i.e. Netscape
Navigator will be started on a html-File.) Otherwise you can spawn the
given file with in the 'ExtraConfigmenu' predefined program.
Furthermore the Popupmenu lets you export all the items of the resultlist
to a File.
Therefore a Dialog will be opened and you will be able to set the order and
the seperationvalue for the file.

The Extraconfig-Menu

Highlightning:
By enabling the Highlightswitch you can fast locate the position of the
found words in the text. They will be highlighted in the specified color.

Boolean Search:
Boolean search could be very helpful when searching many files for text
with more options. To bind the lowletter-search-words together simply use
'A' for And, 'O' for or and 'N' for Not-Operation. Brackets '()' must
specifiy the searchoptions since the searchstring will be interpreated fom
beginning to end.

For Example you may search a document witch have the words 'infrared' and
'serial' inside but not 'wave' or 'timer'.
Therefore the searchstring have to look like this:
'(infrared A serial) N (wave O timer)'
The allow boolean-search-switch has to be enabled for this operation.

Remember: More words will take longer to search in the documents.

Different Fonts:

For users, using different language-formats in their documents i.e. html or
doc ..., there is the possibillity to use a different font. It will be
changed in the RESULTLIST and in the Searchstringfield.

Note: SimFuz will search anyway only Standart-Ansi-Characters from the
keyboard.

Hint:
The implementation of the Doc-Files was not made using the specifications
of MS. The Algorithm only searches the largest textblock in the file.
So Maybe simple-files (like no tables and graphics in it) should be used.
Also a spontaneous shut down can be possible by enabling this stuff.
SimFuz cannot give the garantee to search the Doc and Dbf-Files correctly.

  ------------------------------------------------------------------------

The history

Major changes since Version 0.30a - Build 1 (actual is 0.31 - Build 1):

   * ability of saving the columnsize on save...

Major changes since Version 0.27b - Build 9 (actual is 0.30 - Build 1):

   * added Boolean search (And, Or, Not (supporting ()))
   * highlighting of found parts in the lines
   * reorganized inner structures of SimFuz
   * reorganized for CGI-Support!
   * removed SimpleFileViewer bug
   * added support for different Fonts in the Resultlist & SimpleFileViewer
   * removed some hard bugs
   * saving of window-position and size

Major changes since Version 0.25 - Build 6 (actual is 0.27 - Build 9):

   * added Configmenu for future use
   * added Filemask and dis-/enabling of Searchtypes
   * added DLL-Support for specific Formats
   * now cfg in file: simfzcfg.txt
   * many internal changes!

Major changes since Version 0.21 - Build 2 (actual is 0.25 - Build 6):

   * supporting new Fileformats (*. doc, *.mp3, *.dbf)
   * file-listing-bug removed (not all files were searched before SORRY!)
   * ResultList export-function added (POPUP-Menu)
   * Associated Shellstart out of resultlist (by using POPUP-menu)
   * implemented Start-Stop-Button
   * implemented own Simple-Viewer (but still have some bugs using next and
     prev button)

Major changes since Version 0.21 (actual is 0.21 - Build 2):

   * removed the need of installed ActiveX (wininet.dll not needed anymore)

Major changes since Version 0.2b (actual is 0.21):

   * OemConvert Button
   * Line-Count added
   * Full highlight of reportlistctrl
   * New Fileformat & Check in file:simfzl02.txt

Major changes since Version 0.17b (actual is 0.2b):

   * Add Button and Edit-field for manual adding of sourcefiles
   * now also Paths are addable (with static and dynamic files)
   * new filenamesaved on exid : simfz02.txt

Major changes since Version 0.15b (actual was 0.17b):

   * check-Filetype-Button
   * accept HTML files (when check is on !)
   * files will now be associated (if typecheck is on)
   * selected files will be searched (if they are selected)
   * Saving switches and editfields in the registry
   * Files in Filelist won't be sorted

Major changes since Version 0.14b (actual was 0.15b):

   * open files in Filebox by doubleclicking
   * now whole line will be read. (BUGFIX)
   * ToolTip support.

Major changes since Version 0.11a (actual was 0.14b):

   * Now results are listed in a Reportview.
   * Reportview is sortable.
   * Resizeable window
   * Win95-Drag & Drop-Bug removed
   * added Waitcursor while searching
   * and some more bugs were fixed ..

  ------------------------------------------------------------------------

The Future of SimFuz
As this is the first real release I will try to add as many fatures as I
and you need.
So, if you have an Idea of how to extend this application, please send an
eMail to me.
Here are some thing I plan to implement in further time:

   * Support for more fileformats correctly: Word (*.doc), Execl (*.xls)...
     (as DLL)
   * exporting only marked results
   * Saving of resultoptions
   * copy of marked filename to clipboard
   * Support for PDF
   * Support for XML
   * external editor connection
   * MP3 v2 support
   * Extended definition of filemask, using Filesets.
   * a little extension of the searchalgorithm
   * A CGI-Version (I allready have one but it has still too many Bugs (not
     time to fix))
   * export Resultlist to html
     don't know ... tell me ?

  ------------------------------------------------------------------------

Registering as Comerceware ???
Ok, I claimed this software as Freeware. In fact this Software is supposed
to be something like Comerceware.
This means that you can use this software in anyway without paying, if you
use it for non-comercial pruposes.
If you are earning money, using this software, a little fee for my work
should be payed.
So, If YOU are using this software for comercial proposes, think it over
and pay something. Please!

What would I get for that?
A good motivated programmer, willing to extend SimFuz in many possible ways
with your suggestions.
And a registrationnumber for this and the next following SimFuz-Versions,
that will remove the PleaseRegister-Sign.

What would it cost and how to order?
The price for this version of SimFuz is 20 Euro or 23 Dollar.

You can register using the service of www.shareit.com.
Therefor you have to go to the mainpage and enter SimFuz as searchsting or
go directly to

http://www.shareit.com/programs/104192.htm

After registering I will receive a mail from shareit and will send a
registerkey for your name to you.
This may take a few days.

For other ways to register please have a look at register.txt!

  ------------------------------------------------------------------------

Disclaimer (please read)

LIMITED WARRANTY

THE PROGRAM IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER
EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO WARRANTIES OF
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.  IN NO EVENT WILL THE
AUTHOR or AUTHORS BE LIABLE TO YOU FOR ANY DAMAGES, INCLUDING INCIDENTAL OR
CONSEQUENTIAL DAMAGES, ARISING OUT OF THE USE OF THE PROGRAM, EVEN IF
ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
YOU ACKNOWLEDGE THAT YOU HAVE READ THIS LICENSE, UNDERSTAND IT AND AGREE TO
BE BOUND BY ITS TERMS AS THE COMPLETE AND EXCLUSIVE STATEMENT OF THE
AGREEMENT BETWEEN US, SUPERSEDING ANY PROPOSAL OR PRIOR AGREEMENT, ORAL OR
WRITTEN, AND ANY OTHER COMMUNICATIONS BETWEEN US RELATING TO THE SUBJECT
MATTER OF THIS LICENSE.

  ------------------------------------------------------------------------

The format of the listfile
The filename : simfzcfg.txt
The format of the listfile is pure asci and can easily be edited with an
editor.
Its saved linewise and Check-Switches are saved as values (1 or 0).


     SimFuz Format ab 0.27


     Line Tag  & Descr
     1      SimFuz   SimFuz identtag

     2      VERSION=0.12                 Versionsnummer
     3      CGI=1                               Use CGI 1= Yes *0 = no
     (belegt wenn nicht def)
     4      LASTSEARCH=word     Last searchstring
     5      THRESHOLD=50.0        Threshold (*50.0)
     6      CHECKTYPE=1              Checks type *1/0
     7      OEMCONVERT=0         OEM Switch 1/*0
     8      STATICFILES=1              StaticFiles Switch 1/*0
     9      MASK=*.*                          DefaultMask
     10    LEVELS=99                      Default Levels (max. is 99)
     11    SEARCHTYPE=0 Search type: *0=content/1=filename+content/2=only
     filename
     12    RELOADRESULT=file.txt
     13  EXTERNALSPAWN=notepad.exe
     14   HIGHLIGHT=0
     15   HIGHLIGHTCOLOR=
     16      WPOS_R=0
     17        WPOS_L=0
     18        WPOS_T=0
     19        WPOS_B=0
     20        WISMAX=0
     21   0/1,csize1,csize2,csize3,csize4
     22   USEFONT=0
     ... 15 lines of fontdescription (LOGFONT)
     23    STARTSEARCHFILES=n
     till herer:
     1. filename
      mask
      selected
      levels
     ...
     n. filename
      mask
      selected
      levels

     24  STARTMODS= Number of Mods/Sets

      1. FileSetName
      Typename    // Internal (Don'T change)
      Type     // Internal (Don'T change)
      Disabled    // Dis/ebabled bool 1/0
      Filename    // filename of DLL
      Reserved
      Reserved
      Reserved
      Reserved
      FilesetName
      NofItems
       IncludeMask
       Diabled 0/1
       NofItems    // Always 0
       ExcludeMask    // no line --
       Diabled 0/1    // no line --
     .
     .
     .
     .
     n.FileSetName
      Typename    // Internal (Don'T change)
      Type     // Internal (Don'T change)
      Disabled    // Dis/ebabled bool 1/0
      Filename    // filename of DLL
      Reserved
      Reserved
      Reserved
      Reserved
      FilesetName
      NofItems
       IncludeMask
       Diabled 0/1
       NofItems    // Always 0
       ExcludeMask    // no line --
       Diabled 0/1    // no line --
     end of file.

  ------------------------------------------------------------------------

The Author
If you want to reach me, you can mail me on :
Timo.Engelke@frankfurt.netsurf.de
Or you can go to my Home-Page :
http://people.frankfurt.netsurf.de/Timo.Engelke/
Maybe you will have to use: http://timo.ist-im-inter.net

Have fun and be productive with SimFuz !
19/06/99
