home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 5 / FreshFish_July-August1994.bin / bbs / dev / cpump-1.7.lha / CPump-1.7 / ReadMe.txt < prev    next >
Text File  |  1994-04-04  |  13KB  |  323 lines
  1.                    C P u m p
  2.  
  3. An Amiga Intuition-based C development environment.
  4.  
  5. © Copyright 1992, 1993, 1994, David A. Faught, All right reserved.
  6. This program is provided "as is", no warranties are made.
  7. All use is at your own risk. No liability or responsibility
  8. is assumed.
  9.  
  10. Several other products are mentioned in this document. Each
  11. trademark is owned by it's respective owner.
  12.  
  13. The right to freely distribute this program at no cost is
  14. hereby granted, as long all files listed below are included
  15. and all files included remain UNALTERED. These files may be
  16. included in a collection of freely distributable software,
  17. as long as the cost of that collection is previously deemed
  18. reasonable by the author. Fred Fish is specifically given the
  19. right to distribute these files.
  20.  
  21. The files included are:
  22.  
  23. -----rwed       1      961 Apr  4 21:42 CPump
  24. -----rwed      18    18340 Apr  4 21:42 CPump17
  25. -----rwed      26    26312 Apr  4 21:42 CPump17.c
  26. -----rwed      17    16636 Apr  4 21:42 CTags
  27. -----rwed      25    25179 Apr  4 21:42 CTags.c
  28. -----rwed       9     8428 Apr  4 21:42 CTagSel
  29. -----rwed       8     7290 Apr  4 21:42 CTagSel.c
  30. -----rwed       1      505 Apr  4 21:42 EdErr.rexx
  31. -----rwed       1      826 Apr  4 21:42 EdTag.rexx
  32. -----rwed      13    13137 Apr  4 21:47 ReadMe.txt
  33. Dirs:0    Files:10   Blocks:119   Bytes:117614
  34.   
  35. -----------------------------------------------------------
  36.  
  37. If you like this program, or would like to support my future
  38. developments, please send a monetary or Amiga hardware gift
  39. (not deductible) to:
  40.  
  41.     David Faught
  42.     8701 North 64th Street
  43.     Brown Deer, WI  53223
  44.  
  45. You will be added to my mailing list for a fee of $10
  46. or more, and will be notified of my future developments.
  47.  
  48.  
  49. This program requires AmigaDos 2.04 or better. It will not
  50. function at all with 1.3.
  51.  
  52.  
  53. I can also be contacted by email only (no files shipped please) at:
  54.    akcs.dfaught@vpnet.chi.il.us
  55.  
  56. ------------------------------------------------------------
  57. Version 1.7, April 1994
  58.  
  59. Enhanced some utilities so that their output is redirected to a
  60. temporary file that can be browsed.  Enhanced CTags so that it
  61. accepts an Amiga wildcard pattern as the input file(s) and
  62. Edtag.rexx to use this facility.  This will also work for ".cxx"
  63. and ".cc" files.  Upgraded GCC support so that it works with
  64. version 2.5.8 of C and C++.  Other little things here and there
  65. that I have forgotten about.
  66.  
  67. Version 1.6, January 1993
  68.  
  69. Several enhancements including EdTag facility, better environment
  70. variable handling, smaller CPump window to allow better view of
  71. shell window being driven. Also added the Amiga "E" compiler for
  72. the heck of it.
  73.  
  74. Version 1.5, January 1993
  75.  
  76. The Open and Save functions were fixed so that any number of
  77. selected files will be copied. Also added the keyboard equivalents
  78. for all the main functions and the ARexx Test tool.
  79.  
  80. Version 1.4, December 1992
  81.  
  82. The "CPump.env" environment variable was added to the CPump script
  83. and to the main program to select initial settings for the four
  84. cycle gadgets. These settings start with 0 (zero) and specify the
  85. element of each of the four cycle gadgets to initially display.
  86. The gcc (GNU C Compiler) and the Textra editor were added.
  87. I think there were a few other minor things fixed too.
  88.  
  89. Version 1.3, August 1992
  90.  
  91. This is to fix a bug with the "initcc" script. This did not work
  92. as distributed. Now you MUST edit the script file "CPump" for your
  93. environment and execute it to start up the program. The "initcc"
  94. script was replaced by this. It happens that this change actually
  95. makes it easier to run CPump from the WorkBench than from the
  96. shell.
  97.  
  98. Version 1.2, August 1992
  99.  
  100. I have added support for (old) version 4.0 of the SAS/Lattice
  101. C compiler. This may work for newer versions, too.  I did this
  102. mainly because I found it gathering dust in an old box of disks.
  103.  
  104. An icon and script for the AmigaDos IconX command now allow
  105. CPump to be run from the WorkBench.
  106.  
  107. I have changed the "Utility" gadgets to be a single list-type
  108. selector. Just click on the utility you want to use.
  109.  
  110. The zoom gadget in the upper right now "iconifies" the CPump
  111. window.
  112.  
  113. Running all commands is now done using the new "System()" call
  114. instead of the old "Execute()". This allows the proper return
  115. code to be displayed.
  116.  
  117. Source code is now included. You may make modifications for
  118. your own personal use only. The unregistered version of DICE
  119. along with the NDU from CATS will work to compile this program.
  120. I highly recommend registering DICE.
  121.  
  122. Various other minor modifications have been made.
  123.  
  124. Version 1.1
  125.  
  126. Not released.
  127.  
  128. Version 1.0
  129.  
  130. This little utility was born from my frustrations with
  131. using the CLI for compiling and testing my C programs. Even
  132. with the shell command history, it just seemed like too much
  133. trouble to remember the right commands and options,
  134. especially after one of my attempts would get the guru's boot
  135. and a reboot.
  136.  
  137. This program is an easy to use shell that invokes a number
  138. of other programs. These other programs are not included
  139. here, but are easily accessible in collections of freely
  140. distributable software for the Amiga. It is not necessary to
  141. have ALL of the programs listed here. For example, there is
  142. no real reason to use both the DICE and PDC compilers, but
  143. one or the other is required.
  144.  
  145. If you have them, this program will make use of:
  146.   ED & MEmacs text editors included with AmigaDos,
  147.   Dillon's Integrated C Environment (DICE) - including the
  148.     DME text editor and ANSI C compiler available on Fred
  149.     Fish disk 491,
  150.   Publicly Distributable C (PDC) - compiler and several
  151.     utilities with complete source available on Fred Fish
  152.     disk 351,
  153.   MuchMore - text display program available on Fred Fish
  154.     disk 560 (and several others in the :c directory),
  155.   CRef - C cross reference lister available on Fred Fish
  156.     disk 166,
  157.   Indent - provides consistent indentation of C source
  158.     available on Fred Fish disk 262.
  159.  
  160. It is also highly recommended that you get a copy of the
  161. Native Developer Update (NDU) from Commodore Amiga Technical
  162. Support (CATS) as it contains all the Amiga specific headers
  163. needed to take advantage of the great Amiga features. It
  164. also contains lots of examples, development tools,
  165. debugging tools, and the AutoDocs. Information on how to
  166. acquire the NDU is included with both PDC and DICE.
  167.  
  168.  
  169. --------------------------------------------------------
  170. INSTRUCTIONS:
  171.  
  172. This program can be used from the CLI or the Workbench. It
  173. must be started using the CPump script. When started from the
  174. Workbench, iconx is used to execute the CPump script.
  175. Consider the CPump script included to be a starting point
  176. that you should edit to reflect your own Amiga's environment.
  177. In particular, the directory containing either the DICE or PDC
  178. commands (or both) must be added to the command search path
  179. using the "path add" command.
  180.  
  181. When you run this program, it presents a window with a bunch
  182. of gadgets on it. These gadgets define the steps that I use
  183. when developing a C program, along with the tools used at
  184. each step and a few options. Down the left side of the window
  185. are 6 pushbuttons which execute the 6 development steps.
  186. Down the middle are some cycle gadgets which determine
  187. the tool to be used for each step. In a line across the
  188. middle are some boxes you can check to set certain options
  189. for the Compile step.
  190.  
  191. Select the tools you wish to use by clicking on the cycle
  192. gadgets on the right. You should probably do this first,
  193. before you attempt to execute any of the 6 steps on the
  194. left. Then, when you push any of the 6 pushbuttons to
  195. execute a step, a filerequester will appear so that you can
  196. select the file(s) you wish to use for that step.
  197.  
  198. Some steps allow multiple files to be selected, and other
  199. steps only allow a single file. Sometimes, the filerequester
  200. will have a pattern selector that filters the files you see
  201. to include only those with certain suffixes. You can edit
  202. this selection pattern on the filerequester, if you wish.
  203.  
  204. When you have selected the file(s) for that step, push the
  205. "OK" button on the filerequester. The tool that you have
  206. selected for that step will be executed with the file(s)
  207. you have selected. Pretty simple, huh? You can also double-
  208. cli