Category : Utilities for DOS and Windows Machines
Archive   : FB120.ZIP
Filename : FB.MAN

 
Output of file : FB.MAN contained in archive : FB120.ZIP


FileBrowser 1.20 Manual

















FFFiiillleeeBBBrrrooowwwssseeerrr





Version 1.20

(Freeware Version)





Copyright (c) 1988, 1989, David O. Tinker
All Rights Reserved







Table of Contents
Page

A. Introduction --- 1
1. Why FileBrowser? --- 1
2. Terms of Distribution --- 1
3. FileBrowser Features --- 2
4. History --- 3

B. Hardware and Software Requirements --- 4
1. Systems Tested --- 4
2. Memory Requirement --- 4
3. Technical Specifications --- 5

C. Installing and Running FileBrowser --- 5
1. Installing FileBrowser: --- 5
a) Specifying Temporary File Directory --- 5
b) Specifying External Editor --- 6
2. Running FileBrowser --- 6

D. FileBrowser Commands --- 8
1. HELP --- 8
2. PRINT --- 8
a) F - Print to File --- 8
b) P - Print to Lineprinter --- 9
3. BROWSE --- 9
4. SEARCH --- 10
a) Hints on using SEARCH --- 11
5. MARK --- 11
6. DOS --- 12
7. EDIT --- 12
8. QUIT --- 13
9. INFO --- 13
10. One-Key FileBrowser Commands --- 13

E. License and Warranty Disclaimer --- 14

F. Acknowledgements --- 15

G. License Registration Form --- 16









__________________________________________________________________





FileBrowser 1.20 Manual - Page (i)







AAA.. IInnttrroodduuccttiioonn

1. _W_h_y_ _F_i_l_e_B_r_o_w_s_e_r_?

FileBrowser is a utility to help you extract information
from text files: you can think of it as a "text spreadsheet"
program.

Like many people, I find that I often have to deal with
text files - LARGE text files: source code files, software
manuals, documents downloaded from such sources as Usenet,
BIX (tm), etc. As a university teacher, I have to cope with
large numbers of documents crossing my desk daily. But just
receiving a document is not the same as getting information
from it! In order to find and mentally process the
information I need, I have to read the document carefully, in
many cases going back and forth between sections,
highlighting words in the text, making notes in the margin,
and running down the hall to make photocopies of important
pages.

In many cases these documents are obtained in electronic
form, and the future prospect is that more and more documents
will be distributed online. Surely I ought to be able to use
my PC to get information out of such electronic documents
without actually printing them (which is time-consuming and
often not wanted)! However I found that the only available
way to read them is to load them into an editor or word-
processor, though only in very rare cases do I actually want
to edit the file I am reading - sometimes the file must NOT
be edited. And a text editor or word processor is not really
suited for the information processing task that I described
above.

To cut this story short, I found I needed a cheap and
effective file browser program! And so the idea for
FileBrowser originated. The outcome of that idea is in your
hands now. I use this program every day (not surprisingly,
since I wrote it to do what I wanted), and I hope you find it
meets your needs as well. It's certainly cheap!

2. _T_e_r_m_s_ _o_f_ _D_i_s_t_r_i_b_u_t_i_o_n

This program is "Freeware", which means it is NOT in the
Public Domain - it's copyrighted - but there is no charge for
its use. You use it under the terms of a fairly non-
restrictive license, which is included in this document:
you'd better read the license agreement, because if you use
this software you are implicitly assenting to its terms!

Registration of your license is optional and free, but you
are strongly encouraged to do so, for several reasons.
First, I'd like to see where, how and by whom it is being


FileBrowser 1.20 Manual - Page 1







used. Second, FileBrowser is currently being developed into
an application with lots more bells and whistles (this will
be shareware); I'd like to tell you about this when it's
finished. Please complete the registration form in this
document and send it in - it will only take a moment and cost
you one stamp. (For an incentive to register, see the
"History" section).

I had a lot of fun writing FileBrowser, and in a small way
it might repay the computer-user community for all the
education and enjoyment I have received from Public Domain
and Shareware programs, whose costs do not adequately reflect
the effort and skill their authors put into them.

3. _F_i_l_e_B_r_o_w_s_e_r_ _F_e_a_t_u_r_e_s

FileBrowser allows you to load an ASCII or Wordstar (tm)
file into a buffer in RAM and scroll through it. You can
scroll and page forwards or backwards through the file, or
jump ahead or back any number of lines, or use an auto-
scrolling feature which rolls the text forward or back at an
adjustable speed.

Just as you do with a printed document, FileBrowser allows
you to "highlight" parts of the text, so you can quickly find
them again (you use the keypad arrow keys to leap ahead or
backwards to highlighted lines). (Any or all highlights can
be removed, something you can't do with a Highlite pen on a
paper document!)

If you want to copy some lines to another file, you can do
so. This allows you to make excerpts from the text as you go
along -including any highlights you have added. You can also
print a block of lines using your lineprinter - highlighted
words will appear as underlined words in the printed
document.

When browsing a big text file, I often want to locate a
specific section that's in there *somewhere*, so FileBrowser
has the ability to look for strings of text (it finds them
quite rapidly too). A special "Search-and-Mark" command
allows you to highlight all the instances of a given word in
the text, either automatically, or pausing for confirmation.

If you really *do* need to edit the file, FileBrowser
allows you to exit to the editor of your choice, work on it,
then re-load the edited file.

When you have marked up a document with highlights, you
may not want to lose all your work - thus FileBrowser allows
you to make a copy of your document in a new file so you can
print it, or return to it later.



FileBrowser 1.20 Manual - Page 2







Finally, you can leave the file in RAM and load another
DOS shell, so that you can go on to other tasks and still
return to your place by typing 'exit' at the DOS prompt.
This is a great feature for folks working with a two-floppy
system, as it means you can remove the disks containing the
FileBrowser programs and the original file. (You will need
to have the original file and the accessory program FBE.COM
available if you want to use FileBrowser's "edit and return"
feature).

FileBrowser is easy to use: all the commands may be
executed from a pop-up menu line, or using simple one-key
commands, and you get feedback from the program as to what it
is doing and what it expects next; it can detect a number of
input errors and either correct them or give you an error
message. On-line help is readily available for all commands.
If you have a color monitor, you can see all these features
in vivid yet tasteful color, and you can alter the color of
the text to suit your own tastes - if you really like bright
green text on magenta, you can have it!

4. _H_i_s_t_o_r_y

Version 1.00
- Included WordStar (tm) compatibility, optional tabs
expansion, Menu Bar, On-line Help, Scrolling options,
Print-to-File, Print-to-Lineprinter, External Edit,
Search, DOS Shell.
- Released in Dec. 1988. Jan. 1989, distributed on
"Usenet" network (comp.binaries.ibm.pc). Apr. 1989,
published by PC-SIG as disk no. 1398.

Version 1.10
- Internal development version.

Version 1.20
- Released in Sept. 1989.
- Backwards compatible with Version 1.00 except for two
changes in the keystroke commands (the command to load
external editor is now given in Browse mode by typing
"E", not "V", and the Help "Hot Key" is "F1" not "F2").
- Fixed bug that allowed clever users to scroll past end
of file into never-never land.
- Fixed bugs to allow more graceful crossing of Disk
boundaries.
- Improved dynamic memory allocation to conserve RAM usage.
- Added direct Video writes for extra speed.
- Made colour the default option.
- Added command line options to specify CPU Speed,
external editor (no longer necessary to use DOS
Environment variable).
- Revised FBE.COM to make return to FileBrowser optional.
- Revised Menu Bar, with Pull-Down menus to assist novice


FileBrowser 1.20 Manual - Page 3







users (experts will still be able to use one-key
commands).
- Added MARK and SEARCH-AND-MARK commands.
- Added commands to change text colours.
- Added option to save text in a disk file.

Version 2.0 of FileBrowser is under development, and will be
released in early 1990. It will introduce "stick-on" Notes,
a clipboard, and some other neat features. By that time,
this program will be more than just a little browser utility,
and it will be Shareware - i.e. not free. Users of Versions
1.x who register prior to the release of Version 2.0 will be
able to receive the shareware version for just the cost of a
diskette.


BBB.. HHaarrddwwaarree aanndd SSooffttwwaarree RReeqquuiirreemmeennttss

1. _S_y_s_t_e_m_s_ _T_e_s_t_e_d

FileBrowser has been successfully tested on IBM-PC (tm) XT
and AT microcomputers and several 100% compatible machines.
It has been run using both CGA and EGA graphics adapter cards
for color display (a monochrome monitor may also be used with
these cards). It should run satisfactorily on any machine
using an IBM-PC (tm) or compatible BIOS, and a graphics
adapter which is compatible with the CGA text standard, but I
make no claims or guarantees (see Warranty Disclaimer,
below). Since the I/O uses direct writes to video memory, it
can *not* be run using other types of graphics cards, such as
Hercules.

You can certainly use FileBrowser on a two-floppy XT
system, but file-loading is slow - a hard disk is better, and
it really shines on an AT-class machine!

FileBrowser requires MS-DOS (tm) or PC-DOS (tm) version
2.11 or later. This software is compatible with Microsoft
Windows (tm), (though it was not written as a Windows
application), and with Borland's Sidekick (tm).

2. _M_e_m_o_r_y_ _R_e_q_u_i_r_e_m_e_n_t

In order to calculate memory usage by FileBrowser, use the
following formula:

M = 94 + 2.7*F

where M is the memory required (KBytes) and F is the size of
the file (ASCII) to be loaded, in KBytes. This gives an
approximate estimate only, and actual requirements may vary
slightly. Thus if you have 580K of free memory remaining
after loading DOS, the maximum file size which may


FileBrowser 1.20 Manual - Page 4







theoretically be loaded is 175K. I have never had a text
file that large, but have successfully used FileBrowser with
a 100K file (which takes a while to load!).

3. _T_e_c_h_n_i_c_a_l_ _S_p_e_c_i_f_i_c_a_t_i_o_n_s

FileBrowser consists of the following files:

FB.EXE : Main program executable file.
FBE.COM : Auxiliary program required to load an
external editor.
HELP.FB : FileBrowser On-Line Help file. (Warning:
do not edit this file - it is best to make
it read-only).
FB.MAN : Documentation (this file).
README.FB : Brief description of FileBrowser.

The source code for FB.EXE and FBE.COM is entirely written
in C. It was compiled with the Aztec C86 (tm) compiler,
version 3.4a, (using the 'large code, large memory' model in
the case of FB.EXE).

While the license for this software contains a legal
disclaimer of liability for damages, the author does not
believe that any portion of FileBrowser can lead to any
damage whatsoever to computer hardware or magnetic disk
media. In particular, all I/O is executed by C language
standard I/O functions which operate via DOS calls or BIOS
calls, or by standard Aztec C (tm) peeks and pokes to Video
RAM memory. This has a cost in speed, but ensures safety and
portability to the maximum number of systems.

CCC.. IInnssttaalllliinngg aanndd RRuunnnniinngg FFiilleeBBrroowwsseerr


1. _I_n_s_t_a_l_l_i_n_g_ _F_i_l_e_B_r_o_w_s_e_r_:

The first step in installing FileBrowser is to make a
working copy containing all the files, and put the original
disk away in a safe place!

If you are running FileBrowser on a two-floppy system,
simply copy the files FB.EXE, FBE.COM and HELP.FB to a disk
and use in the default drive.

For hard disk users, copy the files FB.EXE, FBE.COM and
HELP.FB to any suitable directory that lies on the DOS path.

a) _S_p_e_c_i_f_y_i_n_g_ _T_e_m_p_o_r_a_r_y_ _F_i_l_e_ _D_i_r_e_c_t_o_r_y

FileBrowser may write temporary disk files during
operation, e.g. when executing the PRINT command, (so
don't worry if you see the disk drive light come on).
These files will be erased after use; however, there must


FileBrowser 1.20 Manual - Page 5







be enough room on the disk for the temporary file.
Normally, such files are written to the current (default)
directory, however you may specify a drive and directory
for FileBrowser to use for its temporary files - e.g. if
you will be reading files from a floppy disk and want to
use your hard disk for temporary files. This is done using
a DOS Environment variable, 'FBT'. Suppose you wish to
use the directory "C:\TMP" as the temporary directory:
then, either at the DOS prompt or in your autoexec.bat
file, give the command:

set FBT=C:\TMP

(NOTE: If you wish to use the root directory of a drive
for temporary files, say drive A:, give the command:

set FBT=A:

NOT "set FTB=A:\").

b) _S_p_e_c_i_f_y_i_n_g_ _E_x_t_e_r_n_a_l_ _E_d_i_t_o_r

If you intend to use an external editor with
FileBrowser, it may be necessary to set a DOS Environment
variable 'EDITOR' using the command:

set EDITOR=

where is the calling name of a text editor
program.

As a default, FileBrowser attempts to use the 'VI' text
editor to edit files, but you may substitute another
editor as described above; alternately, you specify the
editor in the DOS command line when loading FileBrowser
(see below). Whatever editor you choose must be on your
DOS path, and must be capable of loading a file from the
DOS command line. You could even use the EDLIN editor
supplied with DOS! (The VI editor is not supplied with
this distribution).

2. _R_u_n_n_i_n_g_ _F_i_l_e_B_r_o_w_s_e_r

FileBrowser is started with the command line:

FB [-options] [speed] [editor] [d:][\path\]FILENAME.EXT

where FILENAME.EXT is the file to be loaded, with drive (d:)
and path specification if necessary. If a FILENAME is
omitted, a Title Screen appears, with copyright information
and brief Usage instructions.

The "options" currently available are 'q', 'c', 'm', 'w',


FileBrowser 1.20 Manual - Page 6







't', 's' and 'e' as follows. Options may be specified in any
order, either separately or as a group (see below).

q : (Quiet Load) - Omit display of title screen before
loading the file.

c : Use colour windows. Only one of 'c' or 'm' may be
specified. This option is obsolete because colour is now
the default option, but it has been retained to preserve
compatibility with Version 1.00

m : Use black-and-white windows instead of colour. (It is
not planned to support the "m" option after Version
1.20).

w : load a Wordstar (tm) document file: if omitted, the file
is assumed to be an ASCII file. (The extended ASCII
character set is supported).

t : Do not expand tabs. The 'Tab' character will appear as a
distinctive graphic (ASCII 09). If omitted, tabs are
expanded to spaces.

s : Specify CPU speed using the variable "speed".

e : Specify the External Editor using the variable "editor".

Variables : ("speed" and "editor") :

"speed" : An integer in the range 1 to 50 (inclusive)
specifying CPU speed. The default value is 5
(appropriate for a 5 mHz PC-XT). If running on a
10 mHz CPU, specify "10". This variable is used to
slow down the auto-scroll speed on fast machines.
To-gether with the internal speed control in
FileBrowser, this allows a 500-fold variation in
scrolling speed - enough for every possible
variation in eyesight!

"editor" : The calling name for the external editor that is
called from FileBrowser. The default calling name
is "vi".

The options may be given in one group preceded by a "-"
(minus sign), or separately, each preceded by a "-"; in the
latter case, options may be mixed with variables. Thus the
following are equivalent and correct:

fb -qse 10 myedit myfile.doc
fb -seq 10 myedit myfile.doc
fb -q -s 10 -e myedit myfile.doc
fb -e myedit -q -s 10 myfile.doc



FileBrowser 1.20 Manual - Page 7







all of these command lines load the ASCII file "myfile.doc"
with CPU speed specified as 10mHz, and the calling name of
the external editor specified as "myedit". But the following
is WRONG:

fb -qse myedit 10 myfile.doc

because when all the options are specified in a group,
FileBrowser expects the "speed" variable to be given BEFORE
the "editor" variable - you will get an error message.

Filebrowser has a maximum line length of 79 characters -
characters in excess of this limit are wrapped to the next
line. (Column 80 is reserved for special purposes in future
versions).


DDD.. FFiilleeBBrroowwsseerr CCoommmmaannddss

All FileBrowser commands may be executed by choosing from a
Menu (which is activated by pressing the "Ins" key after
starting FB.EXE). In addition, all commands may be executed
from BROWSE mode using a one-key command. When the Menu bar is
visible, a command may be selected by moving the reverse-video
cursor to the desired command and pressing "Return", or by just
typing the first letter of the command. When you are in "BROWSE"
mode, the same one-letter keystroke will select the command just
as if the Menu Bar were visible. When the Menu bar is visible,
on-line help on any command may be obtained by selecting the
command with the cursor keys, and pressing the 'F1' function
key. The Menu Bar contains the following commands:

HELP PRINT BROWSE SEARCH MARK DOS EDIT QUIT INFO

Each of these commands is described below.

1. _H_E_L_P

The HELP command gives a summary of the commands for
loading and running FileBrowser.

2. _P_R_I_N_T

When the PRINT command is selected, a pull-down menu
appears with two options:

a) _F_ _-_ _P_r_i_n_t_ _t_o_ _F_i_l_e

The "Print to File" command is used to copy part of
the current file to a new file. You will be prompted for
the new filename (which can include optional drive and
path, e.g. d:\path\file.ext). If the file specified
already exists, you have the option of overwriting it or


FileBrowser 1.20 Manual - Page 8







appending text to it. If you enter an illegal file name,
an error message will pop up. Press any key to remove the
error message.

After you have specified a file name, you will observe
that the top line of text in the main window is
highlighted in reverse video, and a blinking cursor
appears on the next line. You may move the cursor down to
subsequent lines - as this is done, the line above the
cursor is marked. When you have marked the desired number
of lines, press the "Esc" key, and the marked lines will
be copied to the designated file (in ASCII format).

The "Print to File" command may be given while in
'Browse' mode by simply pressing the "F" key;

b) _P_ _-_ _P_r_i_n_t_ _t_o_ _L_i_n_e_p_r_i_n_t_e_r

The "Print to Lineprinter" command is equivalent to the
FILE command except that the marked portion of the file is
copied to the lineprinter (device PRN), instead of to a
disk file. A temporary intermediate file is written to
the current (default) directory, and erased after the
PRINT command is complete. Note that the version of the
current file that is printed is the one in the FileBrowser
buffer - due to line truncation, tabs expansion, removal
of Wordstar (tm) characters, or MARKs, this may *not* be
identical to the file on your disk!

The "Print to Lineprinter" command may be given while
in 'Browse' mode by simply pressing the "P" key;

3. _B_R_O_W_S_E

The BROWSE command is used to view the current file - it
just causes FileBrowser to enter 'Browse' mode, (which is the
default mode). There are several options:

- To scroll through the file, use the Up and Down arrow
keys to move up or down a line; use the 'PgUp' and 'PgDn'
keys to move up or down by one page. The 'Home' and 'End'
keys move to the beginning or end of the file, respectively.

- To move forward or back by lines (where is an
integer):
first press the "+" key, then enter the value of
(you will get a prompt to do this on the bottom line of the
screen), then press the Down arrow, or Up arrow as desired.

- To automatically scroll forward or backward, press the
"*" key (asterisk), followed by the Down arrow or Up arrow
key. To select the speed, type an integer from 0 to 9. [9 =
fast, 0 = slow, 5 = medium]. Press any key to stop


FileBrowser 1.20 Manual - Page 9







scrolling.

- To move forward or backward to the next or preceding
MARKed lines (see below), use the Right or Left arrow keys,
respectively.

When entering a value from the keyboard, use the Escape
key to cancel input. If the screen gets mangled for any
reason, press Ctrl-L (^L) to redraw it.

4. _S_E_A_R_C_H

When the SEARCH command is selected, a pull-down menu
appears with two options:
S - Search Only
Ctrl-S - Search and Mark
These options are similar in that both are used to search for
a string of characters in the text. The difference is that
the "Search and Mark" Option permanently MARKs the string in
the text (see below).

FileBrowser incorporates a simple pattern matching
function, which may be used to locate a string of text in a
file. A "pattern" can contain "words", (a "word" is defined
as a string of alphanumeric characters), and the wildcard
symbol "*".

It should be carefully noted that a "word" in a search
pattern is just a literal string of characters - NOT an
English word. Thus the pattern "mat" will match all of the
English words containing the letters 'm', 'a, and 't' in
sequence, e .g "match", "doormat", "matter". Words in a
pattern cannot contain embedded punctuation characters.

The symbol "*" matches any number of words, (including no
words!). Thus, the pattern "the * fox" will match all of the
strings: "the fox", "the brown fox", "the quick brown fox".
The symbol "*" is only legal inside a pattern, not as a
prefix or suffix.

When "Search Only" or "Search and Mark" is invoked, you
will be prompted to input a pattern. FileBrowser will
automatically process your input into a legal pattern (you
will have a chance to correct errors). The search then
proceeds forward from the Top Line displayed in the main
window, and is on a line-by-line basis (patterns extending
over two lines are not found). At each successful 'hit',
the line which matches the pattern will be highlighted, and
you will be asked if you wish to continue. Press 'y' to
continue, 'n' (or just hit the 'Return' key) to terminate the
search. (In "Search and Mark" mode, you have the option of
marking all instances of the pattern without waiting for
confirmation after each 'hit').


FileBrowser 1.20 Manual - Page 10







Note: The "SEARCH" command may also be given in BROWSE mode
by simply pressing the "S" key for "Search Only", or the
"Ctrl-S" (^S) keychord for "Search and Mark".

a) _H_i_n_t_s_ _o_n_ _u_s_i_n_g_ _S_E_A_R_C_H

- When searching for a given string of text in a file,
it is sometimes better to use a word stem rather than a
word: for example, the pattern 'enzyme' will match the
words "enzyme" and "enzymes", but the pattern 'enzym' will
also match "enzymology". For the maximum number of hits,
the second pattern may be preferred.

- If you are searching for a string consisting of two
English words in sequence, it is a good idea to place a
'*' in the pattern, in case the two words in the file are
separated by more than one whitespace character.

- FileBrowser does not like to scroll past the last
line of a file, which ends up at the bottom of the screen.
You may sometimes wish to "scroll up" the last lines of
a file: to do so, use the SEARCH command to 'search' for
a pattern which occurs only in the last line. The SEARCH
operation will move the last line to the top of the
screen, and you can then scroll the desired number of
lines back onto the screen using the Up arrow key.

5. _M_A_R_K

There are two commands possible in this mode: MARK and
UNMARK. The MARK command allows you to put a permanent 'mark'
on a line, and highlight any portion of it. The UNMARK
command is used to clear all 'marks' from the text in the
buffer.

A MARKed string of text will appear on a colour monitor as
amber text on a black background (in black-and-white mode, as
reverse video), contrasting visibly with the default text
colours. In FileBrowser's internal buffer, each MARKed
character is preceded by an Underline, "_", and a backspace
character, "^H" ("Ctrl-H", ASCII character 08). These
characters remain in the text when it is printed to a file or
the lineprinter - most printers will underline the marked
text. You may also place marks in a text file by editing it
with an appropriate editor, such as the "VI" editor -
FileBrowser uses the "_^H" sequence as a control sequence to
mark the next character.

When the MARK command is given, a cursor appears in the
upper left-hand corner of the main window; use the arrow
keys to move the cursor to the start of the text you wish to
highlight (you can only move to text which is visible -


FileBrowser 1.20 Manual - Page 11







scrolling is disabled), and press the "Return" key. Then
use the Right arrow key to add letters to the highlighted
area (the Left arrow key may be used to back up) and press
"Return" when you are finished. If a line is already marked,
you can unmark it by placing the cursor at the beginning of
the line and pressing "Return" or "Esc". At any time in the
MARK operation you may abort and return to BROWSE mode by
pressing the "Esc" key.

The SEARCH and MARK mode allows you to automatically mark
all instances of a SEARCH pattern within a file. It is
entered from the SEARCH menu.

The MARK and UNMARK commands may be given in BROWSE mode
by pressing the M and U keys, respectively; SEARCH AND MARK
command is given by pressing the "Ctrl-S" (^S) keychord.

6. _D_O_S

The "DOS" command suspends FileBrowser and returns to the
DOS operating system. To alert you that you have loaded
another shell, the cursor will change to a small flashing box
instead of the normal flashing underscore.

You may now carry out disk maintenance operations, run
another program, etc. The FileBrowser environment remains
resident in memory; to return to FileBrowser, type the
command 'EXIT' at the DOS prompt.

7. _E_D_I_T

The "EDIT" command allows you to edit the current file
using the text editor of your choice. You may specify the
editor by setting the DOS environment variable "EDITOR", or
by using the "-e" option in the command line (see section C).

If the environment variable "EDITOR" is not set, or the "-
e" option is not specified in the command line, FileBrowser
will attempt to load the "vi" text editor. Whatever text
editor you choose, it must be one that can accept the file
name in the command line, e.g. "vi myfile.doc".

When the "EDIT" command is given, FileBrowser writes a
short Batch file in the same directory as the file being
browsed, loads the batch file and exits; the batch file then
loads the editor, and after exiting from the editor, re-loads
FileBrowser with the edited version of the file. The
auxiliary program FBE.COM is required in order to execute the
EDIT command.

The "EDIT" command may be given while in 'Browse' mode by
simply pressing the 'E' key.



FileBrowser 1.20 Manual - Page 12







8. _Q_U_I_T

This command is used to exit permanently from FileBrowser.
To exit temporarily, use the 'DOS' command. You may also exit
from FileBrowser when in 'Browse' mode by pressing the "Esc"
key.

When the QUIT command is given by either method, you will
get a new menu with three options: "Q - Quit without Saving",
"S - Save Buffer and Quit", and "Esc - Return to
FileBrowser".

If the "S" option is selected, the entire text buffer is
printed out to a file named "fb.out" in the current (default)
directory. This option is useful if you have added highlights
to the text -these will be preserved in the saved file.

An alternative method for quitting FileBrowser is to use a
'Ctrl-Break' interrupt. This causes an immediate exit to DOS.
This method can also be used whenever FileBrowser is
expecting keyboard input, e.g. when entering a file name in
'File' mode, or entering a pattern in 'Search' mode.

9. _I_N_F_O

This will display additional information about your
FileBrowser license.

10. _O_n_e_-_K_e_y_ _F_i_l_e_B_r_o_w_s_e_r_ _C_o_m_m_a_n_d_s

The following is a summary of the one-key commands that
may be given in BROWSE mode. This summary can be viewed at
any time by pressing the "F1" function key while in Browse
mode.

"Down" Arrow - Scroll Ahead One Line Esc - Quit Menu
"Up" Arrow - Scroll Back One Line Ins - Main Menu
Right" Arrow - Scroll Ahead to Next Mark F - Print Block to File
"Left" Arrow - Scroll Back to Last Mark P - Print Block to LPT1:
PgDn - Scroll Ahead One Page S - Search for a String
PgUp - Scroll Back One Page Ctrl-S - Search and Mark
Home - Jump to Top of Buffer M - Mark a Line of Text
End - Jump to End of Buffer U - Unmark All Lines
Ctrl-L - Redraw Screen D - DOS Shell
* - Scroll Continuously at Variable Speed E - External Editor
+ - Scroll Ahead or Back by Lines
F3 - Toggle Text Background F4 - Toggle Text Foreground

All of these commands have been discussed in preceding
sections except "F3" and "F4". If you have a colour monitor,
you may use these function keys to choose your own colour
scheme.



FileBrowser 1.20 Manual - Page 13







EEE.. LLiicceennssee aanndd WWaarrrraannttyy DDiissccllaaiimmeerr

The FileBrowser software package, Version 1.20, including the
files FB.EXE, FBE.COM, HELP.FB, FB.MAN and README.FB, is
Copyright (c) 1988, 1989 by David O. Tinker, (All Rights
Reserved). This software is hereby licensed for use and
distribution subject to the following terms:

1. All the files FB.EXE, FBE.COM, HELP.FB, FB.MAN and README.FB
must be distributed to-gether.

2. No alteration of any portion of this software may be made,
and specifically, the Copyright notice must remain intact.

3. No charge may be made for any copy of FileBrowser, Version
1.20, save only that distributors of Public Domain and Shareware
software libraries, whether in the form of magnetic media or in
electronic form by remote access, are permitted to charge their
normal disk fee, access fee or membership fee for distribution
of software collections incorporating FileBrowser, Version 1.20.

4. FileBrowser, Version 1.20 may not be included in any
commercial software distribution other than libraries of Public
Domain and Shareware software as described in item 3, above,
without the express written permission of the author.

5. Use of this software is entirely at the risk of the user;
users of this software agree to absolve and hold harmless the
author, David O. Tinker, from all claims of liability for
damages arising from use of this software, including but not
limited to, special, incidental, consequential or other damages,
loss of profit or any other commercial damage.

6. The author reserves the right to alter the terms of this
license without notice, save that users licensed prior to such
alteration will not be charged any fee for this license.

7. Use of this software specifically implies assent to the terms
of this licence.

The intent of this license is that this software be used and
enjoyed without undue restriction, and that it not be sold for
profit, but that the sole rights of the author to maintain and
make any and all improvements or alterations to this product be
preserved.

THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR
PURPOSE.




FileBrowser 1.20 Manual - Page 14







FFF.. AAcckknnoowwlleeddggeemmeennttss

The term "DOS" refers to the products Microsoft MS-DOS (tm) or
IBM PC-DOS (tm). MS-DOS (tm) and Microsoft Windows (tm) are
trademarks of Microsoft Corporation. PC-DOS (tm) and IBM-PC
(tm) are trademarks of the IBM Corporation. Wordstar (tm) is a
trademark of MicroPro International Corporation. Sidekick (tm)
is a trademark of Borland International Inc. BIX (tm) (BYTE
Information Exchange) is a trademark of McGraw Hill, Inc.

A small portion of the source code for FB.EXE, specifically
related to the Search algorithm, was adapted from the Public
Domain 'Strings' library written by Richard A. O'Keefe (1984).










































FileBrowser 1.20 Manual - Page 15





Page 16


GGG.. FileBrowser - Version 1.20
License Registration Form.

Completion of this form will be of assistance to the author, and
ensure that you will be advised of the availability of new
versions of FileBrowser and future software products.

Information contained in this form will be strictly
confidential, and will not be distributed by the author to any
other party.


Name:___________________________________________________________

Title:__________________________________________________________

Company:________________________________________________________

Mailing Address:________________________________________________

________________________________________________

(Country):_________________ (Postal or ZIP Code):____________

E-Mail Address:_________________________________________________

Nature of Business:_____________________________________________

I will use FileBrowser: At Home:__________ At Work:_________

On how many computers belonging to you
or your company will FileBrowser be used? ____________

Specify Type of Computer (Make, Model) and Video Display (e.g.
CGA, EGA, Hercules, Color, Monochrome):

________________________________________________________________

How did you obtain FileBrowser? (Check appropriate category).

Downloaded from a BBS:________ From a Usenet Posting:__________

From a Software Distributor:_______ (Specify):______________________

From another user:________ Other (Specify):________________________


I hereby assent to the terms of the license for use of
FileBrowser Version 1.20

Signature:____________________________ Date:___________________







Page 17








Please use the reverse of the registration form to make any
comments or suggestions, report bugs, etc.



After completion of the form, please mail to:

David O. Tinker,
RR 2, Group Box 50,
GORMLEY, Ontario,
Canada.
L0H 1G0





































FileBrowser 1.20 Manual - End



  3 Responses to “Category : Utilities for DOS and Windows Machines
Archive   : FB120.ZIP
Filename : FB.MAN

  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: http://www.os2museum.com/wp/mtswslnk/