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:

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):

Major changes since Version 0.27b - Build 9 (actual is 0.30 - Build 1): Major changes since Version 0.25 - Build 6 (actual is 0.27 - Build 9): Major changes since Version 0.21 - Build 2 (actual is 0.25 - Build 6): Major changes since Version 0.21 (actual is 0.21 - Build 2): Major changes since Version 0.2b (actual is 0.21): Major changes since Version 0.17b (actual is 0.2b): Major changes since Version 0.15b (actual was 0.17b): Major changes since Version 0.14b (actual was 0.15b): Major changes since Version 0.11a (actual was 0.14b):

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:


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