home *** CD-ROM | disk | FTP | other *** search
/ Dr. Reference / dr_ref.zip / dr_ref / OS2_PROG / PMDVL2.ZIP / dvl.hlp (.txt) < prev    next >
OS/2 Help File  |  1991-09-30  |  6KB  |  183 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. PM Developer ΓòÉΓòÉΓòÉ
  3.  
  4. PM Developer provides a presentation manager interface for building and testing 
  5. programs. 
  6.  
  7. PM Developer interfaces with existing compilers and debuggers. 
  8.  
  9. It is important to note that the build and test processes operate solely within 
  10. the environments specified within PM Developer. That is, environments defined 
  11. in the config.sys are not used. (Except for LIBPATH, of course) This is to 
  12. facilitate easier switching between development environments. Each development 
  13. environment is stored in a user named profile. Within each profile, there is an 
  14. environment for the build process and another for testing. This allows the 
  15. developer to quickly imitate other environments for testing purposes. 
  16.  
  17. PM Developer Windows: 
  18.  
  19.  Build Window 
  20.  
  21.  Test Window 
  22.  
  23.  Status Window 
  24.  
  25.  Setup Window 
  26.  
  27.  PM Developer Hints: 
  28.  
  29.  Setup Problems 
  30.  
  31.  Building Programs 
  32.  
  33.  
  34. ΓòÉΓòÉΓòÉ 2. PM Developer Configuration ΓòÉΓòÉΓòÉ
  35.  
  36. This dialog configures the overall behavior and process wide variables used by 
  37. PM Developer. 
  38.  
  39.  Output text editor specifies the editor to be used in reviewing the output 
  40.  results file from the build interface. 
  41.  
  42.  Review build results output text upon completion automaticaly invokes the 
  43.  output text editor with the results of a build upon it's completion. 
  44.  
  45.  Delete build results output text on exit causes all results files accumulated 
  46.  during the current PM Developer process to be deleted upon termination of PM 
  47.  Developer. Note that only files created while this option is enabled are 
  48.  deleted. 
  49.  
  50.  Delete entry from status list upon completion removes the record of the build 
  51.  from the status window when the build is completed. 
  52.  
  53.  Save window aesthetics on exit remembers the size and position of all windows 
  54.  when PM Developer is terminated. Upon the next invocation, these sizes and 
  55.  positions will be restored. 
  56.  
  57.  
  58. ΓòÉΓòÉΓòÉ 3. Build Configuration ΓòÉΓòÉΓòÉ
  59.  
  60. This dialog configures the variables and environment used in the build process. 
  61.  
  62.  Build utility name specifies the executable or command file invoked for 
  63.  building programs. For example, MAKE for IBM C/2. Specify only the file name. 
  64.  This file must reside along the PATH environment variable specified in the 
  65.  Environment dialog. 
  66.  
  67.  Note:  Since only output directed to stdout is collected by PM Developer, any 
  68.  build utility options that re-direct stderr to stdout should be used. 
  69.  
  70.  (Parameters) Ship are passed to the build utility when the Ship button is 
  71.  pressed on the Build Window. This parameter is normally used to define build 
  72.  utility macros with non-debugging values. 
  73.  
  74.  (Parameters) Debug are passed to the build utility when the Debug button is 
  75.  pressed on the Build Window. This parameter is normally used to define build 
  76.  utility macros with debugging values. For example, "lflag=/CO". 
  77.  
  78.  Input build control directory specifies the directory PM Developer will search 
  79.  for files to populate the Build Window. 
  80.  
  81.  Build control file extension specifies the search mask PM Developer will use 
  82.  to determine which files are make files. 
  83.  
  84.  Output text directory specifies the directory in which PM Developer will place 
  85.  build results files. 
  86.  
  87.  Environment is used to configure the environment in which the build utility 
  88.  will run. 
  89.  
  90.  
  91. ΓòÉΓòÉΓòÉ 4. Test Configuration ΓòÉΓòÉΓòÉ
  92.  
  93. This dialog configures the variables and environment used in the testing 
  94. process. 
  95.  
  96.  Debugger specifies the debugger to be invoked. For example, CVP for IBM C/2. 
  97.  Specify only the file name. This file must reside along the PATH environment 
  98.  variable specified in the Environment dialog. 
  99.  
  100.  Debugger parameters are passed to the debugger for debugger specific 
  101.  functions. 
  102.  
  103.  Executable parameters are passed to the specified program. These are passed in 
  104.  both debugging and non-debugging runs. 
  105.  
  106.  Executable directory specifies the directory PM Developer will search for 
  107.  files to populate the Test Window. Only files with an extension of EXE are 
  108.  selected. 
  109.  
  110.  Environment is used to configure the environment in which the program will 
  111.  run. 
  112.  
  113.  
  114. ΓòÉΓòÉΓòÉ 5. Environment Configuration ΓòÉΓòÉΓòÉ
  115.  
  116. This dialog configures the variables and environment used in the testing 
  117. process. It displays all of the environment names defined for the Build or Test 
  118. sessions. 
  119.  
  120. Note that no validation is performed on the values of these variables. 
  121.  
  122. Note that all environment changes are commited when an OK button is pressed. 
  123.  
  124.  Edit is used change the value of an existing variable. 
  125.  
  126.  Add is used to add a variable. It should then be edited to define it's value. 
  127.  
  128.  Delete deletes a variable. 
  129.  
  130.  
  131. ΓòÉΓòÉΓòÉ 6. PM Developer Profiles ΓòÉΓòÉΓòÉ
  132.  
  133. This dialog manages the development profiles. There will usually be one for 
  134. each source "directory" used for development. 
  135.  
  136.  Open resets all environment configurations. 
  137.  
  138.  Copy copies the open profile to one specified by the user. 
  139.  
  140.  Delete deletes a profile. 
  141.  
  142.  
  143. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  144.  
  145. The Build window provides a list of make files eligible for building. These are 
  146. provided based on the parameters specified in the build configuration accessed 
  147. from the PM Developer control panel. 
  148.  
  149.  
  150. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  151.  
  152. The Test window provides a list of executable files that can be started from 
  153. the PM Developer. These are provided based on the parameters specified in the 
  154. build configuration accessed from the PM Developer control panel. 
  155.  
  156.  
  157. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  158.  
  159. Status provides a list of active and completed build sessions. From this 
  160. window, sessions may be stopped, output from the build may be reviewed and 
  161. deleted. 
  162.  
  163.  
  164. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  165.  
  166. Setup is used to configure the PM Developer processes. This is the brains of PM 
  167. Developer. 
  168.  
  169.  
  170. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  171.  
  172. The most common problem in setting up PM Developer for the first time or 
  173. configuring new environments is the PATH environment variable. If a build 
  174. session ends and the results output is either empty or ends suddenly, PM 
  175. Developer couldn't find a program specified in either the make file or the PM 
  176. Developer set up. 
  177.  
  178.  
  179. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  180.  
  181. Code the /BATCH parameter on the link statement. If the linker can't find 
  182. something it will fail rather than sit in the background waiting for you to 
  183. type a response.