===============================
Unregistered User Documentation
DocuView ver 2.3
===============================

Dialog Software (TM)
Box 9567
4005 Wisconsin Avenue NW
Washington, DC 20016-9567
USA

(703) 528-1505 (Voice)


===========
Quick Start
===========

DocuView documentation may be read by simply entering DOCUVIEW at
the DOS prompt. Once in DocuView, the instructions will be
displayed automatically.

If you wish to view a specific text file, you may use the following
syntax at the DOS command line:

C:\DOCUVIEW]DOCUVIEW drive\path\filename.ext
-------- -----------------------

(User input is underlined above.)

This syntax reads the file specified by the path and filename.ext
which appears on the command line. Note that you must use a
filename extension. The path, however, is optional. Here are some
examples:


DOCUVIEW Displays DocuView's DOCUVIEW.DOC
file.

DOCUVIEW README.TXT Displays the file README.TXT on
the current directory.

DOCUVIEW E:\TEXT\README.TXT Displays the file README.TXT on
the E:\TEXT subdirectory.

In order for DOS to find DOCUVIEW you should specify the DOCUVIEW
directory in the DOS PATH statement. An example is as follows:

PATH = C:\DOCUVIEW;C:\DOS;C:\UTIL

This PATH statement will search the DOCUVIEW, DOS, and UTIL
sudirectories when attempting to locate an executable file, such
as DOCUVIEW.EXE.

For further installation notes, please see comments under Setup.


============
Introduction
============

Dialog Software is releasing a full version of DocuView to the
Shareware market. DocuView reflects many months of effort. Since
it is a Shareware product you are granted a 30-day trial period,
after which, if you continue to use DocuView, you should register
by sending $20.00 to Dialog Software. In return for your honesty
and reimbursement you will receive a printed and expanded user's
manual, update notices, news about our products and special
services, and technical support.

================
Product Overview
================

DocuView is a comprehensive file-browsing program which allows you
to peruse text files stored on disk. Most text files must be
smaller than 30 kilobytes in order to be read by DocuView (please
see note below) however larger files may be broken down into
smaller files using a text editor.

----------------------------------------------------------------
NOTE:

Users interested in supporting files beyond 30K should register
for DocuView II, which supports files of any size. DocuView II is
$30.00 and may be ordered from Dialog Software as well. DocuView
II contains a case-sensitive search system, a utility for easily
adding or deleting files in DOCUVIEW.SEL, better filename support,
and FULL color-configuration ability. Also, as with all of our
Shareware products, any references to "Unregistered Version" or
"Shareware Version" will be replaced by a serial number which will
be registered to the owner. DocuView II otherwise includes all
features of the Shareware version.
----------------------------------------------------------------

DocuView is dialog-box driven and therefore represents the same
intuitive interface present in Microsoft Windows(TM),
QuickBASIC(TM), QuickC(TM), and other MacIntosh(TM)-related
interfaces. You may use a mouse or keyboard for all features.
DocuView was written using a combination of assembly language and
QuickBASIC 4.5. All dialog boxes were generated using DiaLogic,
a QuickBASIC/assembler module jointly owned by Dialog Software and
Crescent Software, but being marketed by the latter. DiaLogic may
be ordered from Crescent Software at (203) 846-2500. DiaLogic is
available for QuickBASIC ver 4.x only, and includes a 100+ page
manual, source code, and example programs. Its price is $79.95.

============
Installation
============

DocuView is easy to install. All files must be placed on the same
directory. For example, you may place all DocuView files on a
directory call DOCUVIEW; this will be the "home" directory:

C:\DOCUVIEW

You may use the DOS MKDIR command in order to create this
subdirectory as follows:

MKDIR C:\DOCUVIEW

In order to appreciate the installation requirements, you should
know a little bit about each file which should accompany DocuView
on its home directory.

File Name Purpose

DOCUVIEW.EXE The DocuView program.
* DOCUVIEW.001 The DocuView graphic logo.
* DOCUVIEW.SC1 Sign-on screen #1.
* DOCUVIEW.SC2 Sign-on screen #2.
DOCUVIEW.DOC This document: provides general
instructions for using DocuView.
DOCUVIEW.SEL The list of files and descriptions to be
used by DocuView.
DOCUVIEW.INI The customizable DocuView settings. This
file contains information such as the
default colors, disk drive/path, error
chime, etc.

* Note: DocuView will not run if any of the files designated
with an asterisk are missing from the DocuView home
directory.

All files listed above must be in the same directory, but you may
execute DocuView from another directory. More will be said about
this under the Setup section.

=================
Starting DocuView
=================

After you have copied all files onto a selected directory you will
then be able to type DOCUVIEW at the DOS prompt in order to begin:

CD C:\DOCUVIEW

Once DocuView starts you will be presented with the DocuView logo
(if you are using a EGA-compatible display), followed by two text
screens. You may suppress all these screens selecting the setup
option called Fast Logon.

After the initial screens you should see a message "Auto Start in
progress". What is happening is that the file DOCUVIEW.DOC is
being loaded automatically. This Auto Start function is available
from the Setup dialog box, and we have enabled it by default so
that you may see these instructions when you first run DocuView.

Once the program has started you may press to see DocuView's
main menu. This menu lists four choices, which are discussed
below:

(1) DocuView File List
This option presents a new dialog box which
shows all the text files which are available.
Available text files are specified in
DOCUVIEW.SEL.

(2) Setup
This option presents the Setup dialog box.
This feature allows you to customize DocuView
so it works best for you.

(3) Help Topics
This option presents the Help Topics dialog
box. This option allows you to gain on-line
help for many of DocuView's features.

(4) Quit
Allows you to exit DocuView.


===================
Reading a text file
===================

In order to read a text file from the main menu you must select
"DocuView Files". This selection produces a list of all text files
available. Simply select a file by highlighting it, then press
or click on using the mouse.

When you first install DocuView only two files should be available:
the first will be DOCUVIEW.DOC, and the second will be LICENSE.DOC.
These files are specified in the configuration file called
DOCUVIEW.SEL, which holds all file selections. Please see the
section below called "Adding DocuView Files" in order to change or
expand the files available in DocuView.


===============
The View Window
===============

The View Window is the DocuView screen which presents the text file
you have selected. The View Window has much flexibility built into
it. Here is a brief summary:

The Menu Bar

On the bottom of the screen you will see a menu bar.
This bar may be used with the designated function
key or by clicking over a particular option with the
mouse. For example, to get help you may press
or you may hold the mouse cursor over the words
"" and press a mouse button. Both actions
will cause a help screen to be generated.

The Menu Bar Choices

The menu bar presents function key operations. Keys
through are available, and some keys work
slightly differently when the key is also
pressed:

or

Gives the View Window Help dialog
box.



Changes the foreground color (the
color of the letters)



Changes the background color.



Allows you to enter a search string
which should be found in the current
document. Searches are not case-
sensitive. Once a match is found,
pressing will repeat the search
until the entire file has been
searched. You may specify whether
searches are to be forward (from the
cursor toward the end of the file)
or backward (from the cursor toward
the beginning of the file).



Allows a new search string to be set.


or

Allows either the currently-visible
portion of or the entire document
currently being viewed to be printed
to the printer. In either case, the
printer output will contain a
heading containing the name of the
file from which the text was taken,
and the date and time.

Please note that the printer will
undergo a printer-ready test before
output is attempted by DocuView. If
this feature does not work correctly
with your system you may turn it off
by selecting the Network Present
option on the Setup dialog box.

When colors are adjusted in the view window their settings are
saved for your next session with DocuView.

========================
Adding Files to DocuView
========================

Files which appear as available within DocuView are stored in a
file called DOCUVIEW.SEL. This file is very easy to customize.
Simply follow these steps:

(1) Load DOCUVIEW.SEL into a text editor or use the
DOS EDLIN editor.

(2) Determine the number of files you wish to make
available. This number will be the very first
line in the file. For example, if you have
five text files in your list then the number
5 will appear in the first line of
DOCUVIEW.SEL.

(3) The remaining portion of the file will be
comprised of file name/description pairs. For
example, consider the following list of 3
files:

DOCUVIEW.DOC
The DocuView documentation.
LICENSE.DOC
DocuView's licensing agreement.
README.TXT
A general-purpose documentation file.

File names occupy one line and the file name
description occupies the next immediate line
in the file. Notice that each file name is
specified exactly. You may not specify a path
name since all files are expected to be in the
current directory (DocuView II offers more
flexibility here). The file names may have
any name you wish, but you must specify the
file name and its extension since no default
extension is assumed. Further, you must ensure
that the files are ASCII files or they will not
be displayed correctly by DocuView and may
cause unpredictable results.

The length of the description should not
exceed 45 characters or its information may be
truncated when displayed.

(4) After all file name/file name descriptions have
been entered you may use the remainder of the
DOCUVIEW.SEL file for comment lines, although
you must be sure that these lines occur after
all file names. DocuView uses the first line
in the DOCUVIEW.SEL file to determine how many
lines of the file it should read. In our
example of using 5 as the first line, DocuView
would read 10 subsequent lines in the
DOCUVIEW.SEL file, since each file is
associated with two physical lines of
information.

(5) Here's an example:

3
DOCUVIEW.DOC
The DocuView documentation.
LICENSE.DOC
DocuView's licensing agreement.
README.TXT
>A general-purpose documentation file.
>These lines are comment lines which
>are inserted beyond the file names
>and accompanying descriptions.


=====
Setup
=====

Although the Setup screen is self-explanatory (with its on-line
help) there is an important installation requirement about which
you should be aware. You should specify under Drive/Path the drive
and path name under which all DOCUVIEW files are stored. This,
coupled with correct use of the PATH statement (see Quick Start
section above) will allow DocuView to be run from any drive or
directory.

For example, suppose DocuView is installed on C:\DOCUVIEW. You may
wish to log to the D: drive and read a text file called NOTES.TXT,
which is stored in D:\TUTOR. In order to do this you should use
the following syntax once you have logged on to the D:\TUTOR
subdirectory:

DOCUVIEW NOTES.TXT

If the PATH statement is correct then DOS should find DOCUVIEW.EXE
on the C:\DOCUVIEW subdirectory. Then, DocuView's internal
Drive/Path setting will allow DocuView to find its own support
files. Then, the file on the current directory called NOTES.TXT
will be loaded.

==========
Conclusion
==========

DocuView contains much on-line help, and should you encounter
difficulty you may call or write to Dialog Software. Remember:
registered users will receive a full printed manual and diskette
with the latest version.

Thank you for using DocuView! We sincerely hope that you enjoy it.