Category : Windows 3.X Files
Archive   : WRCH23.ZIP

Output of file : WINROACH.DOC contained in archive : WRCH23.ZIP

WinRoach 2.3
User's Manual

March 11, 1994

Copyright (c) 1991-1994 New Generation Software
All rights reserved

For IBM, PC/XT, PC/AT, PS/2 and compatibles

New Generation Software
P.O. Box 9700, Dept. 282
Austin, TX 78766

Orders:(800) 964-7638
(512) 795-8587
Fax: (512) 388-4053
Tech: (512) 795-8300


OVERVIEW . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

PACKAGE CONTENTS . . . . . . . . . . . . . . . . . . . . . . . . 1

FEATURES . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

INSTALLATION . . . . . . . . . . . . . . . . . . . . . . . . . . 2

REGISTRATION . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Why Should I Register??? . . . . . . . . . . . . . . . . . . 3
How do I Register??? . . . . . . . . . . . . . . . . . . . . 3

USING WINROACH . . . . . . . . . . . . . . . . . . . . . . . . . 4
What you will see... . . . . . . . . . . . . . . . . . . . . 4
WinRoach Menu Items . . . . . . . . . . . . . . . . . . . . 4
Killing a roach . . . . . . . . . . . . . . . . . . . . . . 5

LICENSING AND DISTRIBUTION . . . . . . . . . . . . . . . . . . . 6

PUBLIC DOMAIN AND SHAREWARE . . . . . . . . . . . . . . . . . . . 7

ASP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

TRADEMARKS . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

LIMITED WARRANTY . . . . . . . . . . . . . . . . . . . . . . . . 8

WinRoach Registration Form . . . . . . . . . . . . . . . . . . . 9

WinRoach Vendor Application Form . . . . . . . . . . . . . . . . 10

New Generation Software (NGS)
W i n R o a c h 2.3

An Entertaining Windows 3.0 & 3.1 program that delivers just what you
would expect:

Roaches, Roaches, everywhere... They scurry across the screen and hide
under windows. When they get in your way, use the mouse to "squash"
and "exterminate" those pesky roaches.


This entertaining program will make closing and moving your windows a
treat. Why? Because every time you close or move a window, roaches
may become exposed, and just like real roaches, they'll want to run
and hide. When exposed, our roaches will immediately scurry to hide
behind the next active window. If they find another window to hide
under on the way to the active window, they'll hide under it.

As an added treat, our roaches will wander out from behind the windows
they are hiding. They will run out to the edge of the desktop, and
then they'll scurry back under a window. If the desktop is completely
covered with windows, the roaches will not be able to wander.

Just like real roaches, they vulnerable to being stepped on. Just
position the mouse pointer over the roach (if you can catch one) and
use the mouse button 1. If you hit one, you'll know it!

When the roaches are hidden there is no impact on system performance,
so you can afford to have this program up at all times to keep things
exciting when you close or move windows. If wandering roaches start
to impact system performance, simply increase the frequency to have
the roaches wander less frequently.


WINROACH.ZIP contains the following files:

WINROACH.DOC Installation & User's Guide
WINROACH.EXE WinRoach Program
REGISTER.EXE Registration Program called by WINROACH.EXE

NOTE: WinRoach does not work with the program "After Dark"


* Ability to add up to 10 roaches that'll scurry under the active
window when exposed.

* Ability to set the default number of roaches that are created
at startup time.

* Ability to control the speed of the roaches via the Options

* Ability to control how often roaches wander. To prevent the
roaches from wandering, just set the Wander Frequency to 0 in
the Option's dialog box.

* Ability to squash the pesky roaches using mouse button 1! By
placing the cursor over the roach and pressing mouse button 1,
"splat" goes the roach.


WinRoach is easy to install. First, you will need to unzip the
WINROACH.ZIP file into a subdirectory (i.e. C:\WINDOWS). You will
need an unzipping utility, like PKUNZIP, to do this.

Once unzipped, you have two choices to get WinRoach up and running.

1. To allow WinRoach to run automatically every time you start
Windows, you will need to modify the WIN.INI file found in the
Windows subdirectory. By editing the line containing the LOAD
keyword, append the program name WINROACH.EXE.


The next time you start Windows, WinRoach will be started for you

2. If you wish to start WinRoach manually, it would be best to
install WinRoach into a group menu of the Program Manager.
Choose 'New' off the 'File' Menu of the Program Manager (Refer to
the Windows' documentation on how to install programs within a
Group of the Program Manager).



WinRoach is a Shareware product and is available to you free of charge
for a period of 30 days. If you intend to use this product, we
encourage you to register WinRoach. The base registration fee is

Why Should I Register???

By registering your copy of WinRoach you will:

* Receive a registration number that can be entered into
WinRoach. This will remove the annoying About box that
appears every time you start WinRoach.

* Receive a mailed invoice (no diskette).

* Encourage NGS to continue producing new Window's

For an additional $3.50 (Shipping and Handling, $5.00
overseas) you will receive a diskette containing a registered
version of WinRoach and its source code.

How do I Register???

Well, the quickest way to register is to call us at 1-800-
964-7638 or (512)795-8587. After we take your order
information, you will be given a registration name and
number that you will type in the Registration Dialog Box.
Make SURE you type in both the name and number EXACTLY the
way you received the information. All customers are sent
a diskette and charged $3.50 (outside US $5.00) shipping
and handling.

You also may register by sending the Registration Form
(found at the bottom of this document) to NGS by:

* Sending the form via Fax to: (512) 388-4053

* Mailing the Form to:

New Generation Software
P.O. Box 9700, Dept. 271
Austin, TX 78766

* Sending the form electronically (E-mail) to NGS on
Compuserve ID: 70312,127



What you will see...

When WinRoach is started, you will first see the WinRoach icon.
There is no window associated with this program. Shortly there
after, you may notice a number of roaches (four is the default)
have been placed randomly on the desktop.

If any of the roaches are exposed, they will immediately scurry
to hide behind the active window or icon. As time goes on, you
will notice some roaches wandering among the desktop.

WinRoach has a few menu items that will allow you change various
parameters. The WinRoach menu items have been placed in the
standard system menu. To bring up this menu, just position the
mouse pointer over the WinRoach icon and press the mouse
button 1.

WinRoach Menu Items

When you bring up WinRoach's system menu, you will notice a few
more items included with in the standard menu. Below is a
summary of what each new menu item performs.

The current WinRoach menu items are:

Add Roach This options creates another roach and places
it randomly upon the desktop (up to 10

Delete Roach This option will delete a roach from the
desktop. It randomly picks which roach to
Options... This will bring up WinRoach's dialog box that
allows you set its various options. These
options include:

* The number of roaches that will appear when
WinRoach is started
* How fast the roaches will scurry
* How often the roaches will try to wander.

The options will be kept within WinRoach's
own WINROACH.INI file.

ReScatter This options rescatters all of the roaches
over the desktop. You can use this option if
you want to find the roaches without closing
or moving your windows.

About... This option brings up the About Box dialog
for WinRoach.


Setting WinRoach Options

WinRoach's Options dialog will allow you to set various
parameters that are used during the startup of WinRoach and while
it is running. These options will be kept in a file created
within you Windows subdirectory named WINROACH.INI.

WinRoach Options dialog is divided into two groups. The first
deals with the number of roaches that are created at startup
time, and the other deals with the roach's characteristics.

Default Number of Roaches: Initially, WinRoach is setup to
create four roaches. You can set the default startup count up to
ten roaches. The value will only take affect upon the next time
you startup WinRoach.

Roach Speed: This value indicates how fast the roaches will
scurry along the desktop. The value is in milliseconds which
means that the smaller the number the faster the roaches will
move. If you use the spin buttons next to the entry field, they
will increment or decrement the value in the entry field by 10

Roach Wander Frequency: This value indicates how frequently the
roaches will wander from behind the window they are hiding. The
initial value is set to 15000 milliseconds which means that about
every 15 seconds, a roach has a chance of wandering. If you
would like to increase the chance of a roach wandering, decrease
this number. If you would like to prevent the roaches from
wandering, then simply set this number to 0 and the roaches will
stay put.

Killing a roach

As an added feature, we've added the ability to "squash" out
those pesky critters. If you position the mouse pointer over a
roach and press the mouse button 1, just be prepared if you hit
one. Remember, the faster they move, the faster it is to catch



WinRoach is copyright and has been released for distribution as
SHAREWARE. Please note that a great deal of effort and time has been
invested in the development of this program. You are granted a
license to try WinRoach for a reasonable trial period without risk.
If, after this time, you find this program useful and intend to use
it, you are expected to register. The base registration fee is

You will find a registration form at the end of this user's manual
that outlines the procedures for registering your copy of the program.
Please keep in mind that NGS must have a registration form on file for
you before any product support can be offered.

Operators of electronic bulletin boards (Sysops) are encouraged to
post WinRoach for downloading by their users. WinRoach may be
uploaded to and downloaded from commercial systems such as CompuServe,
the Source, and BIX. The only charge paid by the subscriber is for
on-line time and there is no charge for the program. Those copying,
sharing, or electronically transmitting the program are required not
to delete or modify the copyright notice and restrictive notices from
the program or documentation; anyone doing so will be treated as a
contributory copyright violator.

If you are passing this program on to others, uploading it to a
bulletin board system, or including it in a user's group library, do
not separate the files contained in the distribution archive - pass
the entire archive on to the intended party. This ensures that those
who receive the program will have all the correct configuration
utilities and documentation necessary to get WinRoach up and running
quickly. A listing of the files you should have and a description of
each is listed in a previous section of this document.

The WinRoach documentation may not be modified by users. The program
may not be separated from the documentation when distributed. Printed
or Photocopies ("Xeroxed") copies of the WinRoach documentation (i.e.,
this manual) may not be distributed or sold without the written
permission of the New Generation Software.

No other person other than NGS, may accept payment or royalties for
this program. This license to use WinRoach does NOT include the right
to distribute or sell WinRoach. Distribution terms are detailed on
the next page.



Distributors of "public domain" or user-supported software libraries
must obtain written permission to distribute copies of WinRoach. No
one may use WinRoach as a promotion for any commercial venture or as
an enticement for the user to pay for any program, product, or service
unless they have received the express written permission of NGS.

In order to distribute WinRoach, a dealer or disk vendor must comply
with the following conditions:

1. You must obtain written permission from NGS to distribute WinRoach.
Please use the vendor application supplied near the end of this user
manual. If you receive no reply, write again: Silence does NOT
constitute permission, and you may not distribute "pending" receipt of

2. A maximum disk fee as set by NGS in the vendor contract must not be
exceeded. WinRoach may not be included on any disk sold for more than
this maximum. Major CD-ROM or optical disk libraries are exempt from
this restriction, provided that they have NGS's permission to
distribute WinRoach.

3. Vendors may not modify or delete ANY files on the disk. Vendors may
add a "GO" program, or a reasonable number of small text files
designed to assist or provide a service to the user, but these added
files must be easily identifiable and end-users must be allowed to
delete the added files.

4. Vendors must make a reasonable effort to distribute only the
most recent versions of WinRoach. All vendors who have requested
and received written permission to distribute WinRoach will receive
new MAJOR releases as they are issued.

5. All disk vendors must comply with any and all vendor guidelines
vendor requirements set forth by the Association of Shareware
Professionals (ASP); for more information about ASP, contact its
chairman, Jim Button, at Buttonware in Seattle. Violation of any ASP
guideline or requirement automatically revokes permission to
distribute WinRoach.

Until formal requirements are adopted by the ASP, you must comply
with the following guidelines: Vendors must make an attempt to
educate users on the nature of Shareware. Catalogs,
advertisements, order forms, and all disks sold should contain
ASP-approved or recommended wording describing the nature of
shareware, and should explicitly state that no part of disk sale
revenues are paid to the programs' authors. When vendor catalogs
or advertisements carry both Shareware and PD programs, the
Shareware programs must be differentiated from the public domain
programs in some way (in the description, with an asterisk, by
listing the registration fee, etc.).



WinEZ is a Shareware program conforming to standards as established
by the Association of Shareware Professionals (ASP) located at 325
118th Ave. S.E., Suite 200, Belleview, WA 98005.


The following trademarks and service marks appear in this product:

Microsoft(R) and Windows(TM) are registered trademarks of
Microsoft Corporation.

PKUNZIP(R) is a registered trademark of PKWARE, Inc.

Norton Desktop is a registered trademark of Symantec

IBM is a registered trademark of International Business


This program and the accompanying documentation is provided "AS IS"
without warranty of any kind, either expressed or implied,
including but not limited to the implied warranties of
merchantability and fitness for a particular purpose with respect
to defects in the program or documentation. New Generation
Software assumes no risk as to the quality and performance of the
program. Should the program prove defective, you assume the entire
cost of any loss of profit or any other commercial damage. Some
states do not allow the exclusion of implied warranties so the
above exclusion may not apply to you. This statement shall be
construed, interpreted, and governed by the laws of the state of


WinRoach Registration Form





City:________________________________ St:______ Zip:________________

Phone: (______)_________________


Registration Fee(s) ______ @ $14.95 each: _______.____

ALL customers are sent a diskette with every
purchase. This guarantees the user that
he/she will receive the most current version
of the product. There is a $3.50 (outside the
US $5.00) shipping and handling charge.

Specify Diskette Size: ____3.5" ____5.25"

$3.50 (outside US $5.00) Shipping and Handling $ 3.50 (or $5.00)

Texas Residents add 8% sales tax: _______.____


Please enclose a check payable to New Generation Software. You may also
use your Visa or MasterCard. For credit cards, please enter the
information below:

Card #: __ __ __ __ - __ __ __ __ - __ __ __ __ - __ __ __ __

Expiration date: ____/____ Circle Type: Visa / MasterCard

Signature: _________________________________________

Where did you get your copy of WinRoach?____________________________

CompuServe Userid (if applicable): ____________________________

-------- --------
New Generation Software Ltd. Orders:(800) 964-7638 (512) 795-8587
P.O. Box 9700, Dept. 282 Fax: (512) 388-4053
Austin, TX. 78766

or send to us via CompuServe (70312,127)

(Please allow 3 weeks for delivery. All prices subject to change)

WinRoach Vendor Application Form

Company Name: ________________________________________________________

Address: ________________________________________________________



Phone: ________________________________________________________

Contact: ________________________________________________________

What price are you planning to charge for WinRoach? __________________

Would you like to receive major upgrades as they become available?____

I certify that the above named company is a legitimate shareware disk
vendor, and that the above named company will adhere to the policies
set forth in the "Public Domain and Shareware Libraries" section of the
WinRoach User Manual.

Signature:____________________________________ Date:________________


In order that We can verify that you are a legitimate shareware vendor, We
request that you include a copy of your product catalog with this
application, along with a blank diskette and mailer. Once you have been
approved, you will receive written permission from NGS to include WinRoach
in your library for distribution. Additionally, you will receive your
diskette back containing the latest WinRoach release. We are also
requesting that you send us revisions of your catalog as they are
published. The main reason behind this is that a mailing list of active
vendors will be maintained. Our continued receipt of your catalog will
both enable us to verify that you have the most recent WinRoach release
(within reason), as well as know that your business is still active.x

When major revisions are made to the program, We will send you the latest
upgrade such that your library is kept up to date.

Send this application to:

New Generation Software
P.O. Box 9700, Dept. 271
Austin, TX 78766

  3 Responses to “Category : Windows 3.X Files
Archive   : WRCH23.ZIP

  1. Very nice! Thank you for this wonderful archive. I wonder why I found it only now. Long live the BBS file archives!

  2. This is so awesome! 😀 I’d be cool if you could download an entire archive of this at once, though.

  3. But one thing that puzzles me is the “mtswslnkmcjklsdlsbdmMICROSOFT” string. There is an article about it here. It is definitely worth a read: