home *** CD-ROM | disk | FTP | other *** search
/ World of Shareware - Software Farm 2 / wosw_2.zip / wosw_2 / CPROG / PCS20.ZIP / PCSHELL.DOC < prev    next >
Text File  |  1992-08-13  |  25KB  |  794 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.         
  8.                             
  9.                             
  10.                             
  11.                             
  12.                             
  13.                             
  14.                             
  15.                             
  16.                             
  17.                             
  18.                             
  19.                                  _______
  20.                             ____|__     |               (TM)
  21.                          --|       |    |-------------------
  22.                            |   ____|__  |  Association of
  23.                            |  |       |_|  Shareware
  24.                            |__|   o   |    Professionals
  25.                          -----|   |   |---------------------
  26.                               |___|___|    MEMBER
  27.         
  28.         
  29.                                  POWER C SHELL
  30.                                   VERSION 2.0
  31.                               
  32.                Copyright 1991 by Chuck Steenburgh & Tay-Jee Software
  33.          
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.                                      Page 1
  63.  
  64.  
  65.  
  66.  
  67.  
  68.         
  69.         
  70.         
  71.         
  72.                           TABLE OF CONTENTS
  73.                           
  74.         
  75.         Distribution Limitations.  .  .  .  .  .  .  .  .  .  3
  76.         
  77.         ASP Ombudsman  .  .  .  .  .  .  .  .  .  .  .  .  .  3
  78.         
  79.         Disclaimer  .  .  .  .  .  .  .  .  .  .  .  .  .  .  3
  80.         
  81.         Starting Power C Shell Version 2.0  .  .  .  .  .  .  6
  82.         
  83.            Environment variables                              6
  84.            Running Power C Shell                              7
  85.            Configuring PCS                                    7
  86.            Installing PCS                                     8
  87.         
  88.         Power C Shell Menu Options .  .  .  .  .  .  .  .  .  9
  89.         
  90.            Files Menu                                         9
  91.            Operations Menu                                   10
  92.            Configuration Menu                                11
  93.            Quit Menu                                         13
  94.         
  95.         Help  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  . 13
  96.          
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.                                      Page 2
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                     
  130.         DISTRIBUTION LIMITATIONS:  This is a copyrighted shareware
  131.         program.  You have a limited license to try out this soft-
  132.         ware on a single computer for a period of 30 days.  If you
  133.         continue to use the software after this 30-day trial period,
  134.         you must become a registered user.
  135.         
  136.         OMBUDSMAN
  137.         
  138.           This program is produced by a member of the Association of
  139.         Shareware Professionals (ASP).  ASP wants to make sure that
  140.         the shareware principle works for you.  If you are unable to
  141.         resolve a shareware-related problem with an ASP member by
  142.         contacting the member directly, ASP may be able to help.  The
  143.         ASP Ombudsman can help you resolve a dispute or problem with
  144.         an ASP member, but does not provide technical support for 
  145.         members' products.  Please write to the ASP Ombudsman at 545
  146.         Grover Road, Muskegon, MI 49442 or send a CompuServe message
  147.         via CompuServe Mail to ASP Ombudsman, 70007,3536.
  148.         
  149.         
  150.         DISCLAIMER
  151.         
  152.            The program described in this documentation is guaranteed 
  153.         to do absolutely nothing!  It has, however, in my experience
  154.         performed essentially as described herein.  The author will 
  155.         not be responsible for any loss or damages caused through
  156.         the use of these programs.  No warranty, express or implied,
  157.         is provided for this software's performance, merchantability,
  158.         or fitness for a particular purpose.
  159.         
  160.            All trademarks are property of their respective owners.  In
  161.         particular, "Power C" is a registered trademark of MIX Software.
  162.         
  163.            The program and documentation are Copyright 1991 by Chuck 
  164.         Steenburgh & Tay-Jee Software.  You are encouraged to distri-
  165.         bute these programs provided the following conditions are met:
  166.         
  167.            - all files contained in the archive or distribution disk
  168.              must be distributed together in UNMODIFIED form
  169.         
  170.            - you charge no more than a $7 fee for copying or sub-
  171.              scription, and clearly indicate that payment of such
  172.              a fee does NOT grant ownership of the programs.
  173.         
  174.            You may evaluate this program for up to 30 days on a free
  175.         trial basis.  After 30 days, you should register your use of
  176.         the program.  The registration fee is $20, payable to Tay-Jee
  177.         Software at the address given below.  Please see the file
  178.         REGISTER.FRM on the distribution disk/archive.
  179.         
  180.            Registration does have its advantages:
  181.         
  182.            - I am improving the program all the time.  Registration
  183.  
  184.                                      Page 3
  185.  
  186.  
  187.  
  188.  
  189.  
  190.              will get you IMMEDIATELY a disk with the latest version.
  191.              You will also get the next major release of the program set
  192.              sent to you free of charge.
  193.         
  194.            - While I can't promise to include everyone's suggestions
  195.              in program updates, you can bet I'll listen to registered
  196.              users before any of you scrounges out there.
  197.         
  198.            - You will make me feel all warm and fuzzy and appreciated, 
  199.              and all that good stuff.
  200.         
  201.            - You will also get an evaluation copy of my text file for-
  202.              matting program (used to produce the margins in this doc-
  203.              ument), and any other electronic creations I have decided
  204.              to unleash on a foolish, unsuspecting world.
  205.            
  206.            - Registered users can obtain the source code for the program
  207.              at the cost of an additional $10.
  208.         
  209.            Send comments/registrations to:
  210.         
  211.                 Tay-Jee Software
  212.                 Post Office Box 835
  213.                 Lexington, VA 24450
  214.                 (703)464-5290
  215.                 
  216.                 !!!VIRGINIA RESIDENTS ADD 4.5SALES TAX!!!
  217.         
  218.                 CIS 72330,1776 (I haunt the IBMSYS and IBMPRO forums)
  219.         
  220.         Now that the semi-legal mumbo-jumbo is out of the way, welcome
  221.         to POWER C SHELL Version 2.0.  This program began as a simple 
  222.         aid to Power C programmers and blossomed into a much more am-
  223.         bitious project.  POWER C SHELL Version 2.0 has the following 
  224.         features:
  225.         
  226.              - Simplifies editing, compiling, and debugging
  227.              of POWER C programs without having to fool with
  228.              the DOS command line
  229.             
  230.              - Customizable editor and viewer (use your favorites),
  231.              or use the very handy TDE public domain editor in-
  232.              cluded in the package
  233.             
  234.              - Customizable compile & link options for Power C 
  235.              compiler (with help screens to explain them all)
  236.             
  237.              - Ability to review C.ERR error listing without
  238.              leaving the shell
  239.             
  240.              - Test run your executable programs without
  241.              leaving the shell
  242.              
  243.              - Easy, one-step loading of complete projects
  244.  
  245.                                      Page 4
  246.  
  247.  
  248.  
  249.  
  250.  
  251.              
  252.              - Customizable screen colors
  253.              
  254.              - Context-sensitive help (although the program is so
  255.              simple, I doubt you'll need it)
  256.              
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.                                      Page 5
  307.  
  308.  
  309.  
  310.  
  311.  
  312.         
  313.         STARTING POWER C SHELL VERSION 2.0
  314.         
  315.            Power C Shell itself requires approximately 130K of free
  316.         memory to run.  To this amount, however, you must add the 
  317.         greater of the memory required by your editor, viewer, and 
  318.         whatever C program you happen to be working on.  Power C Shell
  319.         remains in memory when these programs are executing.  The
  320.         Power C compiler, version 2.0.1, requires about 256K of free
  321.         memory.  Basically, a 512K machine or better is a safe bet, al-
  322.         though you might get by with only 384K available.
  323.         
  324.         
  325.             Environment Variables
  326.             =====================
  327.             
  328.            Power C Shell can configure itself through the use of
  329.         environment variables. Power C Shell understands the following
  330.         environment variables:
  331.         
  332.              PCEDIT:     complete path of your editor
  333.              PCEDITP:    any command line parameters used by your editor
  334.              PCVIEW:     complete path of your viewer
  335.              PCVIEWP:    any command line parameters used by your viewer
  336.              PCOPTIONS:  default compile options to be used by PC.EXE
  337.              PCLINK:     default link options to be used by PCL.EXE
  338.             
  339.            Environment variables are established by use of the DOS
  340.         SET command.  To set the name of your viewer to C:\LIST.COM,
  341.         simply type the following at the DOS command line:
  342.         
  343.              SET PCVIEW=C:\LIST.COM
  344.             
  345.            Use a similar procedure to set the other variables.  To
  346.         set your default compile options to "/e/ms" (link file, use
  347.         small memory model), type the following on the DOS command 
  348.         line:
  349.         
  350.              SET PCOPTIONS=/e/ms
  351.             
  352.            If, while entering your environment variables, you get
  353.         the message "Out of environment space" or something similar,
  354.         you need to edit your CONFIG.SYS file.  Look for a state-
  355.         ment similar to the following:
  356.         
  357.              SHELL=c:\dos\command.com c:\dos /p
  358.             
  359.            To increase the environment space, change the statement
  360.         to something like this:
  361.         
  362.              SHELL=c:\dos\command.com c:\dos /p /e:384
  363.             
  364.            In the example above, 384 is the new number of bytes re-
  365.         served for the environment (160 is the default).  DOS will 
  366.  
  367.                                      Page 6
  368.  
  369.  
  370.  
  371.  
  372.  
  373.         always round this number to a multiple of 16.  384 bytes 
  374.         should be enough for most users, although you may need more.
  375.         The limit is 32,768, although there should never be a need 
  376.         for more than 1 or 2K.   See your DOS manual for more de-
  377.         tails on setting the environment size.  Note that you must 
  378.         reboot your computer after editing your CONFIG.SYS file for
  379.         any changes to take effect.
  380.         
  381.            The PCEDITP and PCVIEWP parameter variables assume that
  382.         your editor and viewer accept command line switches AFTER the 
  383.         filename to edit/view.  For example:
  384.         
  385.              <PCEDIT> (filename) <PCEDITP>
  386.              edit   program.c   -x -e
  387.               
  388.            If your editor/viewer only accept parameters and switches
  389.         BEFORE the filename, enter them as part of the PCEDIT or 
  390.         PCVIEW varaibles.  For example:
  391.         
  392.              <PCEDIT>     (filename)
  393.              edit -x -e   program.c
  394.             
  395.            you would enter the following command on the DOS command 
  396.         line prior to starting Power C Shell:
  397.         
  398.              SET PCEDIT=edit -x -e
  399.         
  400.            Environment variables will override any options contained
  401.         in the PCSHELL.CFG configuration file.
  402.         
  403.             
  404.              Running Power C Shell
  405.              =====================
  406.             
  407.              The syntax for starting Power C Shell is as follows:
  408.             
  409.                PCS2 [filename] [/D-] [/H]
  410.                
  411.                [filename] optional parameter specifying complete
  412.                           name of source file to work on
  413.                
  414.                [/D-]      optional parameter telling PCS to ignore its
  415.                           configured starting directory and use the
  416.                           current directory
  417.                
  418.                [/H]       display a brief help screen
  419.              
  420.              
  421.              Configuring PCS
  422.              =========== ===
  423.              
  424.            Prior to using PCS, you will have to configure it.  You may
  425.         do this either through the environment variables described above
  426.         or through the Configuration pull-down menu detailed below.  At
  427.  
  428.                                      Page 7
  429.  
  430.  
  431.  
  432.  
  433.  
  434.         a minimum, you will need to specify the name of your editor and
  435.         any compile options you would like used with the Power C.
  436.         
  437.                
  438.              Installing PCS
  439.              ========== ===
  440.            
  441.            It is recommended, but not necessary, to copy the PCS2.EXE
  442.         program file to the same directory containing your Power C com-
  443.         piler.  If you would like to be able to use PCS from any direc-
  444.         tory, make sure the PCS2.EXE file is placed in a subdirectory
  445.         contained in your DOS PATH.
  446.         
  447.            If you would like to use the TDE editor with PCS, place the
  448.         TDE program files in a directory accessible to PCS.  If this
  449.         directory is not also on your DOS PATH, you will have to specify
  450.         the COMPLETE path for TDE when you configure PCS.
  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.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.                                      Page 8
  490.  
  491.  
  492.  
  493.  
  494.  
  495.         
  496.         POWER C SHELL MENU OPTIONS
  497.         
  498.              Files Menu
  499.              ===== ====
  500.         
  501.              Pressing the Alt-F key combination will activate the Files
  502.         pull-down menu, which contains the following options:            
  503.         
  504.         
  505.              Open 
  506.              
  507.            Selecting this menu choice will allow you to open a file for
  508.         editing and/or compiling.  Up to seven files, all belonging to
  509.         the same project, may be open at one time in PCS v2.0.  After
  510.         selecting this item, you'll be asked to enter a wildcard file
  511.         specification.  The default is *.C; however, you may enter any
  512.         value you like.  A list of all files matching the entered wild-
  513.         card pattern will be displayed in a box centered on the screen.
  514.         Using the cursor keys, position the highlight bar over the name
  515.         of the file you would like to open and then press <Enter>.
  516.         
  517.            If you open a Power C project file with a .PRJ extension, all
  518.         of the associated source files of the project will be opened.
  519.         NOTE:  This project file MUST be in PCS 2.0 format for this to
  520.         work properly.  If you open a project file while other files are
  521.         open, they will be closed first and then the project will be
  522.         loaded.
  523.         
  524.            If more than one file is open, you will be asked to choose an
  525.         "active file."  The active file is the file which is loaded by
  526.         the "Edit" menu choice described below.  Enter the file number
  527.         (1-7) of the file which you would like to be active.  A pair
  528.         of flashing exclamation points appears next to the name of the 
  529.         active file.
  530.         
  531.         
  532.              New file
  533.              
  534.            Selecting this menu item will allow you to type the name of a
  535.         new C source file on upon which to begin work.  Do NOT enter the
  536.         name of a project (*.PRJ) file.  Again, if multiple files are
  537.         open, you will be asked to select the active file.
  538.         
  539.         
  540.              Switch
  541.            
  542.            Selecting this item will allow you to change the active file.
  543.             
  544.         
  545.              Edit
  546.             
  547.            Selecting this menu item will invoke your editor and load the
  548.         currently active file for editing.
  549.  
  550.                                      Page 9
  551.  
  552.  
  553.  
  554.  
  555.  
  556.         
  557.         
  558.              Close
  559.            
  560.            This option allows you to remove a file from the list of
  561.         open source files.  Type the number of the file you wish to
  562.         close in the dialog box.  If more than one file remains open,
  563.         you will be asked to designate a new active file.
  564.         
  565.         
  566.              All Close
  567.            
  568.            This option will remove ALL files from the open list.
  569.            
  570.            
  571.              Print
  572.            
  573.            This option allows you to print one or more files associated
  574.         with the current project.  In the dialog box that appears, press
  575.         "A" to print all source files, "I" to print the project #include
  576.         file (*.H), or the number of a single open file.  Next, you'll
  577.         be asked to specify which printer port (LPT1-3) to print to.
  578.         
  579.            If there is an error, PCS will inform you of the nature of the
  580.         problem and provide you with the opportunity of correcting it or
  581.         aborting the print operation.
  582.         
  583.         
  584.              Directory
  585.            
  586.            This option allows you to change the current working direc-
  587.         tory.  Enter a drive letter, directory, or complete path, as
  588.         appropriate, into the dialog box.  Any open files will be closed
  589.         upon changing directories.
  590.         
  591.         
  592.              Operations Menu
  593.              ========== ====
  594.              
  595.            Pressing the Alt-O key combination activates the Operations
  596.         pull-down menu, which contains the following options:
  597.         
  598.         
  599.              Compile
  600.            
  601.            Selecting this item invokes the Power C compile and compiles
  602.         the currently open source file(s).  Any compile options speci-
  603.         fied through the PCS configuration file or environment variables
  604.         will eb in effect for the compilation.
  605.         
  606.            The compile listing will appear on the screen and you will
  607.         have the opportunity to view it prior to return to PCS.  To pre-
  608.         vent the listing from scrolling off the screen, include the
  609.         #pragma pagesize preprocessor directive in your program source.
  610.  
  611.                                      Page 10
  612.  
  613.  
  614.  
  615.  
  616.  
  617.         
  618.         
  619.              Link
  620.            
  621.            The current project or source file will be linked, using the
  622.         options specified through the configuration file or environment
  623.         variable.  The executable file produced will have the same name
  624.         as the first open file, with the extension .EXE.
  625.         
  626.         
  627.              Header
  628.              
  629.            Selecting this option will invoke your editor and load the
  630.         project #include (*.H) file.  Using such a file is an easy way
  631.         to declare external variables by using the #include file in
  632.         supplementary project source code modules.
  633.         
  634.         
  635.              View C.ERR
  636.              
  637.            This option will invoke your viewer and allow you to see the
  638.         contents of the most recent compile listing (contained in the
  639.         C.ERR file generated by PC.EXE).
  640.         
  641.         
  642.              DOS Shell
  643.            
  644.            This option allows you to return momentarily to the DOS com-
  645.         mand line without exiting PCS 2.0.  A reminder will appear in
  646.         your prompt informing you to type "exit" to return to PCS.  
  647.         While you are in the DOS Shell, keep in mind that your total
  648.         free memory is reduced by approximately 130k.
  649.         
  650.         
  651.              Configuration Menu
  652.              ============= ====
  653.              
  654.            Pressing the Alt-C key combination will activate the Con-
  655.         figuration pull-down menu, which includes the following op-
  656.         tions:
  657.         
  658.         
  659.              Editor
  660.            
  661.            Selecting this option will allow you to enter the name of
  662.         your editor.  In the first dialog box, enter the complete path
  663.         and file name of your editor program.  In the second dialog box,
  664.         enter any command line parameters (switches) required by your
  665.         editor, if any.  The editor name and switches will then appear
  666.         on the appropriate line in the status area at the bottom of the
  667.         screen.
  668.         
  669.         
  670.              Viewer
  671.  
  672.                                      Page 11
  673.  
  674.  
  675.  
  676.  
  677.  
  678.            
  679.            This option allows you to configure your viewer program.
  680.         Follow the steps above for the editor, this time typing the
  681.         path and switches for the viewer.
  682.         
  683.         
  684.              Compile Options
  685.              
  686.            This option will allow you to select which switches are to be
  687.         used by the Power C compiler.  The PC.EXE file's help screen 
  688.         will be displayed and a small dialog box will appear at the bot-
  689.         tom of the screen.  Enter your choice into the box.
  690.         
  691.         
  692.              Link Options
  693.            
  694.            This menu choice will allow you to specify link options.  A
  695.         small help screen explaining the available switches will be
  696.         presented.  Enter your switch(es) in the dialog box.
  697.         
  698.         
  699.              Memory Allocations
  700.              
  701.            With this option you can control the size of the stack, heap,
  702.         and far heap of your program.  Enter values for each of these
  703.         items in the dialog box just as you would enter them on the com-
  704.         mand line.  For example, if you want 16k of memory for the stack
  705.         enter "16k"; if you want 800 bytes allocated for the heap, enter
  706.         "800."
  707.         
  708.         
  709.              Object Library
  710.            
  711.            Select this option to enter the name of an object file to be
  712.         linked as a library.  This can be a library of your own creation
  713.         or a third-party library.  Make use of the "?" wildcard to spec-
  714.         ify different library names for the three memory models.  For
  715.         example, PCS is linked with the library CJSLIBM.MIX, a library
  716.         of functions developed by Tay-Jee Software.  By entering the
  717.         name "CJSLIB?.MIX" as an object library, the files CJSLIBS.MIX,
  718.         CJSLIBM.MIX, or CJSLIBL.MIX will be linked depending upon which
  719.         memory model is in effect.  (See the Power C README file for a
  720.         further discussion of libraries and wildcards.)
  721.         
  722.         
  723.              Program Colors
  724.            
  725.            Selecting this option activates the program color selection
  726.         process.  Nine screen elements can have their screen attributes
  727.         individually configured.  Enter the number of the screen color
  728.         you wish to modify, then position the flashing star character
  729.         over the appropriate color combination, then press <Enter>.
  730.         Once you are through selecting colors, enter "0" instead of a
  731.         color number.  In the dialog box which appears, type N to put
  732.  
  733.                                      Page 12
  734.  
  735.  
  736.  
  737.  
  738.  
  739.         your newly selected colors into effect, O to ignore the new
  740.         colors and use the colors in currently in effect, or D to
  741.         revert to the program's default color scheme.
  742.         
  743.         
  744.              Quit
  745.              ====
  746.             
  747.            Select this option to leave Power C Shell and return to 
  748.         DOS.  Three options are available:  "Yes" exits PCS immediately;
  749.         "Save" updates the PCSHELL.CFG file with the current settings,
  750.         then returns to DOS; and "No" returns you to PCS.
  751.         
  752.         
  753.         HELP
  754.         
  755.            Context-sensitive help is available from within the PCS
  756.         menu system (only).  From the main PCS screen, or from within
  757.         any pull-down menu, pressing <F1> activates the help system.
  758.         A box will appear on the middle of the screen containing the
  759.         help information for the currently selected menu operation.
  760.         Use the cursor movement keys to scroll the help text up and
  761.         down through the box.  Pressing <Esc> returns you to PCS.
  762.         
  763.            A short help line appears for most dialog boxes in PCS.
  764.         Most "basic" editing functions, such as Insert/Delete and
  765.         Backspace work normally in dialog boxes.  In addition, the
  766.         <Tab> key can be used to DELETE all information in a dialog
  767.         box which lies to the right of the cursor.
  768.         
  769.         
  770.         This document formatted with MARGARINE 3.0ß, a utility program
  771.         I created using Power C 2.0.1 and Power C Shell.  Look for it
  772.         in IBM Systems/Utilities Forum (IBMSYS) on CompuServe (found
  773.         in the New Uploads or General Utilities Library as MARG*.ZIP).
  774.         
  775.         
  776.         
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.                                      Page 13