                           Welcome to
                      ProtoView's ProtoGen
                Pascal Application Code Generator
                ---------------------------------

Read this README file for the latest important information about
the ProtoGen software.


TABLE OF CONTENTS
-----------------
1.  How To Get Help
2.  Transfer Buffers And Multi-Selection Listboxes
3.  Using Resource Workshop And ProtoGen
4.  Custom Controls & ProtoGen
5.  Using ProtoGen Pascal With Turbo Pascal 1.5
6.  Running ProtoGen in Windows 3.0
7.  Other ProtoView Products


1. HOW TO GET HELP
------------------
ProtoView Development has contracted with Borland International
to provide technical support for ProtoGen Pascal. If you have any
problems with this product, please read this file, the online
help file, and the ProtoGen manual first. If you still have a
question and need assistance, help is available from the
following sources:

  o You can use your modem to easily obtain assistance online.
    Borland maintains support forums on CompuServe, BIX, and
    GEnie. There you can contact Borland technical support
    engineers and thousands of programmers using Borland
    products. They will answer your questions and share
    information and ideas with you.

    You can also download the latest technical information,
    sample code, utilities, patches, etc. from these online
    services as well as from Borland's Download Bulletin Board
    Service (DLBBS).

    Access Borland's online services in any of these ways:

    CompuServe
      GO BORLAND
      or
      GO BPASCAL

    BIX
      JOIN BORLAND

    GEnie
      BORLAND

    Borland DLBBS
      You can reach the Borland DLBBS by dialing (408) 439-9096
      (up to 9600 Baud, 8 data bits, No Parity, 1 Stop bit). No
      special setup is required.

  o TechFax is a toll-free, 24-hour automated service that sends
    free technical information to your fax machine. More than
    1,000 documents discussing Borland software are available
    through TechFax. These documents provide valuable technical
    information that can be used as reference now and in the
    future.

    You can call TechFax at 1-800-822-4269 from any touch-tone
    telephone and obtain any bulletins or documents that you
    need.

  o The Technical Support Hot Lines are there to help you with
    questions about installation, system configuration,
    compatibility, and or usability. Lines are open from 6:00
    a.m. to 5:00 p.m. Pacific Time at (408) 461-9177.

  o If you require an advanced level of support, Borland offers a
    new Advisor Lines service. Advice concerning program design,
    debugging, and performance tuning is available. Advisor Lines
    operate from 8:00 a.m. to 5:00 p.m. Pacific Time at
    1-900-786-6080. Each call is $2.00 for each minute with the
    first minute free (available in U.S. only).

When calling Borland's Technical Support, please keep your
manuals handy and have the program running. To simplify trouble-
shooting, please be prepared with the following information:

  o Product name, serial number, and version number.

  o Computer name and model and the name and model of any
    additional hardware (video adapters, modems, etc.).

  o Operating system and version number (to find the version
    number, type VER at any DOS prompt). If you are using
    Microsoft Windows, you can find the version number by
    selecting Help|About from Program Manager.

  o The contents of your AUTOEXEC.BAT and CONFIG.SYS files
    (located in the root directory (\) of your computer's boot
    disk).

  o The contents of your WIN.INI and SYSTEM.INI files located in
    your Windows directory (if you are running Windows).

  o A daytime phone number where you can be reached.

  o The specific steps necessary to reproduce the problem.


2.  TRANSFER BUFFERS AND MULTI-SELECTION LISTBOXES
    ---------------------------------------------
To change the number of entries in the multi-selection listbox
transfer, edit the PV.INI file in your Windows directory and
change the number in the following line to the number of your
choice:

  MultiSel=10


3.   USING RESOURCE WORKSHOP & PROTOGEN
     ----------------------------------
There are a number of issues you should be aware of when using
Resource Workshop with ProtoGen.

  o Save your dialogs to a .DLG file extension rather than an .RC
    file extension.

  o Use constant identifiers when placing controls in your dialog
    boxes. ProtoGen will use the constants in the code it
    generates instead of the integer IDs, making the source code
    easier to read, understand and modify. Using any ASCII
    editor, you can create a Pascal constant, or a unit or
    include file containing the constant IDs for your controls.
    To add an identifier file to your project, choose File|Add To
    Project in Resource Workshop and select your identifier file.

    Note: don't use constant identifiers for ProtoView DataTable
          controls.

  o Customize the dialog editor in Resource Workshop by selecting
    Generate CONTROL statements only. This will help reuse
    dialogs in ProtoView.

  o Don't use a Dialog Frame or Modal Frame style as a main
    window dialog with a menu. Windows doesn't support combining
    these frame styles with a menu bar or minimize or maximize
    buttons.

  o Don't name your dialog templates with constant identifiers.
    When you rename a dialog resource to a non-integer name,
    Resource Workshop will ask you whether to create a constant
    identifier with that name. Answer 'no' to make the text you
    entered the name of the dialog, not the name of a constant.

    If you do use a dialog template with a constant ID name
    (instead of an integer name or string name), your application
    will halt with an "Invalid child window" (-5) application
    error.

    For Example:

 Don't do this:
    #define MYDIALOG 1
    MYDIALOG DIALOG 10, 18, 129, 147
    CAPTION "Save as"
    BEGIN
      ...
    END

 INSTEAD do this:

    1 DIALOG 10, 18, 129, 147
    CAPTION "Save as"
    BEGIN
      ...
    END

 OR if MYDIALOG is not a constant identifier, you can do this:

    MYDIALOG DIALOG 10, 18, 129, 147
    CAPTION "Save as"
    BEGIN
      ...
    END

    If the dialog template name is a number, Protogen will
    generate code to load the dialog by number (using
    MakeIntResource). If the dialog template name is not a
    number, Protogen will generate code to load the dialog by
    string name. Using a constant identifier for the dialog
    template name will confuse Protogen and cause code to be
    generated that attempts to load the dialog by the name of the
    Pascal constant identifier instead of the integer value that
    the constant represents.

  o Application Error -5 in your application at run time.
    Possible solutions:

    o Your dialog templates are named with constant identifiers
      instead of explicit integers or string names. See the above
      text for more information.

    o Delete your .RES file, recreate it by compiling its RC file
      with Resource Workshop (or BRC or RC), and bind it to the
      executable by remaking the main program with BPW or BP.

    o You have custom controls in your dialog box and you didn't
      explicitly load the control DLL with a call to
      LoadLibrary() in your program, or your program doesn't use
      a unit which implicitly loads the DLL (such as BWCC.PAS).
      If the custom control DLL hasn't been loaded, the dialog
      box can't be displayed. If you are using Borland custom
      controls (BWCC.DLL), make sure the BWCC check box is on in
      the code generation screen, and ProtoGen will generate the
      correct code to use BWCC controls. ProtoGen will also
      generate the code to access ProtoView DataTable custom
      controls. For any other custom controls you will have to
      add the LoadLibrary call or use the appropriate unit in the
      application.


4.  CUSTOM CONTROLS & PROTOGEN
    --------------------------
ProtoGen will generate code for Borland custom controls (BWCC).
All other custom controls need to be added to the source code
generated by ProtoGen to be used in the application.

To see your custom controls in ProtoGen's test mode, modify the
WIN.INI file in your windows directory and add the following
lines:

[User Controls]
DataTbl=C:\PV\DATATBL.DLL
CPCheckBox=C:\CPALETTE\CPCCRW.DLL

The CPCheckBox is the name of the class, and C:\CPALETTE\CPCCRW.DLL
is the directory, path, and name of the custom control DLL that
contains the custom control code. When ProtoGen is loaded it will
try to load all the custom control DLLs listed in the section of
the WIN.INI file. Once this is done, your dialog boxes will be
able to show and use your custom controls in ProtoGen's test
mode.


5.   USING PROTOGEN PASCAL WITH TURBO PASCAL 1.5
     -------------------------------------------
To use ProtoGen with Turbo Pascal 1.5:

1. Edit the PV.INI file in your Windows directory and change
   Ver=70 to Ver=15.

2. Edit the BRCW.PIF with the Windows PIF editor and change the
   program name from BRC.EXE to RC.EXE

3. Edit the BPCW.PIF with the Windows PIF editor and change the
   program name from BPC.EXE to TPCW.EXE


6.  RUNNING PROTOGEN IN WINDOWS 3.0
    -------------------------------
When Protogen runs the resource compiler as part of code
generation, the resource compiler's dos window will appear behind
Protogen's main window.  To monitor the progress of the resource
compiler, minimize Protogen's main window after the code
generation phase.


7.  OTHER PROTOVIEW PRODUCTS
    ------------------------

DataTable - Spreadsheet control for Microsoft Windows for the
            C/C++ and Pascal Windows programmer.

ProtoView - A screen management facility for Microsoft Windows
            for the C/C++ Windows programmer. It includes 12 new
            Windows controls with built-in data validation, DDE
            links, and message handling; a screen painter to
            interactively design screens and forms with data
            validation, actions, DDE links, custom colors and
            fonts and much more; a dialog class for ObjectWindows
            library, and a high-level dynamic- link library with
            functions for printing files and buffers under
            Windows; an editor function, animation functions, and
            more. ProtoView works with ProtoGen to enhance test
            mode and ProtoGen's code generation capabilities.

                    ProtoView Development Co.
                         353 Georges Rd
                        Dayton, NJ 08810
        (908)329-8588 or 1-800-231-8588 Fax: 908-329-8624
                    Compuserve: GO PROTOVIEW

