

               Welcome to Wanyword

WanyWord is a text search program with AND, OR, NOT and proximity searches. This help file will  show you how to use WanyWord. You will also profit from reading the Read.me file. There is also an ASCII manual WANYWORD.TXT (this file) and the WORD document WANYWORD.DOC.
Since WanyWord is freeware you are not legally entitled to support, but within reason help is available at:

 http://home4.inet.tele.dk/jensguld/
and
 jensguld@post4.tele.dk

Bug reports are especially welcome.

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

CONTENTS:

WanyWord's interface
Starting a new search
After a search
Saving the search results
Find within WAN files
Viewing the results of a previous (and saved) search
Narrowing a previous search
Viewing non-ASCII files
Export from WanyWord
Configuring WanyWord
Uninstalling WanyWord



WanyWord's interface
---------------------------
Title bar - Main menu bar - Workspace - Tool bar

The Title bar
Title bars are located along the top of all Wanyword windows.
The control menu button (WanyWord icon) and the minimize/maximize/close WanyWord windows buttons are found here:

The Minimize button
Reduces a window to an icon.
Icons representing the minimized WanyWord window appear at the bottom of the Windows95 work panel. To restore a window to the original size, you must click this icon. Minimizing has no effect on the contents of a window.

The maximize button
Using the maximise button makes WanyWord fill the entire screen.
When you click the maximize button, it becomes the restore button.
Clicking the restore button returns a window to the size it had before it was maximized.

The Close window button
The close window button closes the Wanyword window and program.


Main menu bar
Under the title bar in the WanyWord window you will see the main menu bar.
The WanyWord menus Search and Help appear in this bar. Clicking on a menu name opens the menu. You select an option from the opened menu by clicking the option.


Workspace
The workspace is the area beneath the menu bar. Here you find the tool bar and status line.
            
Tool bar
The tool bar at the top of the workspace contains the Wanyword tools.
You select a tool by clicking on the tool icon.  They are:

Start a new search
Open files that contain the results of previous searches,
Save search results to a file
View a text file
Open a file with an associated program
Open a file with a program you choose
Info about the latest search
Help


Starting a new search
---------------------------
To begin a new search: 
Select New from the Search menu or press the hotkey N.
A dialog box appears in which you specify 'where', 'what', and 'in what'.


Where to search
--------------------
 In the Default Path box you write the file path and in the File(s) box the file name or file mask of the file(s) that you want to  search.  You can use DOS wildcards. By clicking the Browse button to the right of the Default Path box you can also select a file path. By clicking the Browse button to the right of the File(s) box you can select a file from the floppy or the hard disk(s) using the Windows95 system menu.


Refine a search
------------------
If you wish to search within the set of found files that are shown in the Search menu, you can use the Refine checkbox. The contents of the Default path and the File(s) boxes will be greyed out and cannot be written in. NOTE that you cannot enter the search term +(-Wayne), it must be John+(-Wayne).

  If you wish to search in files in different folders you should write a filename (or select it from the Open File(s) box) with the whole path, switching on  Full path and Queue in the Configuration menu. Full path means that the file name and it's full path will be placed in the File(s) box. Queue means that you "queue" several files in the File(s) box. 

  If a filename is already written in the File(s) box, you can choose a new file from the Select a Directory window and it's name will be added to the file list if the Queue in the Configuration menu has been enabled. You can do this several times.
  If you want only the new file name you should disable "Queue" in the Configuration menu.
NOTE: In spite of the name Full path has nothing to do with the Default path box or the Subdir option. 


 You open a file in this way:
 1. Select a Browse button in the Search menu. The Select a Directory or the
    Open File dialog box appears.
 2. If you choose Browse to the right of the Default Path box the Select a Directory
    window will open. You can find the folder and select it with the OK button.
    You will be returned to the Search menu where you can enter the file name(s)
    in the File(s) box.
 3. If you click on the Browse button to the right of the File(s) box you will see
    the Open file window with the files from the selected folder.
    Select the appropriate filename or write it.
    If the file you want isn't in the directory you are looking at you can look into 
    other directories or folders by using the normal Windows search facilities
    in the top of the  window, ie. the "Up one level" button and the Drop down box.
 4. You can choose the file extension in the Drop down box at the bottom of the
    Open Files window.
 5. Click on Open. The dialog box closes and the filename appears in a File(s)
    box in the Search menu window.

Note: You may write one or more filenames or only the extension(s). The filename(s) should be separated from each other by separators. Files, that should not be searched, are excluded from the list with separator or exception characters. They are defined in the Search|Configurating menu.
      For example,  we can search in the following files:
       1). C:\mytextfiles\*.txt;d\ mydocfiles\*.doc
       2). *.txt;*.doc  to search in files with the extensions 'txt' and 'doc'
       3). *.*;#*.doc     to search in all files except .doc files.

       The separator character in these examples is ' ; ' 
       The exception character in these examples is '#'
       
WanyWord saves a list with the last 10 search paths.
Use the cursor keys or click with the mouse to recall any of these paths.
If you want to clear Default Path box and the File(s) box you can click the Reset button in the Search menu.



What to search for
-----------------------
In the String(s) to find box type the word or word combination, or sentence, or any text string you want to find.


How to search
-------------

Search with BOOLEAN operators
-----------------------------

Wanyword allows you to do BOOLEAN searches (AND, OR, NOT).
You DON'T use the words AND, OR or NOT (at least not at first, maybe later, much later). The symbols used for AND, OR and NOT can be seen and changed in the Search|Configuration menu.
NOTE: If your search strings contain any of the symbols used for AND/OR/NOT, you must change the symbols.

BOOLEAN AND
If you search for  john AND wayne,  WanyWord will only find the lines, sentences, pages or files that contain both words. In the section about the Find within box you will learn how to search within lines, sentences etc.
There are also examples showing how to write a BOOLEAN commannd (you do NOT write AND, OR or NOT and you must be very careful about spaces).

BOOLEAN OR 
If you search for "john OR wayne" WanyWord will find the locations where one or the other or both words exists. Here too WanyWord will search for the words within individual lines, sentences etc.

BOOLEAN NOT
There are two ways of using the NOT operator: AND NOT and OR NOT.
There are search programs where you use NOT and not AND NOT, but WanyWord is not one of them.

If you search for 'John NOT Wayne' there are therefor 2 ways of doing it:

1. (John) AND (NOT Wayne)
   Wanyword will  find the locations where "John" is written but not "Wayne"
2. (John) OR (NOT Wayne)
   WanyWord will find the locations where "John" is written or where "Wayne" is not written.
   Here too WanyWord will search for the words within individual lines, sentences etc.


Complex searches
----------------------
Often you need to search for only a single word (Wayne) or text string (John Wayne) but sometimes a complex or BOOLEAN search is necessary.
When you do such a search, the words or text strings you search for will be connected by so called BOOLEAN operators. WanyWord uses the operators AND, OR and NOT. Here are some examples:
(A+B) or C
(A + B) + C,
(A + B) or (not C)
(A or B) + C
(A or B) + (not C)
(A + B) or ( C + D)
(A or B) + (C or D)

For example, if we want to find all the movies John Ford made with John Wayne and Maureen O'Hara, the search may look like this:

John Ford and John Wayne and Maureen O'Hara or rather, since we do not use the words AND, OR, NOT:
John Ford+John Wayne+Maureen O'Hara
Please note that there should be no space between a BOOLEAN operator and the words next to it!! Or we want to find the movies in which Ford directed and John Wayne played but Maureen O'Hara did not appear:

A and B) + (not C)
or where John Ford was the director and at least one of two actors played:
C + (A or B)

This search could also be written:
(A or B) + C

But we must remember to use the brackets, because the expressions
A or B + C and C + A or B
are not the same, because in complex searches the priority is from left to right. Therefore if you use more than one BOOLEAN operator it is best to use brackets to show
WanyWord the order in which the textstrings should be operated on.
If necessary you can change the bracket symbols too. You may for example need to search for

(A+B) * C and (A+B+C)*D
in a matematical text. In this case you can write the complex search like this:
/(A+B) * C\ AND /(A+B+C)*D\
In this case the left bracket or Lbracket is '/', and the right bracket or Rbracket is '\' instead of the normal '(' and ')'. This is because you have changed the left and right bracket symbols in the Search|Configuration menu.
If you want to find the textstring A and B , where the word 'and' is not a Boolean operator (though in the configuration menu the word 'and' is a Boolean operator), you should use the quote:
'A and B'
The quote symbol can be changed in the Configuration menu.



Advanced menu
-------------------
To the left in the Advanced menu you will see the check boxes:

Include subdir
Ignore case
Whole word
Include hidden and system files

Include subdir
--------------
When the check box Include subdir is disabled, the text search is done in the specified directory and only there.  If the check box is enabled the subdirectories are also searched.

Ignore case
-----------
If Ignore case is switched OFF, WanyWord will distinguish between upper- and lower-case. If Ignore case is ON, upper- and lower case are considered identical.

Whole word
---------------
If the Whole word box has been checked, only whole words or complete textstrings will be found.
If Whole word has not been checked, the search will be right- and left truncated. For instance, if you want to find the word  "Wanyword", the program will find the following words: "Wanyword", "anyword", "nyword", "yword", "word", "Wanywor", "Wanywo" etc.

Note: A search string that contains one or several blanks or spaces is considered to be just one text string.
If you write John  Wayne with 2 spaces between the words, WanyWord will look for those 2 spaces.
If you search for John + Wayne, WanyWord will look for John with a space behind plus Wayne with a space in front.

Include hidden and system files
---------------------------------------
If this box is checked, WanyWord will search in hidden files and system files.  



Search within lines, sentences, pages and files
--------------------------------------------------------

In the middle of the Advanced menu you can choose to Search within lines, sentences, pages and files.

To search for the given words within individual lines, sentences or pages instead of within a whole text or file, you must choose the appropriate options in the Find within box.
The Find within box is found in the middle of the Search|Advanced menu. Only one operator is active at a time. You can use BOOLEAN searches.
For example, let's take Wanyword's "Read.me" file and try to do a BOOLEAN search for two of the words in it.

1.  Read.me+Wanyword
     This is the BOOLEAN operator AND which searches for the joint presence of both search terms.
The search gives the following results:
If you choose Line or Sentence in the Find within box, WanyWord will not find the file "Read.me", because the words "Read.me" and "Wanyword" are not found together in the same sentence or in the same line.
If you choose Page or File, the "Read.me" file will be found, because the two words are found together on a page and also within the whole file.

2. Read.me|Wanyword
   This is the BOOLEAN operator OR which searches for the presence of either or both words.
The search returns the following results:
No matter which of the four options (line, sentence, page or file) you choose in the Find within box, WanyWord will find the "Read.me" file.

3. Read.me+(-Wanyword)
    This is the BOOLEAN NOT operator which must be used together with the 'AND' operator, ie. you must write AND NOT. It will find the word 'Read.me' but only if it is NOT (-) together with the other word.
The search gives the following results:
Because a page and also the whole file contain the expressions "Read.me" and "Wanyword", the file "Read.me" will not be found if these two proximity operators are used.
Because "Read.me" contains a period the words "Read.me" and "Wanyword" are not found together in the same sentence. WanyWord will however find the file "Read.me" if the line option has been chosen.

4. Read.me|(-Wanyword)
This is the BOOLEAN operator NOT (-) used with the operator 'OR' (|).
This finds the string 'Read.me' and reports those files that have it and those where the word 'Wanyword' is absent. A file with "Read.me" is reported whether "Wanyword" is there or not.
Because a page and also the whole file contain the expressions "Read.me" the file "Read.me" will be found.
The search results will be the same if the sentence or the line operator is used.

5.(Read.me+(-Wanyword))|(Wanyword+(-Read.me))
This is a useful complex BOOLEAN search because it emulates the exclusive OR. WanyWord will find either word but only if it is not together with the other word.

The search gives the following results:
Because a page and also the whole file contain the expressions "Read.me" and "Wanyword", the file "Read.me" will not be found if these two proximity operators are used.
Because the words "Read.me" and "Wanyword" are not found together in the same sentence or in the same line, WanyWord will find the file "Read.me" if the sentence or the line operator is used.


National code pages
-------------------------
In the right of the Advanced menu you can choose between ANSI and OEM, ie. between  Windows and your national code page.
When you deal with German umlauts, French accents etc. you use the Code box in the Search|Advanced menu to choose which code page WanyWord will use while searching.
It is located to the right in the Advanced menu. WanyWord will translate characters as necessary. Translated files are NOT saved to disk.
The  "Code" menu has the following options:

ANSI - standard code page 147 (American English).
OEM  - your national code page.
ANSI+OEM - standard and national code page.



DATE menu
---------------
In the Date menu you can choose to search:
All files,
Between 2 dates (dd, mm, yyyy)
During  the previous month(s)
During  the previous day(s)

SIZE menu
--------------
In the Size menu you can search for files by size:
All files and all sizes 
At least-size
At most-size

After a search
------------------
When the search is finished, you can with the options Open WAN, Save WAN, View, Open, Open With and Info in the Search menu:

Combine the last or some previous search with a new search with the Open WAN option or by clicking the open folder button.
Save the search result with the Save WAN option or by clicking the floppy button.
View the found file (or you can click the looking glass).
Open the file with the associated program for the relevant file extension (you can click an icon looking like the standard Wondows baner).
Open with the program of your choice (you can also click the icon looking like the standard Windows banner with a question mark).


Getting information about a search
------------------------------------------
The Info option in the main window's Search menu can be used after a search. Clicking on this option (the spectacles icon) opens a window  with information about the number of scanned and found files, path(s), word combinations, duration of search and numbers of bytes read.


Viewing the found files
----------------------------
If you want to see an ASCII file:
Highlight the name of the file you want to see by clicking it.
Click on the View icon after you have highlighted the name of the file you want. You will see the file with WanyWord's built in (ASCII) viewer, or Select View in the Search menu after the file has been highlighted or
Press the hot key V.
When you are finished you will be returned to the Main window and the list of found files.

If the file you want to study has been made with a program that does not use ASCII, you can  open it with the program it's extension is associated with and by highlighting the file and either pressing Enter or clicking it with the mouse. WanyWord will then call the associated program. For example: If you want to view a DOC file, WanyWord will start Word, and so on. You can also use the option "Open with" in the Search menu and choose  the appropriate viewing program in the "Open with" program box. You can also click the appropiate icons.
When you are finished you will be returned to the Main window and the list of found files.

Any of these actions will open the View window.

The View window
-----------------------
The top line of the window
Here you will see the full DOS path of the file you are looking at. You also see the number of the line where a found word is located.
Just beneath you see three pulldown menus: Search, Edit and Options.

Search
The two first options in the menu let you find the next and the previous occurrences of the found words in the text.
When the menu is closed F3 finds the next occurrence of the words you want to see.
Similarly Shift-F3 finds the previous occurrence of the words.
The words you look for are marked by a text color, which is different from the document's normal text color.
This "search color" can be set in the Search|Configuration menu in the main window.

Edit
Here you can select and copy. You can of course mark text and copy it the normal way, that is with the left mouse button and Ctrl-C.

Options
Wrap
If the lines in a text are too long for a window, you can word wrap.
You do it by choosing Wrap in the Options menu or pressing F2 when the menu is closed.
If you wish to discontinue the word wrapping, you again choose Wrap in the Option menu or F2 outside it.

All words
If you want to see any occurrence in a file of any of the text strings, you have entered in a BOOLEAN search, and not just those parts of the text where all the conditions are true, you should choose All words in the Options menu.

OEM
Here you can toggle between your national code page and ANSI by choosing OEM or you can press F8 when you are not in the menu.


Saving the search results
-------------------------------
If you want to combine the results of a search with those of a new search or wish to use it in a later session, you must save them.
To save the results of a search you must:
Select Save WAN from the Search menu or click the Open folder button. The Save dialog box appears.
From the Directories list box, choose the drive and directory to which you want to save the search results.
In the Filename entry box type the name of your file. You do not need to enter the file extension because the extension "WAN" is automatically supplied by Wanyword.
Click on Save. The dialog box closes.


Find within WAN files
----------------------------
You can search in WAN files in which the results of previous search have been saved by
entering the file mask *.wan or filename.wan in the File(s) box.
You can also use any combination of files or their extension with WAN files.
If you have forgotten the contents of a WAN file, you can choose and open it by clicking   the Open WAN option in the Search menu and then choosing the WAN file. You can also click in the Open folder icon in the main window.


Viewing the results of a previous (and saved) search
----------------------------------------------------
To view the results of a saved search you must:
Select Open WAN in the Search menu in the main window; Press Enter or the hot key O. Or click the Open folder icon in the main window. The Open file(s) box appears;
Locate the directory containing the file in the Directories list box.
Click on the appropriate filename in the Files list box. You may also in DOS-format type the name of the disk, directories, subdirectories and files you want to view in the File(s) box.
Press Open and a file list is displayed.
Choose the file you want to view.


Narrowing a previous search
-----------------------------------
Narrowing a previous search is used for searching within a set of already found files, but with other words and/or conditions.

If a search has given you an overlong list of file names you can refine the search by choosing Refined in the Main part of the Search menu.  You then enter a new search string (perhaps with BOOLEAN operators) or enter it from the list in the String(s) to find box.  Begin the search by clicking OK or  pressing  Enter.

If you wish to narrow a previous and saved search 
Select New in the main window's Search menu.  Press Enter or the hot key N. The Search menu window appears;
In the File(s) box write the name of the WAN-file or use the file mask *.wan. You can choose an appropriate filename with the WAN extension by using the Browse option on the right side of the File(s) box.
Type the new search with text strings and BOOLEAN operators or choose it from the list in the String(s) to find box.  Begin the search by clicking OK or pressing  Enter.


Viewing non-ASCII files
-------------------------------
WanyWord is definitely not good at showing non-ASCII. But from within WanyWord yoy can open some other program and use it as a viewer and/or editor.

If you highlight a filename in window with found files and press Enter, WanyWord will open it with the file's associated program. If there is no association, a window is opened where you can enter the name and file path of the program you want to use. Clicking the filename has the same effect.

In the main window's Search menu you will see the options Open and Open with. These options can also be called from the main window itself with the two icons between the looking glass and the spectacles. They look like a standard Windows "flag" and the same flag with a question mark in the middle.

Open
----
opens the file with the program that is associated to the file's extension.

Open with
------------ 
opens a window where you can enter the name of the program you want to use.

Export from WanyWord
------------------------------
WanyWord is not very good at this. But when you are reading a file, you will see an option Edit at the top of the screen. Open this and you will see the options: Copy and Select all.
Mark something the usual way with the mouse and you can copy it to the clipboard. You can also mark everything by using Select all. 

From there you will need the kindness of other programs. I advocate SuperNoteTab http://www.unige.ch/sciences/terre/geologie/fookes/home.htm which can be made to snatch what you send to the clipboard (it has a gratis version too). ClipMate is also a possibility and there are other programs.

Configuring WanyWord
------------------------------
In the main window's Search menu you must choose Configuration.
 
A window with 3 panes opens: Main window, Boolean operators for string(s) to find and Operators for file list.


Main window
Flyover hints (if ON) lets you see a few words about the buttons your mouse is pointing at. It will take a second or so before they appear.
Status bar (if ON) tells the date and time and shows the status of the Caps, Num lock, Scroll Lock and Insert keys.

Boolean operators for string(s) to find
Here you decide what characters or character strings should be used for the Boolean operators AND, OR and NOT, for the left and right bracket and for the quote symbol.

If you search for John and Wayne the search should look like John+Wayne.  But you can change the operator symbol to for instance "and" or " + " . But if you do this WanyWord will look for the character string you have entered. Sand will be considered an S plus the boolean AND! If you use " + " WanyWord will look for the spaces. It is usually best to use just John+Wayne.

NOTE that the Quote will not work with complex or BOOLEAN searches. And Quote will not succeed with "1234.5678" if you use Find within sentence.


Operators for file list
 Here you choose the separator symbol which is placed between a series of desired filemasks and the Not search symbol you use to show which filemask(s) should not be searched for.

Full path and Queue
  If you wish to search in files in different folders you should write a filename in the File(s) box or select it from the Open File(s) window with the whole path. You must switch on the Full path in the Configuration menu. Full path means that the file name will be placed in the File(s) box with the full path.
  If there is already a filename in the File(s) box, you can choose a new file in the Browse window and its name will be added to the file list (the queue) if "Queue" in the Configuration menu has been enabled. You can add several files with paths this way. 
  If you want only the new filename in the File(s) box you should disable "Queue" in the Configuration menu.

NOTE:  In spite of the name Full path has nothing to do with the Default path box or the Subdir option. 



Uninstalling WanyWord
---------------------
Remove the WanyWord files.




