home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 2 / crawlyvol2.bin / program / pascal / pascalm / pascalm.doc < prev    next >
Encoding:
Text File  |  1988-04-25  |  11.6 KB  |  265 lines
  1.  
  2.  
  3.                      Alternative Personal Pascal Manger
  4.  
  5.                                Jinfu Chen
  6.                                Jan. 1988
  7.                 (Enhancement Apr. 1988 - Phillip R. Poulos)          
  8.  
  9.     1. What is it for
  10.  
  11.         PASCALM is an alternative manager program for OSS Personal Pascal. It
  12. combines the useful features in both Personal Pascal v1.x and v2.0 and has some
  13. more useful features. It does NOT use the Personal Pascal v2.x file selector
  14. box, but calls GEM for any file selection. If you have replaced GEM's file
  15. selector box with your own, this manager will work nicely with it.
  16.  
  17.         Refer to Personal Pascal manual page 2-1(version 2) or page 1-1(version
  18. 1) for further details about manager program.
  19.  
  20.  
  21.  
  22.     2. Installation
  23.  
  24.         Copy PASCALM.PRG and PASCALM.RSC to a disk. The file PASCALM.PRG can be
  25. renamed to whatever name you like, for example, PASCAL.PRG. However, do not
  26. change the name of PASCALM.RSC to anything else except this name.
  27.  
  28.  
  29.  
  30.     3. Using the Manager
  31.  
  32.         Double click PASCALM.PRG from DESKTOP, a title box will appear for
  33. short time and zooming out by itself. The menu has four entries:
  34.  
  35.         Desk   File  Options  Specials
  36.  
  37.         Each entry has more options to be choosed from, see following sections.
  38.  
  39.  
  40.  
  41.     4. Desk menu
  42.  
  43.         This menu has one entry for the program, Pascal Manager, which is a
  44. title box shows version, author name, and copyright notice. Other entries may
  45. exist depending on wether you have any desktop accessory installed.
  46.  
  47.  
  48.  
  49.     5. File menu
  50.  
  51.         This menu has five entries, same as in Personal Pascal. The only excep-
  52. tion is when a TTP (TOS Take Paramter) type program is run, a dialog box will
  53. appear to allow you enter command. Such as running ARC.TTP, one can enter:
  54.  
  55.                        vh foo.arc
  56.  
  57. to view file information in foo.arc.
  58.         Each of the entries can also be selected from the keyboard as follows:
  59.               ^E or Alt-E - run the editor, passing the last file edited
  60.               ^C or Alt-C - run the compiler, passing the last file compiled
  61.               ^L or Alt-L - run the linker, passing the last file linked
  62.               ^R or Alt-R - run the last program compiled and linked.
  63.         The file selector box will appear if there is no appropriate file to
  64. run/link/compile/edit, etc. (for example, if this is the first edit command as
  65. the program starts out).              
  66.  
  67.  
  68.  
  69.     6. Options menu
  70.  
  71.         This menu has five entries:
  72.  
  73.         Compiler Options...
  74.         Linker Options...
  75.         Locate Program...
  76.         Load Options...
  77.         Save Options...
  78.  
  79.     6.1 Compiler Options
  80.  
  81.         In the Compiler Options, a box similar to the one in Personal Pascal
  82. version 1.x will appear. Most of them are explained in Personal Pascal manual
  83. (page 2-4 in V2.0, page 3-4). Three options need to be explained here.
  84.  
  85.     No Object Code:
  86.  
  87.         When this option is on, no object file (.O file) is generated. This is
  88. handy for debugging when compiling a program which may contain errors. This is
  89. equivalent to the /NOCODE switch in command line (see Personal Pascal version 2
  90. manual page 8-22).
  91.  
  92.         Note that when this option is on, the 'Chain to linker' option can not
  93. be selected. You will need to toggle off the 'No object code' option before
  94. selecting the 'Chain to linker' option.
  95.  
  96.     Auto backup:
  97.  
  98.         When this option is on, the manager will copy the last source file
  99. edited to a path being defined by the 'Backup Path' box, after a successful
  100. compilation has occurred.
  101.  
  102.         This is very useful if you are using a RAM disk or hard drive to
  103. program. In such environment, very often programmers rush to run a program
  104. after it is compiled to see if it works, before saving the source file to
  105. a permanent disk or other pertition of the hard drive. If the program crashes,
  106. chances are you will lose the source file, even with some 'reset-proof' RAM
  107. disk. In case of hard drive, if your program trys to write to the disk and mess
  108. up the pertition you are working on it, you will not able to recover the file
  109. also.
  110.         The auto backup path has to be in standard TOS path. For example, these
  111. are legal TOS path:
  112.  
  113.         A:\, A:\SOURCE\, D:\PASCAL\SRC\ARCHIVE\
  114.  
  115.         For users who still using Personal Pascal version 1.x, the temporary
  116. path is not available in this program. However, since you can place all the
  117. overlay programs and libraries in different place, this can be overcome. See
  118. Section 6.3 for information.
  119.  
  120.     Compile file last edited when chained:
  121.     
  122.         The Personal Pascal editor (as well as others, like TEMPUS) can chain
  123. to the compiler when the editing is through. With this option selected, the
  124. name of the file just edited will be passed to for compilation. If this option
  125. is NOT selected, the file name of the last file compiled (NOT edited) will be
  126. passed to the compiler, regardless of what was just edited. This feature is
  127. useful when working with large programs with several parts. You can edit any
  128. individual part you want, but still start the compilation with the main program
  129. file or module. Also note that the Auto_Backup feature will still save the last
  130. file edited, NOT compiled (though they may be one in the same).
  131.  
  132.     6.2 Linker Options
  133.  
  134.         This is very similar to Personal Pascal's, except you can choose the
  135. type of program to be generated. You can choose from GEM, ACC, TOS, or TTP.
  136. Note that the default type is related to the one in Compiler Options so if you
  137. already select GEM in Compiler Options, you do not need to select the one in
  138. Linker Options, and vise versa.
  139.  
  140.         Note that the ACC option in both compiler and linker does not work
  141. under version 2.00 of Personal Pascal Compiler. Consult with OSS/ICD to obtain
  142. version 2.02 or higher if this function is necessary to you.
  143.  
  144.     6.3 Locate Programs
  145.  
  146.         This is exactly the same as the one in Personal Pascal version 2. You
  147. can tell the manager where is your editor overlay program, or the compiler,
  148. linker, as well as the PASLIB, GEMLIB libraries. This allows you to place files
  149. more flexible and use your favor editor. Caustion should be made if you are
  150. using TOS or TTP type of editor, you will need to name the program extension
  151. properly so that the manager will handle the cursor correctly. For example, the
  152. editor program in Personal Pascal version 1.x is actually a TTP program. It has
  153. to be renamed to EDITOR.TTP and use the 'Locate Programs' option to locate it,
  154. otherwise, a cursor will remain on the screen. GEM type editor can be used as
  155. well, such as 1st Word, or the GEM editor comes with Personal Pascal version 2.
  156.  
  157.         It is recommented use 'Locate Programs' option to find all the files
  158. when first time using the manager and save the options to the .INF file(see
  159. Section 6.5).
  160.  
  161.     6.4 Load Options
  162.        This option allows you to load a new configuration file without exiting
  163. the Personal Pascal Manager. A file selector box allows you to chose the ".INF"
  164. file to load, replacing all currently selected configurations.
  165.        
  166.     6.5 Save Options
  167.  
  168.         This option allows you save all the current configurations to a file.
  169. A file selector box prompts you for the filename and pathway, with the default        
  170. PASCALM.INF given. When next time the manager program is run it will look for
  171. a file called PASCALM.INF in the default directory to restore the options you
  172. have saved. Note that this .INF file has different format from the PASCAL.INF
  173. generated by Personal Pascal Manager, do not just rename the file.
  174.  
  175.  
  176.  
  177.     7. Specials menu
  178.  
  179.         This menu has quite a few entries related to disk operations. These
  180. include:
  181.  
  182.         Copy Files...       F1
  183.         Create Folder...    F2
  184.         Rename/Move File... F3
  185.         Disk Space...       F4
  186.         Print Listing...    F5
  187.         Delete File...      F6
  188.         Delete Folder...    F7
  189.  
  190.     7.1 Copy Files - called from the menu or by pressing F1
  191.  
  192.         This allows copy file from one disk/folder to anther disk/folder, or
  193. just duplicate the file with different name. A message box will appear on top
  194. of the Item Selector to tell you what file you are selecting for. A file name 
  195. conflict box will appear, prompting you for a new name if the file name you
  196. are copying TO already exists. You can, of course, over write that file is you
  197. chose. An error will occur if you try to copy the file to itself, or disk is
  198. write-protected, much as same as the DESKTOP.
  199.  
  200.     7.2 Create Folder - called from the menu or by pressing F2
  201.  
  202.         With this you can create a folder in any directory. The file selector
  203. box will prompt you for a unique name for the new folder.
  204.  
  205.     7.3 Rename/Move File - called from the menu or by pressing F3
  206.  
  207.         This allows you rename a filename to another. You can even move a file
  208. from one folder to another by just renaming it. GEMDOS will normally only allow
  209. this function to occur within the same disk drive.  But as an additional feature
  210. not normally provided by GEMDOS, you can move a file between disk drives.  This
  211. convenience feature is accomplished by copying the file first to the new drive,
  212. then deleting the old file.  A file conflict box will appear if a file already
  213. exists with the name of the file to be moved. You can write over a preexisting
  214. file ONLY if you are moving a file between drives or between folders on the
  215. same drive; otherwise GEMDOS will give give you an error if you try such a move.
  216.  
  217.  
  218.     7.4 Disk Space - called from the menu or by pressing F4
  219.  
  220.         This allows you check how much free space in a disk drive. A dialog box
  221. will appear asking for a disk drive id. Either enter the drive ID in UPPER CASE
  222. or press the left button over the left or right arrows to change the selected
  223. drive ID. Click the OK button or just hit return key to get the information you
  224. requested. You can check the free space in as many drives as you like. Click on
  225. the CANCEL box to leave. An error will occur if a non-existent drive ID is
  226. entered.
  227.  
  228.     7.5 Print Listing - called from the menu or by pressing F5
  229.  
  230.         This allows you to send a source file to printer. You can choose your
  231. favor printing program to add line numbers or format the file providing that
  232. program does not require a resource file to run. "LISTPAS.PRG" provided with
  233. Personal Pascal Version 2.x runs nicely with this.
  234.  
  235.     7.6 Delete File - called from the menu or by pressing F6
  236.  
  237.         Remove a file from the disk. Use with caution, once it is gone, it is
  238. gone for ever. And there is NO second prompt. Once you complete the file
  239. selection, the file is deleted!
  240.  
  241.     7.7 Delete Folder - called from the menu or by pressing F7
  242.  
  243.         This command will delete a folder AND all of its contents, regardless
  244. of whether it contains write protected files or not. USE THIS COMMAND CAU-
  245. TIOUSLY. When executed, you will be prompted for the PATH to the folder to be
  246. deleted, not the actual folder (or file) name. The command ignores the file
  247. name returned from the file selecter box! This was done so that you could click
  248. on the folder to be deleted without having to use the keyboard to enter the
  249. information in. The command will then prompt you again with the folder name to
  250. make sure you want to deleted it. Clicking OKAY deletes everything. Good luck!
  251.  
  252.     8. Conclusion
  253.  
  254.         The manager program has features to help programmers. New features can
  255. be added on request. Bug report and suggestions should be sent to:
  256.  
  257.  
  258.         Jinfu Chen
  259.         445 S. Dobson Rd., #2022             (602)898-5338 (work)
  260.         Mesa, AZ 85202                       (602)834-7061 (home)
  261.  
  262.         CompuServe 72327,2434
  263.         GEnie      J.Chen
  264.  
  265.