






























                          Compiler Programming Environment
                                     Version 4.1
                    Copyright (c) 1987-89, Pedro P. Polakoff III
                                 All Rights Reserved


                            CPE Version 4.1 Users Manual



          1  Copyright Notice


          The Compiler Programming Environment is Copyright (c) 1987 -
          1989, Pedro P. Polakoff III and 3P Software. The distribution or
          alteration of this software is a violation of the copyright laws
          of the United States. Copying this software, other than for
          archive purposes is strictly forbidden and is also a violation of
          the software copyright.


          2  License


          As a registered owner of CPE you are granted a license to use
          this software in a manner similar to a book. This means that you
          may use CPE on any computer system so long as no possibility
          exists that it could be in use by two or more people or exist on
          two or more computer systems at the same time. CPE may be used in
          a network development system as long as it does not exist on any
          other computer system at the same time and the registered owner
          of the software is the owner of the hosting computer system. The
          Shareware version of CPE may only be used for a period of 10 days
          before registration is required. No license other than granting
          you the privilege of evaluating this software is provided with
          regards to the unregistered, shareware, version.


          3  Warranty


          CPE is warranted for defects in workmanship and shipping only. No
          other warranty either expressed or implied shall apply to this
          software. The author and 3P Software does not warrant the ability
          of the software to perform for any specific purpose other than
          that which it was designed for. Neither the author, nor 3P
          Software, shall be responsible for any claims due to failure of
          this software to perform it's intended function.


          4  System Requirements


          CPE requires an IBM compatible computer with a minimum of 128K of
          Random Access Memory (RAM). CPE will detect and use any type of
          video adapter and mouse. Command line switches allow for override
          of the default video settings used by CPE. CPE requires the use
          of DOS 3.0 or later.









                                        - 2 -


                            CPE Version 4.1 Users Manual



          5  Overview of Functions


          CPE was designed to provide the compiler language programmer with
          a complete integrated programming environment to work in. CPE
          integrates your favored editor, compiler, linker, make utility,
          debugger and two optional utilities into a complete programming
          environment similar to that now used by Borland International in
          all of their products. CPE is unlimited in the combinations of
          the utilities that it supports and may be reconfigured for any
          combination of the utilities required for the programming job.
          CPE allows for project management and the use of compiler command
          files, link files, make files and error files.


          6  Distribution Files


          CPE is normally distributed in self-extracting ZIP file format.
          The standard CPE ZIP/EXE file contains the following files:

          CPE.EXE        This is the CPE program itself.

          CPEHIST.TXT    This is the CPE revisions history file containing
                         the information regarding changes in CPE by the
                         version number.

          CPEREG.TXT     This is the Shareware product registration form.

          CONFIG.CPE     This is a sample configuration file. It is the
                         only one usable by the CPE until it is registered.

          CPEPROJ.PRJ    This is a sample project file. It is the only one
                         usable by CPE until it is registered.

          README.TXT     Last minute instructions


          7  Installation


          When installing CPE we recommend that you copy the program file
          CPE.EXE to a directory that is included in your search path. By
          doing so you will be able to invoke the use of CPE from any other
          directory or path on your computer system. The only file required
          by CPE for it's operation is the actual program file itself. When
          you have registered your copy of CPE a registration file will be
          created. This registration file must be in your search path and
          should be in the same directory as the CPE.EXE file itself.








                                        - 3 -


                            CPE Version 4.1 Users Manual



          8  Starting CPE


          CPE allows command line parameters to override or change it's
          actions on start up. Without any command line parameters CPE will
          default to using the current hardware video adapter and the
          default configuration (CONFIG.CPE) and project (CPEPROJ.PRJ)
          files if they are present in the current directory. By the use of
          the command line parameters you may have CPE use black & white
          mode, alternate configuration and/or project files and an
          alternate work file. Following is a table of CPE command line
          parameters;

                          Table 1: Command Line Parameters

               Ŀ
                Syntax #1 Syntax #2       Function                    
               Ĵ
                -m        /m        Forces use of Black & White mode  
                -c<name>  /c<name>  Loads <name> as configuration     
                -p<name>  /p<name>  Loads <name> as project           
                -w<name>  /w<name>  Sets Work file to <name>          
                -b        /b        Use BIOS screen writes            
                -s        /s        CGA Snow control toggle           
               

          You may provide a complete drive,path and file name with both the
          -p and -c parameters. If you do provide a drive & path with a -c
          or -p parameter, CPE will remember the full path when you are
          saving the files again. CPE will not allow the use of the -p and
          -c parameters until it has been registered.

          The file name given with a -w parameter will override the file
          name that was stored in the project file. You may provide a
          wildcard value with a -w parameter, in which case CPE will
          display a directory and prompt for the file name on startup.
          Following are some sample CPE startup commands;

               C:> CPE -m -p\etc\myfile.prj -c\bin\msc.cpe

               C:> CPE -wnewfile.c

               C:> CPE -pnew.prj -w*.prg

          CPE will verify all command line parameters and will report any
          errors or duplicates to you and then exit with the dos errorlevel
          set to one (1). If there are no errors in the CPE start up
          commands CPE will begin it's operation with the parameters that
          you have passed to it or it will use the default values.








                                        - 4 -


                            CPE Version 4.1 Users Manual



          9  Mouse Commands


          CPE will use a Microsoft compatible mouse for menu selections and
          operation. Moving the mouse will move the CPE menu selection bar
          or the cursor in a window. Pressing the LEFT button will select
          from a menu or emulate the ENTER key. Pressing the RIGHT button
          will cancel a selection or emulate the ESCAPE key.


          10  Command Macros


          The power and flexibility of CPE comes from it's processing all
          commands with a specialized macro system. By the use of these
          macros in configuring CPE you may adapt CPE to work with any
          combination of programming utilities. CPE will use the following
          macros in the execution of it's commands:

                                   Table 2: Macros

          $@             Expands to the full name of the file currently
                         stored as the work file.

          $*             Expands to the root file name of the currently
                         stored work file.

          $L             Expands to the full name of the currently stored
                         linker file.

          $C             Expands to the full name of the currently stored
                         compiler file.

          $M             Expands to the full name of the currently stored
                         make file.

          $E             Expands to the full name of the currently stored
                         errors file.

          $<             This Macro will prompt for a user input of a
                         file-name.


          The following command macro samples will help you to use and
          understand the macro system:

          Compiler Commands:  cl /c /Oailt /Zi $@
                              clipper $@ -l
                              masm $ >$E

          Linker Commands:    link $*.obj+core.obj,$*.exe,$*.map,mylib
                              link $*,,,mylib;

          Make Commands:      make -f$M



                                        - 5 -


                            CPE Version 4.1 Users Manual



                              make $M

          Editor Commands:    vedit $@
                              vedit $<
                              vedit $M

          Debugger Commands:  dbu.exe
                              td $*.exe
                              cv $*.exe

          As these examples show the combinations of commands using the
          macro system is virtually unlimited.


          11  Configuration File


          The configuration file is merely a collection of CPE macros
          stored for later retrieval and use. The macros for Compiler,
          Linker, Make Utility, Editor, Debugger and the two optional
          utilities are stored in a disk file that may be altered and
          reused by CPE to configure it for different combinations of these
          utilities. You may want to construct a different configuration
          file for each compiler language that you work with, or even for
          different memory models and options that you may use with each
          compiler.

          To edit a configuration you would select "Options" from the main
          menu and then complete each of the macro entries from the sub-
          menu items. You do not need to supply all of the options, only
          those that you will be using are required.

          To Save a configuration you would select the sub-menu option
          "Save setup" and CPE will prompt you for the full path and name
          of the configuration file. You my accept the current name or
          "CONFIG.CPE" if no name was given, or you may supply a full path
          and name to save the configuration as.

          Retrieving a configuration is similar to saving except that all
          of the macros currently used by CPE will be overwritten by the
          new configuration macros. If you provide a wildcard in the file
          name, CPE will display a directory of all files that match the
          waildcard so that you may choose the file to load.


          12  Project Maintenance


          CPE allows you to maintain a project file for each programming
          task. The project file will contain the names of the associated
          Work file, Make file, Linker file, Compiler file and Errors file.
          These files names are used via the macro system in the commands
          stored in your configuration files. Saving and retrieving a




                                        - 6 -


                            CPE Version 4.1 Users Manual



          project file is exactly the same as the saving or retrieving of a
          configuration file.


          13  Registration


          When you register CPE you will receive a special code from 3P
          software and the instructions for entering the code to register
          your software.  Once the code is validated a registration file
          will be created that will change this and all future versions of
          CPE into a fully functional registered version. Please do not
          loose your code. In the event the registration file should be
          corrupted or lost you will need the code to re-register CPE. If
          you do happen to loose your code, you may contact 3P Software for
          a new code.


          14  Updates & Revisions


          Due to the nature of CPE's registration updates are as easy to
          get as the original version was. Just locate the latest revision
          of CPE on any of the following BBS systems and download your
          update. Once you have registered one version, all versions that
          you download are registered.

                        Table 3: Systems carrying CPE updates

                   Ŀ
                    System      Location                     
                   Ĵ
                    Compuserve  IBMPRO,NANFORUM,PROGFORUM    
                    GEnie       DBMS,IBMPC                   
                   

          You may also download updates to CPE from any local BBS system
          from which you may have received your original version.


          15  Support & Service


          As a registered owner of CPE you may contact 3P software for
          support and service at the following address or phone number:

                    3P Software
                    1827 Kendrick Street
                    Philadelphia, PA 19152-1829
                    (215) 725-6068
          Telephone support is available Monday - Saturday from 10:00am to
          10:00pm Eastern time.





                                        - 7 -


                            CPE Version 4.1 Users Manual



          You may also contact the program author via E-Mail at the
          following system addresses:

                    Compuserve:    73157,2412
                    GEnie:         PPP3




















































                                        - 8 -












                                    Contents


                  1  Copyright Notice  . . . . . . . . . . . . . . . 2
                  2  License . . . . . . . . . . . . . . . . . . . . 2
                  3  Warranty  . . . . . . . . . . . . . . . . . . . 2
                  4  System Requirements . . . . . . . . . . . . . . 2
                  5  Overview of Functions . . . . . . . . . . . . . 3
                  6  Distribution Files  . . . . . . . . . . . . . . 3
                  7  Installation  . . . . . . . . . . . . . . . . . 3
                  8  Starting CPE  . . . . . . . . . . . . . . . . . 4
                  9  Mouse Commands  . . . . . . . . . . . . . . . . 5
                  10  Command Macros . . . . . . . . . . . . . . . . 5
                  11  Configuration File . . . . . . . . . . . . . . 6
                  12  Project Maintenance  . . . . . . . . . . . . . 6
                  13  Registration . . . . . . . . . . . . . . . . . 7
                  14  Updates & Revisions  . . . . . . . . . . . . . 7
                  15  Support & Service  . . . . . . . . . . . . . . 7

































                                          i































































                                         ii












                                     Tables


               Table 1: Command Line Parameters  . . . . . . . . . . 4
               Table 2: Macros . . . . . . . . . . . . . . . . . . . 5
               Table 3: Systems carrying CPE updates . . . . . . . . 7













































                                         iii
