home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / VISUAL_B / FERRAMEN / DOCS_VB / README.TXT < prev    next >
Encoding:
Text File  |  1994-02-09  |  7.4 KB  |  201 lines
  1. Doc VB (DOCVB.EXE) - Copyright (c) 1994 G.E.McPhail
  2.               All Rights Reserved 
  3.  
  4.  
  5. Introduction
  6. ------------
  7. Doc VB (Document Visual Basic) is a Visual Basic source code printing
  8. utility in toolbar form. Doc VB will allow you to :
  9.  
  10.     ---Select any combination of projects, modules, or procedures to print
  11.     ---Select the margins and fonts to be used in the listing
  12.     ---Print an optional cover/title page for a project listing
  13.     ---Print a table of contents of the procedures in a project
  14.     ---Orient Doc VB as a horizontal or vertical toolbar
  15.     ---Set the Doc VB toolbar to always remain on top
  16.  
  17.  
  18.  
  19. Installation
  20. ------------
  21. You MUST have a copy of VBRUN300.DLL installed in your \WINDOWS\SYSTEM
  22. directory. If you do not have a copy, most bulletion board systems have
  23. a copy available for downloading. Additionally, you must be using
  24. Microsoft Windows Version 3.1.
  25.  
  26. Unzip the distribution archive into a subdirectory of your choice and
  27. copy or move the individual files as follows :
  28.  
  29.         File            Destination
  30.  
  31.           DOCVB.EXE            A directory of your choice
  32.           MIN.VBX               \WINDOWS\SYSTEM
  33.           CTRLBOX.VBX        \WINDOWS\SYSTEM
  34.          *THREED.VBX        \WINDOWS\SYSTEM
  35.          *SPIN.VBX            \WINDOWS\SYSTEM
  36.          *PICCLIP.VBX        \WINDOWS\SYSTEM
  37.          *CMDIALOG.VBX        \WINDOWS\SYSTEM
  38.  
  39.     *NOTE : As a Visual Basic programmer yourself, the files marked
  40.         with an asterisk should already be installed in your
  41.         \WINDOWS\SYSTEM directory. If so, you need not copy/move
  42.         the ones included in the archive!
  43.  
  44. Additionally, the first time that you run Doc VB, an initialization file
  45. (DOCVB.INI) will be created in the same directory containing DOCVB.EXE.
  46. DOCVB.INI contains information regarding your choice of fonts, margins,
  47. toolbar orientation, etc.
  48.  
  49. Add Doc VB to a program group of your choice just as you would any other
  50. MS Windows program. If you want Doc VB to execute another program
  51. (VB.EXE is an obvious choice), add the appropriate command line.
  52. My command line looks like this :
  53.  
  54.         F:\VB\DOCVB\DOCVB.EXE F:\VB\VB.EXE
  55.  
  56. Thus, Doc VB is always available when I am in the Visual Basic development
  57. environment.
  58.  
  59.     
  60.  
  61. Operation
  62. ---------
  63.  
  64. The first time that you run Doc VB it will be iconized (The unregistered
  65. version of Doc VB delays and displays its About box prior to displaying
  66. its icon or toolbar. The delay goes away with registration!). It is from
  67. the system menu (accessed by a single click to the icon) that you make
  68. the choice of a vertical or horizontal toolbar and whether Doc VB should
  69. remain on top. Make your choices (you can change your mind later), then
  70. double-click the icon and the toolbar will appear. To re-iconize the 
  71. toolbar, double-click the toolbar Move half-button (the small button on
  72. the left of a horizontal toolbar or on the top of a vertical toolbar).
  73.  
  74. The Doc VB toolbar is composed of one half-button and four reqular buttons.
  75. These are (from left to right or top to bottom) :
  76.  
  77.     ---Move/Iconize (the half-button)
  78.     ---Open a .MAK file
  79.     ---Print (Cancel Print during printing)
  80.     ---Configure (fonts and font properties)
  81.     ---Exit
  82.  
  83. **NOTE: An explanation of all buttons and most controls within Doc VB may
  84.         be obtained by pressing and holding the RIGHT mouse button on the
  85.         button or control in question!
  86.  
  87. Press and hold the LEFT mouse button on the Doc VB Move half-button,
  88. then drag the toolbar to a screen position of your choice. On subsequent
  89. executions, the toolbar will appear in the same location. 
  90.  
  91. To open a .MAK file, single-click the Doc VB Open button. A common dialog
  92. box will appear allowing you to open a VB project file.
  93.  
  94. To print, single-click the Doc VB Print button. A dialog box will appear
  95. from which you can choose to print:
  96.     ---Modules
  97.     ---Procedures
  98.     ---Optional header (in addition to the automatically printed header)
  99.     ---Cover page
  100.     ---Table of contents
  101.     ---A single procedure per page
  102.     ---Form and control declarations
  103. During printing, this button changes to a cancel print button.
  104. **NOTE: In order to successfully print, the module MUST have been saved
  105.     in TEXT format. Attempts to print modules save in binary format
  106.     will fail!
  107.  
  108. To select fonts and font properties, single-click the Doc VB configure
  109. button. A dialog box will appear allowing you to select fonts and properties
  110. for:
  111.     ---Code lines
  112.     ---Comments lines
  113.     ---Header(s)
  114.     ---Index/Table of Contents
  115.     ---Procedure lines
  116. On the first execution of Doc VB, you will automatically be taken to this
  117. dialog box immediately after you open the first .MAK file. This information
  118. is saved for use during subsequent executions.
  119.  
  120. To exit Doc VB, press the Exit button or choose close from the system menu
  121. of the iconized Doc VB.
  122.  
  123.  
  124.  
  125. License Agreement 
  126. -----------------
  127. Doc VB (hereafter referred to as "the software") is owned by G. E. McPhail
  128. (hereafter referred to as "the author") and is protected by United States
  129. copyright laws and international treaty provisions.  You may not modify,
  130. reverse engineer, decompile, or disassemble the software.
  131.  
  132. You may freely use and distribute this version of the software, with
  133. the following restrictions: 
  134.     (a) It may not be included in a software or hardware package
  135.         marketed for resale without the express written consent of
  136.         the author;
  137.     (b) The computer archive file, diskette, or other media that
  138.         contains the software must contain this document and all
  139.         other files originally distributed with the software in
  140.         unaltered form.
  141.  
  142. In no event shall the author be liable for any damages whatsoever
  143. (including, without limitation, damages for loss of business profits,
  144. business interruption, loss of business information, or other pecuniary
  145. loss) arising out of the use or inability to use this product, even if
  146. the author has been advised of the possibility of such damages.
  147.  
  148. If you do not agree to the terms of this agreement, destroy all of your
  149. copies of the software.  This is your sole remedy.
  150.  
  151.  
  152.  
  153. Registration
  154. ------------
  155. Doc VB is NOT, and never has been, public domain or free software.
  156. Doc VB is SHAREWARE! You may freely use Doc VB for an evaluation period
  157. of not more than 21 days. Usage beyond this evaluation period requires
  158. reqistration and payment of a licensing fee ($10 US).
  159.  
  160. To register Doc VB:
  161.  
  162.     ---Via CompuServe's Shareware Registration forum (GO SWREG).
  163.  
  164.          Doc VB's registration ID is 2049.
  165.  
  166.        This is the fastest method. You will receive your registration
  167.        number via E-Mail (normally within 2-3 days).
  168.  
  169.                 --Or--
  170.  
  171.     ---Send your name, address and $10 (check or money order) to:
  172.         
  173.         G. E. McPhail
  174.         Geodan Trading Company
  175.         6942 FM 1960 E-168
  176.         Humble, TX 77346
  177.  
  178.        This will obviously take longer, however, if you include
  179.        either your CompuServe User ID or your America On-Line
  180.        Screen Name, you will receive your registration number
  181.        via E-Mail on the applicable service.
  182.  
  183. Once you have received your registration number, use Doc VB's Register
  184. button from the About box to complete the registration process.
  185. This will eliminate the startup delay and the "Unregistered" notice
  186. printed on the source code listing. This number will work with all
  187. future minor (the numbers after the decimal point) versions for Doc VB.
  188.  
  189.  
  190.  
  191.  
  192. Support, Questions, Comments
  193. ----------------------------
  194.  
  195. The author may be contacted :
  196.  
  197.         Compuserve : UserId 72610,10
  198.     America Online : Screen name "Gemc"
  199.  
  200. or at the mailing address above.
  201.