home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Shareware Overload
/
ShartewareOverload.cdr
/
windows
/
browse16.zip
/
BROWSER.TXT
< prev
Wrap
Text File
|
1988-01-27
|
40KB
|
1,422 lines
Browser 1.6 -- A Shareware Windows Application
Copyright 1988, Morrie Wilson
Browser is a MS Windows application designed to allow users
to browse files in a MS Windows environment. In addition to
the browse capability, it supports printing, clipboarding,
and a hex dump display. Browser also features the new and
unusual Hide & Seek information extraction technique.
Table of Contents
Licensing and Duplication Information
Duplication Restrictions....................... 3
General Licensing Information.................. 4
Shareware Licensing Information................ 5
Shareware Update Information................... 6
Commercial Licensing Information............... 7
Using Browser
Getting Started with Browser................... 8
Moving Around in Browser....................... 9
With the KEYBOARD........................... 9
With a MOUSE............................... 10
Browser Commands.............................. 12
FILE....................................... 12
HIDE & SEEK................................ 14
PRINT...................................... 15
CLIPBOARD.................................. 16
OPTIONS.................................... 17
GET HELP WINDOW............................ 18
System Menu Extensions........................ 19
Appendices
Appendix A - Hide & Seek Tutorial............. 20
Appendix B - Shareware Questions & Answers.... 22
Appendix C - Browser Version Information...... 23
BROWSER 1.6
2 Licensing and Duplication Information
Duplication Restrictions
Browser is a shareware product. It may be freely copied and
distributed for evaluation as long as four basic rules are
followed. These rules are:
1) The program and this documentation may not be
modified in any way.
2) A copy of this documentation is provided with
the program.
3) No charge, other than a media and handling
charge, (not to exceed $5.00) is made.
4) Users of the program are encouraged to purchase
a license for its use.
If a copy of this program is retained, an obligation to
purchase a license for its use is incurred. A license for
use of this program costs only $15.00.
BROWSER 1.6
3
General Licensing Information
Browser may be either licensed as a shareware or as a
commercial program. The shareware option is for general use
by private individuals and most businesses. The commercial
option is available to businesses whose accounting systems
cannot adapt to the shareware software distribution method.
A purchase of a shareware license assumes that a copy of the
software has already been obtained, and that the user wishes
to retain the copy for future use.
Licensed shareware users may purchase an update at any time
for a $5.00 handling fee. If you wish to purchase a share-
ware license and do not have a copy of this program, be sure
to purchase an update at the same time.
With the purchase of each commercial license, a copy of the
software and documentation will be shipped to any U.S
destination.
BROWSER 1.6
4
Shareware Licensing Information
In order to purchase a shareware license, enclose the
following items in an envelope and mail to the address given
below:
Enclose: 1) A check for $15.00
2) The serial number of the copy of Browser being
used (See initial screen display of Browser for
this information)
3) Name and address
Mail to: Wilson WindowWare
3377 59th SW
Seattle WA 98116
One license per usable copy of Browser is required. Archive
and backup copies do not count.
Please note that no copy of the software will be sent to
you. If you want or need the latest copy of Browser, be
sure to also purchase an update as explained later on.
Please note that if you purchased a disk containing this
software from a public domain/shareware software distributor
you have paid the media and handling charges as permitted in
the "Duplication Restriction" section. You have not
purchased a license. A canceled check made out to Wilson
WindowWare is the standard proof of a paid license.
The accuracy of the information supplied here and the
fitness of the Browser program for any purpose may change
without notice, and should not be construed as any kind of a
commitment. No responsibility is assumed for any errors or
problems that may be encountered with use of this product.
There are no warranties whatsoever associated with this
product.
BROWSER 1.6
5
Shareware Update Information
In order to purchase an update to Browser, (assuming you
have a shareware license) enclose the following items in an
envelope and mail to the address given below:
Enclose: 1) A check for $5.00
2) The serial number of the copy of Browser being
used (See initial screen display of Browser for
this information)
3) Name and address
Mail to: Wilson WindowWare
3377 59th SW
Seattle WA 98116
BROWSER 1.6
6
Commercial Licensing Information
In order to purchase the commercial versions of this
package, enclose the following items in an envelope and mail
the the address given below:
Enclose: 1) A check for $40.00
2) Company name and shipping address
Mail to: Wilson WindowWare
3377 59th SW
Seattle WA 98116
The following materials will be shipped via UPS.
1) The Browser software on a 5 1/4" DD diskette.
(3 1/2" versions are not yet available, however
you may copy the program to 3 1/2" diskettes if
desired.)
2) Printed copy of applicable documentation, with
softcover binder.
3) Shipping paperwork identifying contents of
package.
One license per usable copy of Browser is required. Archive
and backup copies do not count.
The accuracy of the information supplied here and the
fitness of the Browser program for any purpose may change
without notice, and should not be construed as any kind of a
commitment. No responsibility is assumed for any errors or
problems that may be encountered with use of this product.
There are no warranties whatsoever associated with this
product.
BROWSER 1.6
7
Using Browser
Getting Started with Browser
Browser can be invoked in a number of ways, detailed as
follows:
1) Via the MS-DOS menu in Windows.
2) Via the Point and DoubleClick capability.
Selected file extensions may be defined within
the WIN.INI [extensions] section file to start
various Window Applications. Browser may be
defined in this section. For example, to
initiate Browser whenever a .TXT file is
doubleclicked in the MS-DOS menu, the following
would be entered:
TXT=BROWSER.EXE ^.TXT
Other extensions may also be entered to allow
Browser initiation by simple doubleclicking.
See the Windows documentation for a more
detailed explanation of this topic.
3) Browser may also be initiated by various Windows
Menu products that are available. See the
applicable product documentation for further
information.
4) Browser may also be started in a Window running
a copy of COMMAND.COM (Yes. It runs quite nicely
in a window) by entering BROWSER from the DOS
prompt.
Once started, Browser will display its copyright notices and
indicate that additional information may be obtained by
selecting "About...". See the section on the FILE command
for more information.
BROWSER 1.6
8 Moving Around in Browser
With the KEYBOARD
Once a file is select for browsing, the following keys
become active, thus allowing the user to navigate throughout
the document. (There are no surprises here, things work
pretty much as one might expect.)
Pg Dn - Moves down one screen
Pg Up - Moves up one screen
End - Moves to end of file
Home - This one is tricky.
If the window on the file has been
shifted to the right (i.e. column
1 is no longer visible) then Home
will shift the window to the left
back so that column 1 becomes
visible.
If column 1 is visible, then Home
causes a move to the beginning of
the file.
Up Arrow - Moves up one line
Down Arrow - Moves down one line
Left Arrow - Moves left one column
Right Arrow - Moves right one column
BROWSER 1.6
9
With a MOUSE
The usual Windows scroll bars appear at the right and bottom
(except for HEX DUMP mode) of the Browser Window. These are
called the Vertical and Horizontal scroll bars. Each scroll
bar consists of the following parts:
Arrows - One arrow at either end pointing
in opposite directions. The
arrows are at either end of the
"Elevator Shaft".
Elevator Shaft - An area the "Elevator" moves in
(usually colored red).
Elevator - A small box which moves around in
the Elevator shaft. The position
of the elevator in the shaft gives
a visual cue to the approximate
portion of the file currently
being displayed (usually colored
white).
Browser recognizes three types of mouse activity when the
mouse is pointing to one the special areas as defined above.
These activities are:
1) Mouse clicking. When the primary mouse button
(usually the left) is quickly pressed and
released, Browser considers this a mouse click.
2) Mouse holding. When the primary mouse button is
held down, Browser considers this a series of
mouse clicks (at a rate of several per second).
3) Mouse Dragging. When pointing to one of the
elevators, and the primary mouse button is held
down and moved in the elevator shaft, the
elevator will follow the mouse pointer (as long
as it stays in the shaft).
BROWSER 1.6
10
The following mouse actions are recognized:
Clicking the Up Arrow - Moves up one line
Clicking the Down Arrow - Moves down one line
Clicking the Left Arrow - Move left one line
Clicking the Right Arrow - Moves right one line
Clicking the shaft above the Vertical Elevator
- Moves up one screen
Clicking the shaft below the Vertical Elevator
- Moves down one screen
Clicking the shaft left of the Horizontal Elevator
- Moves left a bunch of
columns
Clicking the shaft right of the Horizontal Elevator
- Moves right a bunch of
columns
Dragging Vertical Elevator to any position
- Instant reposition to any
line in the document
Dragging Horizontal Elevator to any position
- Instant reposition to any
column in the document
BROWSER 1.6
11 Browser Commands
FILE
The FILE pull down menu contains five options. These are:
OPEN - Used to select file to browse. When
selected, a listbox will appear.
The files in the current directory will appear
at the top of the list, followed by allowable
disk drive entries (e.g. [A]), the parent
directory entry ([..]), and the list of
subdirectories of the current directory (e.g.
[SUBDIR]).
Any item in the list may be selected.
If a file is selected, browser will open that
file for display.
If a disk drive or a directory-type entry is
selected, the listbox will be updated with
information from that drive/directory.
In addition, search specifications may be
entered in the editbox found just above the list
of filenames to limit the display to particular
groupings of files. (e.g. the default entry in
the editbox is *.*, which causes all files to be
listed. You may enter *.bak to list only files
ending in .bak for selection.
CLEAR - Clears previous file, if any, from memory.
This is useful for reclaiming memory used by
browser in the display of files.
ABOUT... - Selecting the ABOUT... command will
display some information about Browser.
BROWSER 1.6
12
FILE (Continued)
EXIT - Exits Browser and closes the window.
FILE STATS - Various bits of information about the
file are displayed in a pop-up window.
DELETE FILE - Allow immediate deletion of the file
currently being viewed.
If this item is selected, a popup window will
appear asking the user to confirm the deletion
request.
BROWSER 1.6
13
HIDE & SEEK
The HIDE & SEEK feature allows a user to control the shown
(displayable) and hidden (non-displayable) lines of text,
based upon whether or not a given line contains specified
text strings. Appendix A contains a short tutorial on the
HIDE & SEEK function.
The HIDE & SEEK pull-down menu reveals a number of options.
These are
FIND - Allows specification of up to a 32 character
string to search for. A forward search for the
string is performed, and, if found, the file
pointer will be positioned to that point, and
the line will be displayed in inverse video. (If
the line was previously hidden, it will be
shown.)
FIND NEXT - Finds the next occurrence of the string
last specified in the Find command. (If the
line was previously hidden, it will be shown.)
HIDE ALL - Marks every line of the file as hidden
(non-displayable). Generally used immediately
prior to a FIND or SHOW IF command.
HIDE IF - Allows specification of up to a 32
character string to search for. The entire file
is searched. Any line on which the string is
(or is NOT - depending on selection) found will
be marked as hidden (non-displayable).
SHOW ALL - Marks every line of the file as
unhidden (displayable). Undoes effects of HIDE
commands.
SHOW IF - Allows specification of up to a 32
character string to search for. The entire file
is searched. Any line on which the string is
(or is NOT - depending on selection) found will
be marked as unhidden (displayable).
INVERT - Swaps the hidden status. All lines
previously hidden will become unhidden and all
lines previously unhidden will become hidden.
BROWSER 1.6
14
PRINT
Text may be printed, either as text or a hex dump. Browser
will attempt to approximate the currently selected font for
printing. A choice of the entire file, or just unhidden
(displayable) lines may be made.
PRINT ALL - The entire file is spooled to
the default printer.
PRINT SHOWING - Displayable lines are spooled
to the default printer.
PRINT PAGE ADVANCE - Default printer is advanced
one page.
Note 1: Browser will print on the system default printer.
You may change the system default printer by:
1) Get Windows Control Panel, via Browser System
Menu (that's the little box in the upper left
hand corner)
2) In the control panel, get the SETUP menu and
select the PRINTER... option.
3) Select the printer you want.
Note 2: If you want Landscape (sideways) print, you can:
1-3) See Above
4) If the printer driver is smart enough, a panel
will appear on which you can select Landscape
print.
BROWSER 1.6
15
CLIPBOARD
Text may be sent to the clipboard. A choice of the entire
file, or just unhidden (displayable) lines may be made.
If the Hex Dump option is currently selected, then the Hex
Dump will be copied to the clipboard.
CLIPBOARD COPY ALL - Replaces clipboard
contents with the entire
current file.
CLIPBOARD COPY SHOWING - Replaces clipboard
contents with the
displayable lines of the
current file.
BROWSER 1.6
16
OPTIONS
The OPTION pull-down menu allows control for the display
format. The following options are available.
ASCII TEXT - MS-DOS default text style. Used to
view most files. Exact display may differ with
machine used.
ANSI TEXT - Windows default text style
RULER - If selected a display of line and
column numbers will appear at the top of the
file display. The Ruler may turned on and off by
repeated selection of this command.
EXPANDTABS - If selected (default) the tab
characters encountered in the file will be
expanded. Tab stops occur every 8 characters.
The ExpandTabs function can be turned on and off
by repeated selection of the command.
ADD LF AFTER CR - If selected, a Linefeed will be
appended to each carriage return encountered.
Useful for viewing certain files in non-standard
formats.
7 BIT TEXT - High bit of each character is ignored.
Used to display files usually made by word
processors that set the high order bit of
characters to encode word-processor specific
information. If the file you are viewing seems
to contain some garbage, try this option.
HEX DUMP - A Hex dump of the file is provided. The
ASCII/ANSI selection and the 7-Bit Text
selection are used to display the "non-hex" data
at the right of the hex dump.
BROWSER 1.6
17
GET HELP WINDOW
The Get-Help-Window menu item displays a special Browser
Quick Reference Window. Any menuitem selected in this
special window will provide a short description of its
actions in the window text area.
The normal Browser window is still active, and can be used
to actually execute the command. This is a good way to
become familiar with Browser.
Once the Get-Help-Window command has been selected, the
command changes to Close-Help-Window. The Close-Help-
Window command, if selected, will close the Quick Reference
Window.
The two system commands available in the System Menu, Move
and Close, do not provide help, but instead allow you to
move the Quick Reference Window, or to close it (as an
alternative to the Close-Help-Window menuitem).
BROWSER 1.6
18 System Menu Extensions
A number of additional menu items have been added to the
basic Windows system menu. These are:
RUN ANOTHER BROWSER
It is often found that it is useful to browse two files at
once, especially to compare two similar files to examine the
differences. The Run-Another-Browser function will start
another browser on the screen.
RUN CONTROL PANEL
The Run-Control-Panel function will bring up the Windows
Control Panel. The Control Panel may be used to setup the
default printers for the Browser print function, and also to
select Landscape (sideways) print if desired.
RUN CLIPBOARD VIEWER
The Run-Clipboard-Viewer function will bring up the Windows
Clipboard Viewer. This is handy to verify the contents of
the Clipboard after Browser clipboard operations.
RUN NOTEPAD EDITOR
The Run-Notepad-Editor function will bring up the Notepad
Editor. This is a convenience item.
BROWSER 1.6
19
Appendices
Appendix A - Hide & Seek Tutorial
The Hide&Seek capabilities may seem a bit strange for users
unfamiliar with the Hide&Seek concept. A few simple examples
should shed some enlightenment on this subject.
First of all, a few simple examples:
1) Source code for a program resides in a text
file. It is desired to view all all lines in
the file where the variable
"SnorkleGrassCounter" occurs.
Simply perform a HIDE IF command. A popup
window will appear, The window will request a
text string, and whether to hide the lines
containing the string, or the lines that do NOT
contain the string.
Specify "SnorkleGrassCounter" in the HIDE IF
Dialog Box, and also select the "do NOT" option.
Either push the return key, or select the HIDE
pushbutton. Voila.
2) To temporarily view the remainder of the file,
without having to re-specify the HIDE IF
command, the INVERT command may be used to
flipflop the hidden and displayed lines.
BROWSER 1.6
20
Appendix A - Hide & Seek Tutorial (Continued)
A sample file, BROWSER.DAT, has been provided for your
perusal. It contains a list of fictitious people and some
attributes of those people. It is intended to be used when
experimenting with the Hide&Seek capabilities.
Perform the following operations on BROWSER.DAT for more
insight into the Hide&Seek capabilities.
A charity basketball game is to be organized. There are a
number of tasks to perform. Referring to a list of friends
in BROWSER.DAT.
1) To select members of the basketball teams,
perform a HIDE IF operation, selecting those
lines that do NOT contain the word "tall".
2) Some radio, TV and print ads must be made.
First, perform a HIDE ALL operation to hide the
entire file. Then do a SHOW IF to find lines
containing "ad", do additional SHOW IF
operations for "radio", "TV", "model","write".
4) Someone will be required to help with the
organization of this project. Do a HIDE ALL
followed by a SHOW IF "organize".
5) Funds to rent the gym will be required up front.
Show the "rich" people.
6) Tickets will need to be sold to local
businesses, and other "fund" raising activities
will be required. Good Luck.
It is recommended that some time is spent simply playing
with the Hide&Seek capability, since this capability, and a
text file of information, can sometimes completely replace
data base processors costing hundreds and hundreds of
dollars more.
BROWSER 1.6
21
Appendix B - Shareware Questions & Answers
A number of common questions concerning shareware software
are often asked. Provided below is a short list of some of
these questions with the answers.
Q: What kind of people actually pay for shareware software
that they already have.
A: Honest people.
Q: Is the obligation, for private individuals, to pay for
shareware software enforceable.
A: Not in this life.
Q: Is the obligation, for businesses and corporations, to
pay for shareware software enforceable.
A: Yes. Unauthorized commercial use of copyrighted material
is a violation of federal copyright laws. The main means of
detection of this kind of activity are disgruntled
employees.
BROWSER 1.6
22
Appendix C - Browser Version Information
Version Information for Browser 1.6
Immediately below is a list of differences that this version
of Browser has when compared to previous releases of
Browser. This is generally only of interest when updating
to a new copy of Browser from a previous release.
Changes first appearing in Browser 1.6
1) Fixed problem that caused the "WIN BROWSER"
incompatibility with Windows 2.0x
2) New icon (Helps with 2.0x) and cosmetic changes
as dictated by 2.0x
Changes first appearing in Browser 1.5
1) A few cosmetic changes to improve Browser's
appearance under Windows 2.x. It is not yet a
true 2.0x application, however it is still
compatible with older versions of Windows.
2) Fixed a bug which caused an inability to scroll
when using hex mode with large files.
BROWSER 1.6
23
Changes first appearing in Browser 1.4
1) Print and Clipboard capabilities.
2) Improvement in screen display of formfeed's, and
standalone carriage-return's and linefeed's in a
file.
3) Procreate (Make Another Browser) bug that
occasionally hung systems running with DOS 2.x
4) Get-Another-Browser, Get-Clipboard-Viewer, Get-
Notepad-Editor and Get-Control-Panel commands
now in system menu (ala Brand-Name software).
5) File Delete Capability.
6) Modified mechanization of ANSI/ASCII, 7-bit, and
Hex Dump option selections.
7) Browser Help Window available to provice a quick
summary of each Browser menuitem.
Changes first appearing in to Browser 1.3
1) Point & DoubleClick capability via the WIN.INI
file.
2) Browser can now understand filenames passed from
Windows.
3) Improved Documentation
BROWSER 1.6
24
Changes first appearing in Browser 1.2
1) Handling of short files (less than 1 screen)
modified to fix Find and Find Next bug.
2) Ignore case option added to Find, Show, and Hide
commands.
Changes first appearing in Browser 1.1
1) Expand Tabs function fixed.
Version 1.0 - Initial non-test release.
BROWSER 1.6
25
