Doc VB (DOCVB.EXE) - Copyright (c) 1994 G.E.McPhail
			  All Rights Reserved 
 

Introduction
------------
Doc VB (Document Visual Basic) is a Visual Basic source code printing
utility in toolbar form. Doc VB will allow you to :

    ---Select any combination of projects, modules, or procedures to print
    ---Select the margins and fonts to be used in the listing
    ---Print an optional cover/title page for a project listing
    ---Print a table of contents of the procedures in a project
    ---Orient Doc VB as a horizontal or vertical toolbar
    ---Set the Doc VB toolbar to always remain on top



Installation
------------
You MUST have a copy of VBRUN300.DLL installed in your \WINDOWS\SYSTEM
directory. If you do not have a copy, most bulletion board systems have
a copy available for downloading. Additionally, you must be using
Microsoft Windows Version 3.1.

Unzip the distribution archive into a subdirectory of your choice and
copy or move the individual files as follows :

		File			Destination

	      DOCVB.EXE		    A directory of your choice
	      MIN.VBX               \WINDOWS\SYSTEM
	      CTRLBOX.VBX	    \WINDOWS\SYSTEM
	     *THREED.VBX	    \WINDOWS\SYSTEM
	     *SPIN.VBX		    \WINDOWS\SYSTEM
	     *PICCLIP.VBX	    \WINDOWS\SYSTEM
	     *CMDIALOG.VBX	    \WINDOWS\SYSTEM

    *NOTE : As a Visual Basic programmer yourself, the files marked
	    with an asterisk should already be installed in your
	    \WINDOWS\SYSTEM directory. If so, you need not copy/move
	    the ones included in the archive!

Additionally, the first time that you run Doc VB, an initialization file
(DOCVB.INI) will be created in the same directory containing DOCVB.EXE.
DOCVB.INI contains information regarding your choice of fonts, margins,
toolbar orientation, etc.

Add Doc VB to a program group of your choice just as you would any other
MS Windows program. If you want Doc VB to execute another program
(VB.EXE is an obvious choice), add the appropriate command line.
My command line looks like this :

		F:\VB\DOCVB\DOCVB.EXE F:\VB\VB.EXE

Thus, Doc VB is always available when I am in the Visual Basic development
environment.

	

Operation
---------

The first time that you run Doc VB it will be iconized (The unregistered
version of Doc VB delays and displays its About box prior to displaying
its icon or toolbar. The delay goes away with registration!). It is from
the system menu (accessed by a single click to the icon) that you make
the choice of a vertical or horizontal toolbar and whether Doc VB should
remain on top. Make your choices (you can change your mind later), then
double-click the icon and the toolbar will appear. To re-iconize the 
toolbar, double-click the toolbar Move half-button (the small button on
the left of a horizontal toolbar or on the top of a vertical toolbar).

The Doc VB toolbar is composed of one half-button and four reqular buttons.
These are (from left to right or top to bottom) :

	---Move/Iconize (the half-button)
	---Open a .MAK file
	---Print (Cancel Print during printing)
	---Configure (fonts and font properties)
	---Exit

**NOTE: An explanation of all buttons and most controls within Doc VB may
        be obtained by pressing and holding the RIGHT mouse button on the
        button or control in question!

Press and hold the LEFT mouse button on the Doc VB Move half-button,
then drag the toolbar to a screen position of your choice. On subsequent
executions, the toolbar will appear in the same location. 

To open a .MAK file, single-click the Doc VB Open button. A common dialog
box will appear allowing you to open a VB project file.

To print, single-click the Doc VB Print button. A dialog box will appear
from which you can choose to print:
	---Modules
	---Procedures
	---Optional header (in addition to the automatically printed header)
	---Cover page
	---Table of contents
	---A single procedure per page
	---Form and control declarations
During printing, this button changes to a cancel print button.
**NOTE: In order to successfully print, the module MUST have been saved
	in TEXT format. Attempts to print modules save in binary format
	will fail!

To select fonts and font properties, single-click the Doc VB configure
button. A dialog box will appear allowing you to select fonts and properties
for:
	---Code lines
	---Comments lines
	---Header(s)
	---Index/Table of Contents
	---Procedure lines
On the first execution of Doc VB, you will automatically be taken to this
dialog box immediately after you open the first .MAK file. This information
is saved for use during subsequent executions.

To exit Doc VB, press the Exit button or choose close from the system menu
of the iconized Doc VB.



License Agreement 
-----------------
Doc VB (hereafter referred to as "the software") is owned by G. E. McPhail
(hereafter referred to as "the author") and is protected by United States
copyright laws and international treaty provisions.  You may not modify,
reverse engineer, decompile, or disassemble the software.

You may freely use and distribute this version of the software, with
the following restrictions: 
	(a) It may not be included in a software or hardware package
	    marketed for resale without the express written consent of
	    the author;
	(b) The computer archive file, diskette, or other media that
	    contains the software must contain this document and all
	    other files originally distributed with the software in
	    unaltered form.

In no event shall the author be liable for any damages whatsoever
(including, without limitation, damages for loss of business profits,
business interruption, loss of business information, or other pecuniary
loss) arising out of the use or inability to use this product, even if
the author has been advised of the possibility of such damages.

If you do not agree to the terms of this agreement, destroy all of your
copies of the software.  This is your sole remedy.



Registration
------------
Doc VB is NOT, and never has been, public domain or free software.
Doc VB is SHAREWARE! You may freely use Doc VB for an evaluation period
of not more than 21 days. Usage beyond this evaluation period requires
reqistration and payment of a licensing fee ($10 US).

To register Doc VB:

	---Via CompuServe's Shareware Registration forum (GO SWREG).

	 	Doc VB's registration ID is 2049.

	   This is the fastest method. You will receive your registration
	   number via E-Mail (normally within 2-3 days).

				--Or--

	---Send your name, address and $10 (check or money order) to:
		
		G. E. McPhail
		Geodan Trading Company
		6942 FM 1960 E-168
		Humble, TX 77346

	   This will obviously take longer, however, if you include
	   either your CompuServe User ID or your America On-Line
	   Screen Name, you will receive your registration number
	   via E-Mail on the applicable service.

Once you have received your registration number, use Doc VB's Register
button from the About box to complete the registration process.
This will eliminate the startup delay and the "Unregistered" notice
printed on the source code listing. This number will work with all
future minor (the numbers after the decimal point) versions for Doc VB.




Support, Questions, Comments
----------------------------

The author may be contacted :
 
	    Compuserve : UserId 72610,10
	America Online : Screen name "Gemc"

or at the mailing address above.
