Chris Bonnici's Routine Search Utility (1.0).
Shareware Version


List of topics:
1. Introduction
2. Installation
3. Running the Program
4. Shareware
5. Distribution and Disclaimer
6. Contacting the Author
7. Development History


1. Introduction
This utility came into being after I realised that the %RS routine supplied as standard in 
MSM did lack a few extras that I regularly needed. The utility performs a routine search 
for a string within user selected routines.

%RS:
? Lacks a facility to total the number of lines and total occurrences of the string
within the found programs. I normally need these values as initial estimates on the 
duration/cost of maintenance runs within existing code. Year 2000 projects are such 
examples. For example, how frequent is a global referenced within a few thousand 
routines?
? Does not provide a summary. Each search must list the line occurrences. The 
majority of my needs do not require such information (although %CBRS does allow the 
user to select whether the output should be detailed or not).
? Does not have a facility to pause the screen. For output to a printer this might
not be a problem (even though skipping over the perforation is catered for in %CBRS), 
but for those inquiries on the screen a large number of occurrences make reading 
the information close to impossible.
? Does not automatically set page width and page length depending on whether output
is being directed to a printer (defaults to 132 characters) or screen.

This program has now moved out of BETA but if you encounter a problem with it send an 
e-mail to chribonn@letterbox.com. Also send in your suggestions as to how it can be 
improved further.

2. Installation
Open the ZIP archive.
Run your version of MSM
Using %RR, load the file %CBRS.RTN into the MGR UCI so that it will be available in 
all other UCI's. 
DO ^%CBRS to run the program.

3. Running the program.
The program is very simple to run. If you place it in the MGR UCI you would be able to 
invoke it from any other UCI. Once loaded (via a D ^%CBRS) you have to supply the 
following:
? Routine Selector	- The routines you would like to look for;
? Search for		- The string you want to look up;
? Output Device	- Where the search results should be directed to;
? Lines per page	- How many lines will the routine display before pausing;
? Page width	- Self explanatory.

Pressing a `?" gives context sensitive help. Pressing `^' at any prompt takes you to the 
previous one.

The program now gives a summary of the number of files that contained the searched for phrase.
Once the search is complete, a prompt will ask whether the found files are to be researched.
Pressing <N>o will terminate the program, pressing <Y>es will allow you to research only the
shortlist. This iterative search can be performed over and over again.

4. Shareware
%CBRS is a shareware program  and there is no charge if you are using this program for 
personal purposes although an e-mail is appreciated. If this program is used within a 
commercial environment a registration fee of $15 is mandatory after the 30 day trial 
period.

Any income earned from this program will be used to initiate some projects in M Web 
Magazine at http://www.geocities.com/SiliconValley/7041/mwm.html so if you can pitch 
in you'll see your donation turned into something useful to the entire M community.

For corporate/multiple licensing please contact the author.

5. Distribution and Disclaimer
%CBRS may be distributed by any means, provided that the original files as supplied by 
the author remain intact. This program may be placed on any archive or BBS system.

If used in a commercial environment, the program must be registered if used beyond the 
evaluation period.

This program can not be bundled with any commercial package or distributed by itself 
without express written permission from the author.

The author of this program accepts no responsibility for damages resulting from the use 
of this product and makes no warranty or representation, either express or implied, 
including but not limited to, any implied warranty of merchantability or fitness for a 
particular purpose. This software is provided "AS IS", and you, its user, assume all risks 
when using it.

By installing this program you implicitly agree to the rules outlined above.

6. Contacting the Author
The latest version of this program can always be downloaded from Chris 
Bonnici's M Page @ http://www.geocities.com/SiliconValley/7041.

Electronically, Chris Bonnici can be reached at chribonn@letterbox.com. 

Comments and suggestions are welcome.

7. Development History
Revision 1.00  - Feb 1998
- %CBRS move out of BETA
- Arranged Order of Prompts
- Cleared out problem with display when outputting to a printer
- Added Shortlist Research
