Copyright: Copyright © 1995 Hurricane Software
Citation: Copyright © 1995 Hurricane Software


WinGREP help contents
    WinGREP

Version 1.5  from Hurricane Software, Inc.

WinGREP is a shareware program that allows you to quickly and easily search text files for an occurrence of a text string.

WinGREP is a fully functional program. None of its capabilities have been removed or disabled.  The only difference between the registered version and the shareware version is some friendly reminders to register the software if you use it.

Nearly all of the functionality of WinGREP is accessible from the main screen. This allows you to quickly find what you are looking for and return to your working environment.  To make this process even easier, WinGREP has the ability to synchronize your IDE using the results of the latest search.

WinGREP can search files looking for a simple text string or can utilize the power of Regular Expressions.  Regular Expressions give you the ability to search multiple files and directories looking for a pattern or range of values. Traditionally Regular Expressions required you to memorize the cryptic meanings for each particular expression character, but with WinGREP Regular Expressions are easy!  All of the Regular Expression syntax is available on the main screen using the Regular Expression Button Bar. You can quickly create complex expressions by utilizing the Button Bar and the hints associated for each button.

WinGREP has been optimized for speed and convenience - quick in and quick out. It is a powerful tool that can help you utilize your time efficiently.

NOTE : If you find this program useful and continue to use it  do the right thing and register it. Shareware only works if software is registered.  Registered users are given advance release notification, technical support, and all of the "Unregistered" text and "Register" buttons are removed as well as the initial about box.

Registering WinGREP

Whats New in WinGREP Version 1.5

Using WinGREP

How to Form Regular Expressions

Quick Regular Expressions

Using WinGREP with your IDE

Using WinGREP with Other Editors

Other Hurricane Software Products


Registering WinGREP

There are two ways to register WinGREP.

1) From CompuServe go to the SWREG forum and use registration ID # 7418 to register. You will be billed by CompuServe in your next statement and the registered disk will be mailed to you.

2) Fill out the form and mail (snail mail or E-mail) it in :

    (E-Mail to rburroug@tfs.net)

Click here to go to form

Back to Main


Regular Expressions Overview
Regular Expressions

The following Regular Expression characters are supported by WinGREP :

    ^    $    .    *    +    [  ]    [^ ]    [ - ]    \

_____________________________________________________________

^   	A circumflex matches a text string at the start of a line.

$	A dollar sign matches  a text string the end of a line.

.	A period matches any character.

*	An asterisk after a character matches zero or more occurrences.

+	A plus sign after a character matches one or more occurrences.

[  ]	Characters in brackets match only characters in the brackets.

[^ ]	A circumflex in brackets means match any  but the chars in the brackets.

[ - ]	A hyphen within the brackets signifies a range of characters.

\	A backslash before an expression character tells WinGREP to treat that

character literally, not as a Regular Expression character.

Back to Main


Other Hurricane Software Products

Source Gen PRO

_______________

Available from Hurricane Software is Source Gen PRO. This utility allows you to easily create source code for ANY dialog that you can display to the screen.  Source code can be generated in any of the following languages :

Borland C++ OWL 2.0 & 2.5

Microsoft C++ MFC 1.0 &  2.0

Borland Pascal OWL

Standard C API level

Borland Pascal API level

The source generated completely encapsulates all of the functionality that you are usually required to type in time after time.

Support is included for control notification message handling, sub-classing controls, and customization of  the source code templates.

Many hours of work can be saved by using Source Gen PRO to create all of your dialog's source code modules. It's as easy as pointing and clicking.  Source Gen PRO registers for only $69.00 + S&H

Hurricane Editor

_______________

The Hurricane Editor is a full featured text editor that is included with registered copies of WinGREP.  It can load any size file (limited by memory) and uses a handy Tabbed window look ( similar to Delphi's editor) to allow quick access to all open files.  This Editor is also integrated with WinGREP.  It can be downloaded from CompuServe under the filename HEDIT150.ZIP.  Hurricane Editor registers for only $19.00 + S&H.

 NOTE: If you register WinGREP, the Hurricane Editor is included for FREE!. If you want to try WinGREP with the Hurricane Editor, simply download it and set it up under the Options button as the editor that you want to use.

For further information contact Hurricane Software, Inc at :

Phone  	(816) 373-9252

Internet E-Mail	rburroug@tfs.net

Compuserve	102470, 2564

Back to Main


Regular Expression Examples
Forming Regular Expressions

A regular expression is basically a text string that has special control codes embedded in it.  These codes form expressions that the expression parsing engine extracts and deciphers.

An example of a Regular Expression is : ^beg[ai]n  -  this expression will match all lines that either start with "begin" or "began".

The following Regular Expression characters are supported by WinGREP  (replace ... with search text) :

_______________________________________________________________________

    ^...  ...$  (.)  ...*  ...+  [...]  [^...]  [...-...]  \...

       ^-----period anywhere in expression

_______________________________________________________________________

 ^...	A circumflex matches a text string at the start of a line.

Examples :

^begin	Matches "begin" at start of any line

_______________________________________________________________________

 ...$	A dollar sign matches  a text string the end of a line.

Examples :

then$	Matches "then" at end of any line

_______________________________________________________________________

 .	A period matches any character.

Examples :

so..y	Matches "soggy", "sorry", "sorty"

^beg.n	Matches "begin", 'began", "begun" at start of any line

_______________________________________________________________________

 ...*	An asterisk after a character matches zero or more occurrences

of that character.

Examples :

fur*y 	Matches "fuy", "fury", "furry"

_______________________________________________________________________

 ...+	A plus sign after a character matches one or more occurrences

of that character.

Examples :

fur+y 	Matches "fury", "furry", but does not match "fuy"

_______________________________________________________________________

[...]	Characters in brackets match only one character that appears in the

brackets.

Examples :

^beg[ai]n	Matches "begin" or 'began" at start of line, but not "begun"

_______________________________________________________________________

[^...]	A circumflex in brackets means match any character but the ones listed

in the brackets.

Examples :

beg[^au]n$	Matches "begin" at end of line, but not "begun" or "began"

_______________________________________________________________________

[...-...]	A hyphen within the brackets signifies a range of characters.

Examples :

beg[a-i]n	Matches "began", "begen", "begin", but not "begon" or "begun"

_______________________________________________________________________

  \...  	A backslash before an expression character tells WinGREP to treat that

character literally, not as a Regular Expression character.

Examples :

char\[20\]	Matches "char[20]"

(cost\*qty)	Matches "(cost*qty)"

_______________________________________________________________________

Back to Main


Using WinGREP

Click on any of the areas below for help :

Back To Main


Using WinGREP with your IDE

WinGREP has the ability to utilize your IDE editor to show a search match.  When you choose the Open button or double-click on a search match, your IDE will become active and the chosen file will load into the editor and go to the correct line number.

To enable this capability in WinGREP, do the following :

 	1. Start WinGREP.

2. Choose the Options button.

4. In the Editor / Options dialog click the "Integrated Development

    Environment (IDE)" radio button.

5. Then choose your IDE from the list below.

NOTE : Your IDE must be currently running for WinGREP to interface with it.  WinGREP WILL NOT start your IDE for you.

Back to Main


IDE definition
Integrated Development Environment (IDE) :

Several development products such as Microsoft C++ , Borland C++ and Delphi have a built in development environment that allows the programmer to easily edit, test, and debug projects.


Preview Window

When the Preview Window CheckBox is checked, the Preview Window is visible.  The Preview Window show the currently selected search match and several lines before and after it.  The number of lines shown is determined by the size of the window.  The Preview Window can be sized by clicking and dragging the seperator bar between the Preview Window and the Results Window.


Results list
Results Window :

This window shows the results of a search. The list initially contains the names of the files that a match was found in.  If you double-click on a filename, the list will expand to show all of the occurrences for that file.  To view the file, double click on the match text, or choose the Open Button.  If you have chosen IDE for an editor, then your IDE window will become active and will position on the correct line.  If you are using the Hurricane Editor, then editor will start and will go to the correct line number in that file.  If the Other Editor option has been chosen, then that editor will be called and positioned.

Note :  You can right click in the Results Window to perform certain actions on the results such as :

Expand a node

Collapse a node

Expand all nodes

Collapse all nodes

Delete a node

Clear the results window

Save results to a file

Load results from a file


Directory listbox
Search Directory :

By double-clicking on directories, you can choose which directory WinGREP will start its search from.  As you navigate directories, the label above the directory list is updated with the current search directory.


Drive combobox
Search Drive :

Press the arrow for a drop-down list of the drives available on your computer.


Search extention edit
File Mask(s) :

Enter all of the file types that you wish to search. Multiple file types can be searched at once. To search multiple files simply separate each file extension with a semi-colon (;). An example of this is *.pas;*.inc;*.dpr.  Click the down arrow to see a list of previously entered masks.

NOTE : Only text files should be searched. Searching binary files (such as .EXE's) will produce unpredictable results.


Search string / Regular Expression edit
Regular Expression Text:

This edit field can contain a simple string or a Regular Expression.  To aid in the construction of the Regular Expression, click on the buttons below this edit.  Click the down arrow to see a list of previously entered expressions.


Regular Expression button bar
Regular Expression Button Bar:

This set of buttons will help you construct Regular Expressions. Simply click on a button to add a Regular Expression character to the search string.  An example of each character is listed in the hint line at the bottom of the window. Also a pop-up hint will give a brief description of the character.


Number of matches found
Number of matches found :

This number reflects the number of matches found in the current search. This aids as an indicator of the progress of a search.


Number of files that have a match
Number of Files Found :

This number reflects the number of files in which one or more matches were found. This aids as an indicator of the progress of a search.


Number of files searched
Total Number of Files Searched :

This number reflects the total number of files searched during the current search. This aids as an indicator of the progress of a search.


Hint line / Status line
Hint/Status Line :

This line shows hints as the mouse passes over various controls on the form. It also reflects the current directory and file being searched by WinGREP. This aids as an indicator of the progress of a search.


Options button
Option Button :

This button allows you to choose an editor and configure advanced options in WinGREP.

The editors that WinGREP can use are :

IDE

Custom Editor/IDE

Other Editor

Hurricane Editor

Also See Advanced Options


About Button
About Button :

Version and registration information for WinGREP.


Help button
Help Button :

Takes you to WinGREP's help screens.


Case Sensitive
Case Sensitive :

If this checkbox is checked the search will be Case Sensitive.


Recurse sub-directories checkbox
Sub-Directories :

If this checkbox is checked then WinGREP will search in any subdirectories below the starting directory.


Other Editor
Using WinGREP with Other Editors

If you do not use an IDE or have another editor that takes command line paramaters (like Codewright), you can use the Other Editor option to show the full text of search results.

Example of how to setup the Other Editor option :

1. Choose Options Button.

2. Pick Other Editor

3. Enter the path to your editor in Path

4. Enter any command line paramaters in Parameters.  You can use the Filename and Line Number buttons to insert a "macro" in your command line that is passed to your editor. That "macro" can add the filename and/or the line number to go to.

Back to Main


Stay on Top checkbox
Stay on Top :

If this checkbox is checked then WinGREP's main window will stay on top of all other windows in the system.


Unregistered text
Unregistered Text :

This text only shows up on unregistered copies of WinGREP. It is a friendly reminder to register the software if you use it.  All of the "Unregistered" text and reminder dialogs are removed from the registered version of WinGREP.


About Hurricane Software, Inc.
Hurricane Software, Inc.

Hurricane Software has a wide range of quality applications for the professional developer.  For product customization, custom programming, information about other quality products and services, or for details on quantity discounts, contact Hurricane Software, Inc at :

Phone  	(816) 373-9252

Internet E-Mail	rburroug@tfs.net

Compuserve	102470, 2564


Start button
Start Search Button :

This button will start the search process. To stop the search process, make sure that under the Options Button that the "Show Stop Button During Search" checkbox is checked. This will allow a Stop button to show up during searches.


Close button
Close Button :

This button will close WinGREP.


Open button
Open Button :

Pressing this button will open the currently highlighted file in the Search Results list.  If you have chosen IDE for an editor, then your IDE window will become active and will position on the correct line.  If you are using the Hurricane Editory, then the Hurricane Editor will be started (or focused) and will load the file and go to the correct line number.  If an other editor is chosen then that editor will be called passing the arguments entered in the Options.

NOTE : To position on a line number in the Hurricane Editor,  Your IDE or Other Editor, you must have the Search Results list expanded to show the matches for a file and have a match selected. Otherwise the file will be opened and positioned on the first line.


WinGREP topics
WinGREP Topics :

Registering WinGREP

Whats New in WinGREP  Version 1.5

Using WinGREP

How to Form Regular Expressions

Quick Regular Expressions

Using WinGREP with your IDE

Using WinGREP with Other Editors

Other Hurricane Software Products


Custom Editor/IDE

This option allows you to configure an editor or IDE that WinGREP does not list as an available editor.  WinGREP can simulate keystrokes to your Edit/IDE that can open files and position the file accordingly.

NOTE : This is an advanced option and assumes that you are an experienced Windows programmer.  This option is included as kind of an "extra".  Hurricane Software cannot give technical support for this option.  It is supplied as is with the following documentation :

There are 2 inputs that you need to fill out - Windows Class Name and Open File Key Sequence (Goto Line Number  is optional) :

Window Class Name

This is the Class name that the main window of your Editor/IDE registers with Windows.  You will need to do a little investigation to find this.  A good start for finding the class name is to use WinSight. WinSight is a product that Borland ships with their compiler products (Delphi, Pascal, C++) - if you use Microsoft compilers, I'm sure that there is a utility to do this, but I don't know what it is - sorry.

In WinSight under the Spy menu is an option called Find Window.  If you choose this option then as your mouse passes over other windows on the desktop, the window list in WinSight highlights the window your mouse is over.  You are given a visual representation of the selected window when the frame of the selected window flashes.  In general you want to choose the outermost window that owns all of the sub-windows inside of it.  You can tell this by the hierarchy in the WinSight window list.

Below is a sample from WinSight :

The class name for a window is listed in curly braces {}.  For example WinSight's main window's Class Name is WsiFrame.

Open file key sequence (Optional)

This is the sequence of keys used to open a file.  For example to open a file in your editor, you might type

<ALT-F> O MYFILE.CPP <ENTER> .  This translates to the following key sequence in WinGREP :

%FO#FILENAME#~

Goto line num key sequence

This is the sequence of keys used to position a file in a match that WinGREP found.  For example to go to line number 160 in your editor, you might type

<CTRL-G> F 160 <ENTER> .  This translates to the following key sequence in WinGREP :

^G#LINENUM#~

The following are replaceable parameters that you should use when building your key sequences :

.

#FILENAME#

File name that WinGREP is opening.  This is a place holder that you should include in your open file key sequence.  WinGREP automatically replaces this token with the filename to open.

#LINENUM#

Line number that WinGREP is going to position the file to.  This is a place holder that you should include in your goto line number  key sequence.  WinGREP automatically replaces this token with the line number to position the file on.

The table below lists all of the available keystrokes that WinGREP can simulate and how to use them. All other keys are passed through as they appear (i.e. %FO... means <ALT-F> O #FILENAME#...<---the O is passed in without translation)

State keys :

+  =  SHIFT key

^  =  CTRL key

%  =  ALT key

Example : %F means <ALT-F>

Specially defined keys :

CAPSLOCK	NUMLOCK	SCROLLOCK
ESCAPE	ESC	ENTER
HELP	PRTSC	TAB
BREAK	CLEAR	BACKSPACE or BS
DELETE or DEL	INSERT	LEFT
RIGHT	UP	DOWN
PGUP	PGDN	HOME
END	MENU	F1
F2	F3	F4
F5	F6	F7
F8	F9	F10
F11	F12

To use the keys above you simply need to enclose them in curly braces {}.

For example to open a file by choosing F3 you might type <F3><TAB>MYFILE.CPP<ENTER>

This translates to {F3}{TAB}#FILENAME#~ in WinGREP.


Technical Support

Technical support is available for registered users.  Technical support questions should be directed to one of the following :

Internet E-Mail	rburroug@tfs.net

Compuserve	102470, 2564

Mail Address	Hurricane Software, Inc.

Attn : Technical Support

2401 SE 7th

Blue Springs, MO 64014

Please leave either your E-Mail address or regular mail address for return reply.

Back to Main


Advanced Options

These options affect the performance and behavior of WinGREP.

Max items before stopping:

Default - 1000

This number reflects the maximum number of matches that WinGREP will process before stopping the search.  The valid range is 1 to 15,000 matches.

Note : 15,000 matches requires a large amount of memory (500k to 1MB).  The default value of 1000 should suffice for most situations.

Show Stop button during search:

Default - Checked

If checked then a Stop button is displayed that allows a search to be stopped at any point.  If this is unchecked, WinGREP can process slightly faster because it is not doing any message processing.  For small searches (<1000 matches ) the performance gain is minimal.

Note : If unchecked then there is NO way to stop a search once it has started!

Allow multiple instances of WinGREP:

Default - Unchecked

If checked then multiple instances of WinGREP can be run concurrently.

If unchecked then after starting the first instance of WinGREP, every additional instance that you try to start will result in the first instance becoming active.  This means that no matter how many times you run the program, only one copy of WinGREP will be on the desktop at a time.

Back to Main


Registration Form

Choose File|Print Topic to Print

                            HURRICANE SOFTWARE, INC.

                           PRODUCT REGISTRATION FORM

                        _______________________________

   ------------------------------------------------- 5 Reasons to Register ---

       NAME __________________________________   |                           |

                                                 | 1. Technical Support via  |

    COMPANY __________________________________   |    FAX or E-Mail.         |

                                                 |                           |

     STREET __________________________________   | 2. Upgrade notification.  |

                                                 |                           |

     STREET __________________________________   | 3. The registered version |

                                                 |    does not have any      |

       CITY __________________________________   |    annoying registration  |

                                                 |    buttons or text.       |

      STATE _______________  ZIP _____________   |                           |

                                                 | 4. Comments/suggestions   |

    COUNTRY __________________________________   |    can only be taken from |

                                                 |    registered users. Your |

      PHONE __________________________________   |    suggestions will help  |

                                                 |    define WinGREP!        |

  I HEARD ABOUT WINGREP FROM :                   |                           |

                                                 | 5. Hurricane Editor -     |

         __ COMPUSERVE FORUM: ________________   |    A full featured text   |

                                                 |    editor is included     |

         __ CATALOG : ________________________   |    that is fully          |

                                                 |    integrated with        |

         __ INTERNET: ________________________   |    WinGREP.               |

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

  Payment Method :   CHECK ____    MONEY ORDER ____

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

  COSTS :

     WinGREP..................................Qty____ X $29.00  ________

     WinGREP Upgrade from version 1.10........Qty____ X $12.00  ________

     Missouri residents add sales tax..................  5.98%  ________

     Shipping and Handling (U.S or Canada)............. $ 4.00  ________

              OR

     Shipping and Handling (Outside U.S. or Canada).... $ 6.00

                                                  ORDER TOTAL   ________

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

  To discuss a site licence or volume discounts, call 816-373-9252.

  All disks are shipped as 3.5" High Density (1.44M) diskettes.

  Make checks payable to Hurricane Software, Inc.

  All amounts must be in U.S. dollars and drawn on a U.S. bank.

  MAIL TO:  Hurricane Software, Inc.

            2401 S.E. 7th

            Blue Springs, MO  64014

            USA                                                       1.5.12.95


Whats New in WinGREP V 1.5
Whats New in WinGREP Version 1.5

New features in this version include :

Resizable main window

WinGREP's main window can be resized to show more search results on one screen.

History lists

File masks and search expressions now retain the last 30 file masks and search expressions entered.

Preview Window

As you move over each occurance in a file, the preview window displays several lines of text around that occurance. You can resize the preview window to display from 2 to 30 lines of text.

Cumulative Search Results

Search results are now cumulative - the results window does not clear the last search

Standalone Text Editor - Hurricane Editor

The integrated text editor in version 1.1 now ships as a standalone executable with WinGREP.  This means that you can use this editor for any of your editing needs.  WinGREP is tightly integrated with this editor and is a good substitute if you do not use an IDE.

NOTE: Users that have downloaded WinGREP will not have the Hurricane Editor as part of the WinGREP download.  You can download this program seperately from the same source as WinGREP- Filename HEDIT150.ZIP.

Load and Save Search Result Sets

Search results can now be saved to a file and then later reloaded into WinGREP.  The Search Results file can be edited and/or printed with any text editor.

Improvements to the "Other Editor" option

You can now pass both the filename and line number to an external editor of your choice. See the Codewright example.


Codewright Example

Example of how to use Codewright with WinGREP.

1. Choose Options Button.

2. Pick Other Editor

3. Enter the path to Codewright in Path

4. In Parameters enter the following

#FILENAME# /G#LINENUM#

Thats it!. Now WinGREP will use Codewright to show all search results.


Hurricane Editor

The integrated text editor in version 1.1 now ships as a standalone executable with WinGREP version 1.5.  This means that you can use this editor for any of your editing needs.

WinGREP is still tightly integrated with this editor and is a good substitute if you do not use an IDE.

NOTE: Users that have downloaded WinGREP will not have the Hurricane Editor as part of the WinGREP download.  You can download this program seperately from the same source as WinGREP- Filename HEDIT150.ZIP.

If you register WinGREP, the Hurricane Editor is included for FREE!. If you want to try WinGREP with the Hurricane Editor, simply download it and set it up under the Options button as the editor that you want to use.

Back to Main


Preview Window Check Box

Check this box to make the preview window visible/invisible.