home *** CD-ROM | disk | FTP | other *** search
/ World of Shareware - Software Farm 2 / wosw_2.zip / wosw_2 / CPROG / CPE601.ZIP / CPEMAN.DOC < prev    next >
Text File  |  1990-04-09  |  17KB  |  672 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.                           Compiler Programming Environment
  33.                                      Version 5.0
  34.                     Copyright (c) 1987-89, Pedro P. Polakoff III
  35.                                  All Rights Reserved
  36.  
  37.  
  38.                             CPE Version 5.0 Users Manual
  39.  
  40.  
  41.  
  42.           1  Copyright Notice
  43.  
  44.  
  45.           The Compiler Programming Environment is Copyright (c) 1987 -
  46.           1989, Pedro P. Polakoff III and 3P Software. The distribution or
  47.           alteration of this software is a violation of the copyright laws
  48.           of the United States. Copying this software, other than for
  49.           archive purposes is strictly forbidden and is also a violation of
  50.           the software copyright.
  51.  
  52.  
  53.           2  License
  54.  
  55.  
  56.           As a registered owner of CPE you are granted a license to use
  57.           this software in a manner similar to a book. This means that you
  58.           may use CPE on any computer system so long as no possibility
  59.           exists that it could be in use by two or more people or exist on
  60.           two or more computer systems at the same time. CPE may be used in
  61.           a network development system as long as it does not exist on any
  62.           other computer system at the same time and the registered owner
  63.           of the software is the owner of the hosting computer system. The
  64.           Shareware version of CPE may only be used for a period of 10 days
  65.           before registration is required. No license other than granting
  66.           you the privilege of evaluating this software is provided with
  67.           regards to the unregistered, shareware, version.
  68.  
  69.  
  70.           3  Warranty
  71.  
  72.  
  73.           CPE is warranted for defects in workmanship and shipping only. No
  74.           other warranty either expressed or implied shall apply to this
  75.           software. The author and 3P Software does not warrant the ability
  76.           of the software to perform for any specific purpose other than
  77.           that which it was designed for. Neither the author, nor 3P
  78.           Software, shall be responsible for any claims due to failure of
  79.           this software to perform it's intended function.
  80.  
  81.  
  82.           4  System Requirements
  83.  
  84.  
  85.           CPE requires an IBM compatible computer with a minimum of 128K of
  86.           Random Access Memory (RAM). CPE will detect and use any type of
  87.           video adapter and mouse. Command line switches allow for override
  88.           of the default video settings used by CPE. CPE requires the use
  89.           of DOS 3.0 or later.
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.                                         - 2 -
  100.  
  101.  
  102.                             CPE Version 5.0 Users Manual
  103.  
  104.  
  105.  
  106.           5  Overview of Functions
  107.  
  108.  
  109.           CPE was designed to provide the compiler language programmer with
  110.           a complete integrated programming environment to work in. CPE
  111.           integrates your favored editor, compiler, linker, make utility,
  112.           debugger and two optional utilities into a complete programming
  113.           environment similar to that now used by Borland International in
  114.           all of their products. CPE is unlimited in the combinations of
  115.           the utilities that it supports and may be reconfigured for any
  116.           combination of the utilities required for the programming job.
  117.           CPE allows for project management and the use of compiler command
  118.           files, link files, make files and error files.
  119.  
  120.  
  121.           6  Distribution Files
  122.  
  123.  
  124.           CPE is normally distributed in self-extracting ZIP file format.
  125.           The standard CPE ZIP/EXE file contains the following files:
  126.  
  127.           CPE.EXE        This is the CPE program itself.
  128.  
  129.           CPE.HLP        This is the CPE help file.
  130.  
  131.           CPEREG.TXT     This is the Shareware product registration form.
  132.  
  133.           README.TXT     Last minute instructions.
  134.           
  135.           UTILS.ZIP      A very nice packet of programming utilities.
  136.           
  137.           3PMAKE.EXE     3P Software's MAKE Utility.
  138.           
  139.           3PMAKE.DOC     Documentation for 3PMAKE.
  140.  
  141.  
  142.           7  Installation
  143.  
  144.  
  145.           When installing CPE we recommend that you copy the program file
  146.           CPE.EXE to a directory that is included in your search path. By
  147.           doing so you will be able to invoke the use of CPE from any other
  148.           directory or path on your computer system. The only file required
  149.           by CPE for it's operation is the actual program file itself. When
  150.           you have registered your copy of CPE a registration file will be
  151.           created. This registration file must be in your search path and
  152.           should be in the same directory as the CPE.EXE file itself.
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.                                         - 3 -
  160.  
  161.  
  162.                             CPE Version 5.0 Users Manual
  163.  
  164.  
  165.  
  166.           8  Starting CPE
  167.  
  168.  
  169.           CPE allows command line parameters to override or change it's
  170.           actions on start up. Without any command line parameters CPE will
  171.           default to using the current hardware video adapter and the
  172.           default configuration (CONFIG.CPE) and project (CPEPROJ.PRJ)
  173.           files if they are present in the current directory. By the use of
  174.           the command line parameters you may have CPE use black & white
  175.           mode, alternate configuration and/or project files and an
  176.           alternate work file. Following is a table of CPE command line
  177.           parameters;
  178.  
  179.                           Table 1: Command Line Parameters
  180.  
  181.                ┌──────────┬──────────┬───────────────────────────────────┐
  182.                │ Syntax #1│ Syntax #2│       Function                    │
  183.                ├──────────┼──────────┼───────────────────────────────────┤
  184.                │ -m       │ /m       │ Forces use of Black & White mode  │
  185.                │ -c<name> │ /c<name> │ Loads <name> as configuration     │
  186.                │ -p<name> │ /p<name> │ Loads <name> as project           │
  187.                │ -w<name> │ /w<name> │ Sets Work file to <name>          │
  188.                │ -b       │ /b       │ Use BIOS screen writes            │
  189.                │ -s       │ /s       │ CGA Snow control toggle           │
  190.                │ -n       │ /n       │ No Clock display mode.            │
  191.                ┴──────────┴──────────┴───────────────────────────────────┘
  192.  
  193.           You may provide a complete drive,path and file name with both the
  194.           -p and -c parameters. If you do provide a drive & path with a -c
  195.           or -p parameter, CPE will remember the full path when you are
  196.           saving the files again. Wildcards are not acceptable as the
  197.           project or configuration file name and will be ignored. CPE will
  198.           not allow the use of the -p and -c parameters until it has been
  199.           registered.
  200.  
  201.           The file name given with a -w parameter will override the file
  202.           name that was stored in the project file. You may provide a
  203.           wildcard value with a -w parameter, in which case CPE will
  204.           display a directory and prompt for the file name on startup.
  205.           Following are some sample CPE startup commands;
  206.  
  207.                C:> CPE -m -p\etc\myfile.prj -c\bin\msc.cpe
  208.  
  209.                C:> CPE -wnewfile.c
  210.  
  211.                C:> CPE -pnew.prj -w*.prg
  212.  
  213.           CPE will verify all command line parameters and will report any
  214.           errors or duplicates to you and then exit with the dos errorlevel
  215.           set to one (1). If there are no errors in the CPE start up
  216.           commands CPE will begin it's operation with the parameters that
  217.           you have passed to it or it will use the default values.
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.                                         - 4 -
  225.  
  226.  
  227.                             CPE Version 5.0 Users Manual
  228.  
  229.  
  230.  
  231.           9  Mouse Commands
  232.  
  233.  
  234.           CPE will use a Microsoft compatible mouse for menu selections and
  235.           operation. Moving the mouse will move the CPE menu selection bar
  236.           or the cursor in a window. Pressing the LEFT button will select
  237.           from a menu or emulate the ENTER key. Pressing the RIGHT button
  238.           will cancel a selection or emulate the ESCAPE key.
  239.  
  240.  
  241.           10  Command Macros
  242.  
  243.  
  244.           The power and flexibility of CPE comes from it's processing all
  245.           commands with a specialized macro system. By the use of these
  246.           macros in configuring CPE you may adapt CPE to work with any
  247.           combination of programming utilities. CPE will use the following
  248.           macros in the execution of it's commands:
  249.  
  250.                                    Table 2: Macros
  251.  
  252.           $@             Expands to the full name of the file currently
  253.                          stored as the work file.
  254.  
  255.           $*             Expands to the root file name of the currently
  256.                          stored work file.
  257.  
  258.           $L             Expands to the full name of the currently stored
  259.                          linker file.
  260.  
  261.           $C             Expands to the full name of the currently stored
  262.                          compiler file.
  263.  
  264.           $M             Expands to the full name of the currently stored
  265.                          make file.
  266.  
  267.           $E             Expands to the full name of the currently stored
  268.                          errors file.
  269.  
  270.           $<             This Macro will prompt for a user input of a
  271.                          file-name.
  272.  
  273.  
  274.           The following command macro samples will help you to use and
  275.           understand the macro system:
  276.  
  277.           Compiler Commands:  cl /c /Oailt /Zi $@
  278.                               clipper $@ -l
  279.                               masm $ >$E
  280.  
  281.           Linker Commands:    link $*.obj+core.obj,$*.exe,$*.map,mylib
  282.                               link $*,,,mylib;
  283.  
  284.           Make Commands:      make -f$M
  285.  
  286.  
  287.  
  288.                                         - 5 -
  289.  
  290.  
  291.                             CPE Version 5.0 Users Manual
  292.  
  293.  
  294.  
  295.                               make $M
  296.  
  297.           Editor Commands:    vedit $@
  298.                               vedit $<
  299.                               vedit $M
  300.  
  301.           Debugger Commands:  dbu.exe
  302.                               td $*.exe
  303.                               cv $*.exe
  304.  
  305.           As these examples show the combinations of commands using the
  306.           macro system is virtually unlimited.
  307.  
  308.  
  309.           11  Configuration File
  310.  
  311.  
  312.           The configuration file is merely a collection of CPE macros
  313.           stored for later retrieval and use. The macros for Compiler,
  314.           Linker, Make Utility, Editor, Debugger and the two optional
  315.           utilities are stored in a disk file that may be altered and
  316.           reused by CPE to configure it for different combinations of these
  317.           utilities. You may want to construct a different configuration
  318.           file for each compiler language that you work with, or even for
  319.           different memory models and options that you may use with each
  320.           compiler.
  321.  
  322.           To edit a configuration you would select "Options" from the main
  323.           menu and then complete each of the macro entries from the sub-
  324.           menu items. You do not need to supply all of the options, only
  325.           those that you will be using are required.
  326.  
  327.           To Save a configuration you would select the sub-menu option
  328.           "Save setup" and CPE will prompt you for the full path and name
  329.           of the configuration file. You my accept the current name or
  330.           "CONFIG.CPE" if no name was given, or you may supply a full path
  331.           and name to save the configuration as.
  332.  
  333.           Retrieving a configuration is similar to saving except that all
  334.           of the macros currently used by CPE will be overwritten by the
  335.           new configuration macros. If you provide a wildcard in the file
  336.           name, CPE will display a directory of all files that match the
  337.           waildcard so that you may choose the file to load.
  338.  
  339.  
  340.           12  Project Maintenance
  341.  
  342.  
  343.           CPE allows you to maintain a project file for each programming
  344.           task. The project file will contain the names of the associated
  345.           Work file, Make file, Linker file, Compiler file and Errors file.
  346.           These files names are used via the macro system in the commands
  347.           stored in your configuration files. Saving and retrieving a
  348.  
  349.  
  350.  
  351.  
  352.                                         - 6 -
  353.  
  354.  
  355.                             CPE Version 5.0 Users Manual
  356.  
  357.  
  358.  
  359.           project file is exactly the same as the saving or retrieving of a
  360.           configuration file.
  361.  
  362.  
  363.           13  Registration
  364.  
  365.  
  366.           When you register CPE you will receive a special code from 3P
  367.           software and the instructions for entering the code to register
  368.           your software.  Once the code is validated you will be asked for
  369.           the serial number that is also provided with your registration.
  370.           If all verifies correctly your personal information will be branded
  371.           into your copy of CPE and it will be permanently registered to you.
  372.           You should make an archival backup of your registered version as
  373.           soon as you have completed the registration process.             
  374.                      
  375.  
  376.  
  377.           14  Updates & Revisions
  378.  
  379.  
  380.           Due to the nature of CPE's registration updates are as easy to
  381.           get as the original version was. Just locate the latest revision
  382.           of CPE on any of the following BBS systems and download your
  383.           update. Once you have registered one version, all versions that
  384.           you download are registered.
  385.  
  386.                      Table 3: Some Systems carrying CPE updates
  387.  
  388.                    ┌────────────┬──────────────────────────────┐
  389.                    │ System     │ Location                     │
  390.                    ├────────────┼──────────────────────────────┤
  391.                    │ Compuserve │ IBMPRO,NANFORUM,PROGFORUM    │
  392.                    │ GEnie      │ DBMS,IBMPC                   │
  393.                    └────────────┴──────────────────────────────┘
  394.  
  395.           You may also download updates to CPE from any local BBS system
  396.           from which you may have received your original version.
  397.  
  398.  
  399.           15  Support & Service
  400.  
  401.  
  402.           As a registered owner of CPE you may contact 3P software for
  403.           support and service at the following address or phone number:
  404.  
  405.                     3P Software
  406.                     1827 Kendrick Street
  407.                     Philadelphia, PA 19152-1829
  408.                     (215) 725-6068
  409.           Telephone support is available Monday - Saturday from 10:00am to
  410.           10:00pm Eastern time.
  411.  
  412.  
  413.  
  414.  
  415.  
  416.                                         - 7 -
  417.  
  418.  
  419.                             CPE Version 5.0 Users Manual
  420.  
  421.  
  422.  
  423.           You may also contact the program author via E-Mail at the
  424.           following system addresses:
  425.  
  426.                     Compuserve:    73157,2412
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.                                         - 8 -
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.                                     Contents
  493.  
  494.  
  495.                   1  Copyright Notice  . . . . . . . . . . . . . . . 2
  496.                   2  License . . . . . . . . . . . . . . . . . . . . 2
  497.                   3  Warranty  . . . . . . . . . . . . . . . . . . . 2
  498.                   4  System Requirements . . . . . . . . . . . . . . 2
  499.                   5  Overview of Functions . . . . . . . . . . . . . 3
  500.                   6  Distribution Files  . . . . . . . . . . . . . . 3
  501.                   7  Installation  . . . . . . . . . . . . . . . . . 3
  502.                   8  Starting CPE  . . . . . . . . . . . . . . . . . 4
  503.                   9  Mouse Commands  . . . . . . . . . . . . . . . . 5
  504.                   10  Command Macros . . . . . . . . . . . . . . . . 5
  505.                   11  Configuration File . . . . . . . . . . . . . . 6
  506.                   12  Project Maintenance  . . . . . . . . . . . . . 6
  507.                   13  Registration . . . . . . . . . . . . . . . . . 7
  508.                   14  Updates & Revisions  . . . . . . . . . . . . . 7
  509.                   15  Support & Service  . . . . . . . . . . . . . . 7
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.                                           i
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.                                          ii
  608.  
  609.  
  610.  
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.                                      Tables
  621.  
  622.  
  623.                Table 1: Command Line Parameters  . . . . . . . . . . 4
  624.                Table 2: Macros . . . . . . . . . . . . . . . . . . . 5
  625.                Table 3: Some Systems carrying CPE updates  . . . . . 7
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.                                          iii
  672.