home *** CD-ROM | disk | FTP | other *** search
/ Software of the Month Club 1995 March / SOFM_Mar1995.bin / pc / os2 / alphal / alpha.hlp (.txt) < prev    next >
OS/2 Help File  |  1995-01-27  |  94KB  |  773 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Description ΓòÉΓòÉΓòÉ
  3.  
  4.           (C) Copyright International Business Machines Corporation 1993.
  5.                                 All rights Reserved.
  6.  
  7.                                   Augustus MMDCCXLV AUC
  8.  
  9.  
  10.                           IBM United Kingdom Laboratories Ltd.
  11.  
  12. This is a simple 32-bit configurable multi-document highlighting editor version 
  13. of the software analysis programmes which were written together with the CMS 
  14. programme ANALYSE in order to establish the pr╨ícognita for the CICS restructure 
  15. project. This version has been written using C Set/2 and MASM V6.0. The 
  16. programme 'ALPHA.EXE' should be copied to an OS/2 V2.x directory. The Alpha 
  17. Fonts may be used if the file 'ALPHA.FON' is copied to an OS/2 V2.x directory 
  18. and installed. 
  19.  
  20. provides basic browse and edit functions, will invoke the appropriate compiler, 
  21. display the programme call structure, cross-reference labels, highlight 
  22. keywords and expand the procedure calls in a secondary window for language 
  23. types :- A37,ASM,PAS,(PLS,PLX,PLI),(C,CPP,H),FOR,IPF,.. 
  24. {Other languages or file extensions may be defined.} 
  25.  
  26. The syntax of Alpha is :- 
  27.  
  28.  START ALPHA [file] [/p [profile name - default ALPHA.PRF]]
  29.  
  30. A file may be opened from the Allocate menu or by dragging mouse button 2 with 
  31. the Ctrl key pressed from a Drives window on to the Alpha window. The mouse 
  32. buttons may be used to isolate a string and to search for the string within the 
  33. file. Browse commands may also be entered from the command window. 
  34.  
  35. The Language_colour, Language_operator, Precedent_C, File_type, Comment_start, 
  36. Comment_end, Transfer_pgm and Window keywords are the only ones which are 
  37. recognized from the Profile. 
  38.  
  39.  
  40. ΓòÉΓòÉΓòÉ 2. Installation ΓòÉΓòÉΓòÉ
  41.  
  42. The minimum requirement is to transfer the binary file 'ALPHA.EXE' to a 
  43. directory on your PS/2. 
  44.  
  45. If you want different highlight colours etc. you can edit the file 'ALPHA.PRF' 
  46. and specify the parameter /p. 
  47.  
  48. You can also install the 'Alpha' fonts by transferring the binary file 
  49. 'ALPHA.FON' to a directory on the PS/2 and selecting 'System Setup' from 'OS/2 
  50. System' and using 'Add' in the 'Edit font' of the 'Font Palette'. 
  51.  
  52. If you wish to access files from the host then you should also install a 
  53. Transfer_pgm such as ALMCOPY. 
  54.  
  55. If you wish to access the OS/2 help file, ALPHA.HLP, it must be installed in 
  56. the HELP path, e.g. the C:\OS2\HELP directory. 
  57.  
  58.  
  59. ΓòÉΓòÉΓòÉ 2.1. Parse exit module ΓòÉΓòÉΓòÉ
  60.  
  61. An optional procedure may be provided in a DLL which will be called when the 
  62. child window text is being written. 
  63.  
  64. If the DLL, ALPHAE.DLL, has been provided in the LIBPATH then the procedure 
  65. Alpha_parse_exit will be called from the WM_PAINT child window call. 
  66.  
  67. A sample source module ALPHAE.C is provided which may be used to create a DLL 
  68. with a parser exit module. The text can be written out by the DLL module if it 
  69. has been provided in the LIBPATH. 
  70.  
  71.  
  72. ΓòÉΓòÉΓòÉ 3. Menu ΓòÉΓòÉΓòÉ
  73.  
  74. The following menu items are available :- 
  75.  
  76. Item        Description 
  77.  
  78. Allocate    Will invoke the Allocate. dialogue box which may be used to open a 
  79.             file, invoke the Transfer programme or save the profile name. 
  80.  
  81. Command     Will create the command dialogue box which may be used to issue a 
  82.             search command. 
  83.  
  84. Options     Will allow the following options to be set :- 
  85.             Statement No., Tab, Keyword, Include, Grid, Box, Tool bar. 
  86.  
  87. Print       Will invoke the print dialogue box. 
  88.  
  89. Window      Will invoke the window selection dialogue box. 
  90.  
  91. Configure   Will invoke the Configure Notebook. 
  92.  
  93. Help        Will invoke the About dialogue box, the Help summary window, and 
  94.             the OS/2 extended help function. 
  95.  
  96.  
  97. ΓòÉΓòÉΓòÉ 3.1. Allocate ΓòÉΓòÉΓòÉ
  98.  
  99. The Allocate dialogue box may be used to request a file to be read. If the 
  100. drive letter is changed then the OK button should be used to refresh the List 
  101. boxes. {The maximum number of child windows is 16.} 
  102.  
  103. The Profile button will remember the file name entered in the COMBO box as the 
  104. profile for subsequent invocations. {This will obviate the need for the '/p' 
  105. parameter and enable a file to be dropped on to the unstarted programme.} 
  106.  
  107. The Transfer button will pass the contents of the Combo box to the 
  108. Transfer_pgm. {The data is passed to the Transfer_pgm unmodified.} 
  109.  
  110.  
  111. ΓòÉΓòÉΓòÉ 3.2. Command ΓòÉΓòÉΓòÉ
  112.  
  113. The Command dialogue box may be used to issue a search command e.g. 
  114.  
  115. o Case sensitive search for a string. 
  116.  
  117. o Case sensitive search for a string in column one. 
  118.  
  119. o A non-case sensitive search for a string, { Normal }. 
  120.  
  121. o Move to a given line number, { Goto }. 
  122.  
  123. o Replace the text at the current cursor position with the text from the 
  124.   Replacement Text Entry Box. 
  125.  
  126. The search starts from the current cursor position +1. 
  127.  
  128. The COMBO box will hold the previous three search strings which were 
  129. successfully entered. 
  130.  
  131.  
  132. ΓòÉΓòÉΓòÉ 3.3. Options ΓòÉΓòÉΓòÉ
  133.  
  134. The Options menu may be used to set the following options :- 
  135.  
  136. Option            Description 
  137.  
  138. Statement No.     Display the statement number in the TITLE bar followed by the 
  139.                   last character position from mouse button 1. 
  140.  
  141. Tab               Expand the record by using X'09' characters to round to 
  142.                   columns n*8. 
  143.  
  144. Keyword           Highlight the keywords. 
  145.  
  146. Include           For the files MASM, PAS, PLS, C read the include files 
  147.                   specified by :- include file_name, {$INCLUDE : 'file_name' }, 
  148.                   %INCLUDE first_part_of_file_name;, #include <file_name>, 
  149.                   respectively when expanding a call etc. 
  150.                   {The current directory together with the paths defined by the 
  151.                   INCLUDE environment variable will be searched. The total 
  152.                   number of open files/windows is limited to 16 so the include 
  153.                   nesting can not exceed 16-the number of open windows. For 
  154.                   language 4, PL/S, the file extension is appended to the 
  155.                   first_part_of_file_name. } 
  156.  
  157. Grid              Draw vertical grid lines through every tenth character in 
  158.                   Grid colour. 
  159.  
  160. Box               Switch the select area to a box format. 
  161.  
  162. Tool bar          Display the Tool bar. 
  163.  
  164.  
  165. ΓòÉΓòÉΓòÉ 3.4. Print ΓòÉΓòÉΓòÉ
  166.  
  167. The Print dialogue box will allow you to print the specified record range or 
  168. the highlighted area in the active window to one of :- 
  169. LPT1, LPT2, LPT3. 
  170. The default record range is the whole file. 
  171.  
  172.  
  173. ΓòÉΓòÉΓòÉ 3.5. Window ΓòÉΓòÉΓòÉ
  174.  
  175. The Window menu will give access to the following :- 
  176.  
  177. Item            Description 
  178.  
  179. Cascade         Will arrange the child windows so that the title text is 
  180.                 visible. 
  181.  
  182. Tile            Will arrange the child windows so that a partial view of each 
  183.                 child may be seen. 
  184.  
  185. Close All       Will close all child windows. 
  186.  
  187. Select Window   Will show the selected window. 
  188.                 {If the window title is selected from the List box then that 
  189.                 child window will become the active/visible one.} 
  190.  
  191. File name       The first six child windows may be selected to become the top 
  192.                 child window. 
  193.  
  194.  
  195. ΓòÉΓòÉΓòÉ 3.6. Configure ΓòÉΓòÉΓòÉ
  196.  
  197. The Configure Notebook may be used to modify the text colour, the text font or 
  198. configure the Tool bar; it contains the following pages :- 
  199.  
  200.  1. C  - Set the text colours. 
  201.  
  202.  2. F  - Set the text font. 
  203.  
  204.  3. T  - Configure the Tool bar. 
  205.  
  206.  
  207. ΓòÉΓòÉΓòÉ 3.6.1. Font ΓòÉΓòÉΓòÉ
  208.  
  209. The Font dialogue box, which may be chosen from the Configure Notebook page F, 
  210. may be used to change and remember the font. Outline fonts are not selectable. 
  211.  
  212. The Alpha fonts may be used if they have been installed. 
  213.  
  214.  
  215. ΓòÉΓòÉΓòÉ 3.6.1.1. Fonts ΓòÉΓòÉΓòÉ
  216.  
  217. A monospaced font with point sizes 8,9,10,11,16 & 20 is supplied with the ALPHA 
  218. PACKAGE, which may also be used. The Alpha font will be selected by default or 
  219. may be chosen from the Configure Notebook page F . 
  220.  
  221. To instal the Alpha fonts on OS/2 V2.x select 'System Setup' from 'OS/2 System' 
  222. and use 'Add' in the 'Edit font' of the 'Font Palette'. 
  223.  
  224. The font point sizes (1/72") are :- 
  225. Courier (8,10,12), Roman (8,10,12,14,18,24), Helvetica (8,10,12,14,18,24), 
  226. System (8,10,12, {8x8, 8x16, 9x20}), "Alpha" (8{8x12}, 9{9x10}, 10{8x14}, 
  227. 11{11x12}, 16{12x16}, 20{12x20}). 
  228.  
  229.  
  230. ΓòÉΓòÉΓòÉ 3.6.2. Colours ΓòÉΓòÉΓòÉ
  231.  
  232. The colours of the text, comments etc. may be changed and remembered by using 
  233. this dialogue box. The following colours may be changed :- 
  234.  
  235.  1. Text - The main text colour. 
  236.  
  237.  2. Highlight - The mouse button 1 isolate keyword colour. 
  238.  
  239.  3. Locate/Position - The mouse button 2 locate string, the character position 
  240.     of the last mouse button 1 click and the Structure List box procedures. 
  241.  
  242.  4. Comment/statement# - The Comment colour, statement number and Structure 
  243.     List box calls. 
  244.  
  245.  5. Background - The main text background colour. 
  246.  
  247.  6. Branch - The Branch/Jump instruction colour. 
  248.  
  249.  7. Grid - The vertical grid line colour. 
  250.  
  251.  8. Select area - The mouse button 1 drag area colour. 
  252.  
  253.  9. Help balloon - The Tool bar Help balloon background colour. 
  254.  
  255. 10. Comment background - The comment background colour. 
  256.  
  257.  
  258. ΓòÉΓòÉΓòÉ 3.6.3. Configure Tool bar ΓòÉΓòÉΓòÉ
  259.  
  260. The Configure Tool bar dialogue box, page "T" of the Configure Notebook, may be 
  261. used to Delete or Add buttons to the Tool bar and to change its size and 
  262. orientation. The Configure Notebook may be invoked from the main window menu. 
  263.  
  264. o The Buttons List box contains the available buttons; one should be selected 
  265.   and the Add button pressed to add it to the Tool bar. {The text of the 
  266.   Buttons already in the Tool bar is displayed halftone}. 
  267.  
  268. o The Tool bar List box shows the current list of buttons in the Tool bar; one 
  269.   should be selected and the Delete button pressed to remove it. 
  270.  
  271. o The Entry box displays the current button size which may be changed. 
  272.  
  273. o The Horizontal and Vertical Radio buttons will cause the Size Entry box to be 
  274.   read and the floating Tool bar to be reconstructed. 
  275.  
  276. o The Menu Radio button will cause the Tool bar to be placed in a menu bar the 
  277.   next time Alpha is started. 
  278.  
  279. o The Configure button will cause the changes to be applied. 
  280.  
  281. o The Cancel button will cause the changes to be ignored. 
  282.  
  283. The new Tool bar structure will be remembered when Alpha is closed. If the Tool 
  284. bar is changed from floating to menu then Alpha should be closed and restarted. 
  285.  
  286.  
  287. ΓòÉΓòÉΓòÉ 3.7. Help ΓòÉΓòÉΓòÉ
  288.  
  289. The Help menu will display the About, box the Help summary window or access the 
  290. OS/2 help file ALPHA.HLP via Extended. 
  291.  
  292.  
  293. ΓòÉΓòÉΓòÉ 3.7.1. Help window ΓòÉΓòÉΓòÉ
  294.  
  295. This window may be invoked by the F1 key or by selecting the Help item from the 
  296. Help menu item. The window may be scrolled by :- 
  297.  
  298.  1. Page_up - scroll up 1 window 
  299.  
  300.  2. Page_down - scroll down 1 window 
  301.  
  302.  3. Home - scroll to the top of the Help data 
  303.  
  304.  4. End - scroll to the end of the Help data 
  305.  
  306.  5.  - scroll down one line 
  307.  
  308.  6.  - scroll up one line 
  309.  
  310. The Extended help data may be accessed from the Extended item of the Help menu. 
  311.  
  312.  
  313. ΓòÉΓòÉΓòÉ 4. Function keys ΓòÉΓòÉΓòÉ
  314.  
  315. The mouse button 1 will highlight a string and mouse button 2 will cause a case 
  316. sensitive search for this string from the current cursor position +1, {if the 
  317. Ctrl key is held down the search is non-case sensitive}. If the Ctrl key is 
  318. held down when mouse button 1 is clicked then the current line may be edited. 
  319. If mouse button 1 is clicked twice on a label then a search from the top of the 
  320. file is made for the label definition or procedure entry and a secondary window 
  321. is opened, Expand. {The language structure tables are searched first so if you 
  322. have specified some structure keywords via Language_operator then you will have 
  323. to record the structure first, Ctrl+s.} 
  324.  
  325. If mouse button 1 is clicked twice on a  BEGIN for PASCAL, DO for PLS or { for 
  326. C then the code up to the following END etc. will not be displayed. These lines 
  327. may be restored by double clicking on the suppressed line, or by F12. 
  328.  
  329. If button 1 is clicked twice on an Include statement when the Include option is 
  330. selected then a second window will be created with the include file. 
  331.  
  332. The mouse button 1 may be used to scroll and select a section of the file. 
  333.  
  334. F1 will open the Help window. 
  335.  
  336. F2 will open the Configure Notebook. 
  337.  
  338. F3 will terminate the programme. 
  339.  
  340. F4 will open the Allocate or file dialogue box. 
  341.  
  342. F5 will repeat the previous command. 
  343.  
  344. F6 will open the Command dialogue box. 
  345.  
  346. F7 will scroll the window up 1/2 a window. 
  347.  
  348. F8 will scroll the window down 1/2 a window. 
  349.  
  350. F12 will reset the Collapse of BEGIN/END pairs etc. and place the cursor at the 
  351. top left in the window. 
  352.  
  353. Page_Up will scroll up 1 window. 
  354.  
  355. Page_Down will scroll down 1 window. 
  356.  
  357. Home will scroll to the top of the file. 
  358.  
  359. End will scroll to the end of the file. 
  360.  
  361. Enter will repaint the current child window, and reset the cursor to the 
  362. leftmost position. 
  363.  
  364.  - will scroll down one line 
  365.  
  366.  - will scroll up one line 
  367.  
  368.  - will scroll right one column 
  369.  
  370.  - will scroll left one column 
  371.  
  372. Note:  Hold the Shift key down to select an area with the arrow keys. 
  373.  
  374. The Tab key will advance the cursor to the next tab position, (8n). 
  375.  
  376. The Tab+Shift keys will reset the cursor to the leftmost position; before the 
  377. start of the line. 
  378.  
  379. The Insert key will toggle the Insert/Overwrite mode for modifying characters 
  380. in the Child window at the current cursor position. 
  381.  
  382. The Insert+Shift keys will insert records from the Clipboard at the current 
  383. cursor position. {The maximum number of lines which can be inserted from the 
  384. Clipboard is approximately half the size of the file.} 
  385.  
  386. The Insert+Ctrl keys will copy the lines highlighted by the button 1 drag area 
  387. to the Clipboard. 
  388.  
  389. The Delete key will delete the character or the select area at the current 
  390. cursor position. 
  391.  
  392. The Delete+Shift keys will delete the select area at the current cursor 
  393. position and copy it to the Clipboard. 
  394.  
  395. The Space+Ctrl keys will clear the selected area to blanks. 
  396.  
  397. The b+Ctrl keys will re-insert the last deleted records. 
  398.  
  399. The c+Ctrl keys will suppress/display the comments in a language file. If a 
  400. single line is scrolled then the comment suppression will be disabled. 
  401.  
  402. The c+Ctrl+Shift keys will compile the current file. 
  403.  
  404. The e+Ctrl keys will edit the current line. 
  405.  
  406. The h+Ctrl keys will suppress/restore the lines highlighted by the button 1 
  407. drag area from the display. 
  408.  
  409. The s+Ctrl keys will record and display the programme structure. 
  410.  
  411. The s+Ctrl+Shift keys will save the last active window/file in the file name 
  412. specified in the Entry box. 
  413.  
  414. The x+Ctrl keys will display the record references to the highlighted label. If 
  415. an entry is selected the last active child window will be scrolled to that 
  416. line. 
  417.  
  418. The n+Ctrl keys will move to a recorded bookmark in the file. {Where "n" is one 
  419. of the numeric keys 0-9.} 
  420.  
  421. The n+Alt keys will record a bookmark in the file. 
  422.  
  423.  
  424. ΓòÉΓòÉΓòÉ 5. Profile ΓòÉΓòÉΓòÉ
  425.  
  426. The following keywords may be specified in the profile :- 
  427.  
  428. Language_colour defines the highlight colours for keywords. Up to 255 entries 
  429. may be defined as follows :- 
  430.  
  431.  file_type,keyword,colour,scan_length
  432.  
  433. and are terminated by .END, invalid entries are ignored. 
  434. The case and spaces within the keyword are significant, {the first character of 
  435. the keyword is used for the initial scan so a leading space will slow down the 
  436. screen refresh rate}. The keywords must be <=12 characters. For PL/X(PL/S) and 
  437. PASCAL, languages 3 and 4, the record is folded to upper case before searching 
  438. for keywords. 
  439.  
  440. Comment_start specifies the first two characters of the start of a comment. The 
  441. string must be =<12 characters.  The 6 pairs are used for :- 
  442.  
  443.   1 370 assembler
  444.   2 386 assembler
  445.   3 PASCAL, for Ada specify Comment_start="* ; --/*/*C "
  446.   4 PL/S, PL/AS etc.
  447.   5 C
  448.   6 FORTRAN
  449.  
  450. Comment_end specifies the last two characters of the end of a comment. The 
  451. string must be <=12 characters.  The 6 pairs are as in Comment_start. 
  452.  
  453. File_type specifies the File types to be recognized. The string must be <=64 
  454. characters and terminated by a comma. The first 6 types are used for :- 
  455.  
  456.   1 370 assembler
  457.   2 386 assembler
  458.   3 PASCAL, (Ada)
  459.   4 PL/S, PL/AS, PL/I  etc., (REXX)
  460.   5 C, CPP
  461.   6 FORTRAN
  462.  For REXX files use :- "A37,ASM,PAS,CMD,C,FOR," and replace the PLS entries
  463.  For Ada  files use :- "A37,ASM,ADA,PLS,C,FOR," and replace the PAS entries
  464.  
  465.  
  466. Language_operator defines the operator keywords for each language. The second 
  467. value indicates how to process the keyword, viz. '<' or '>' indicate the scan 
  468. direction from the keyword to locate the label 'P' or 'C' indicates that the 
  469. keyword specifies an entry point or call, ':' indicates that the label will be 
  470. followed by a colon, '2' indicates that the second label following a ',' is to 
  471. be used. Up to 32 entries may be defined as follows :- 
  472.  
  473. file_type,<|>C|P[:][2],keyword
  474.  
  475. and are terminated by .END, invalid entries are ignored. The keywords must be 
  476. <=12 characters. {The C-language procedure values are supplied on the 
  477. Precedent_C keyword.} 
  478.  
  479. Precedent_C specifies the C language procedure keywords. The string must be 
  480. <=64 characters and terminated by a comma. 
  481.  
  482. Window specifies the initial window position. If no profile is specified then 
  483. Window=(0,60,420,635) is assumed. 
  484.  
  485. When is closed its position and size will be remembered. 
  486.  
  487. Transfer_pgm specifies the programme name to be invoked from the Allocate menu 
  488. when the Transfer button is pressed. 
  489.  
  490.  
  491. ΓòÉΓòÉΓòÉ 5.1. Specifying a language ΓòÉΓòÉΓòÉ
  492.  
  493. Alpha has within it (hard coded) routines which understand certain language 
  494. features e.g. 370 Assembler labels start in start in column 1, procedures are 
  495. invoked by BAL, BAS etc. and PASCAL procedures are preceded by FUNCTION or 
  496. PROCEDURE etc.. There are 6 languages understood by Alpha, viz. :- 
  497.  
  498.  
  499.  1 370 Assembler
  500.  2 386 Assembler
  501.  3 PASCAL (Ada)
  502.  4 PL/AS (PL/I, REXX)
  503.  5 C
  504.  6 FORTRAN
  505.  
  506. Because Ada is similar to PASCAL and PL/I & REXX are similar to PL/AS, in 
  507. respect to procedure calls etc., you can also analyse these languages by 
  508. pretending they are type 3 & 4 respectively. 
  509.  
  510.  
  511. However, you can interpret any language/file type (use the highlighting 
  512. facility) by suppling extra definitions in a profile which is specified as a 
  513. parameter to Alpha e.g. 
  514.  
  515.  
  516.  START ALPHA /p profile_name
  517.  
  518. A sample profile (ALPHA.PRF) is provided in the package, which includes 
  519. comments explaining the use of the keywords. This may be edited to change/add a 
  520. file extension, highlighting and programme structure by modifying the following 
  521. keywords :- 
  522.  
  523.  
  524.  File_type - list of file extensions up to 64 characters
  525.  Comment_start - list of comment start character pairs
  526.               (blank is ignored) up to 12 characters
  527.  Comment_end - list of comment end character pairs
  528.               (blank is ignored) up to 12 characters
  529.  Language_colour - list of keyword definitions
  530.           file_type,keyword,colour,maximum scan length
  531.  Language_operator - list of operator definitions
  532.           file_type,attributes,keyword
  533.  
  534. e.g. to add language XYZ with a routine call 'ICALL routine_name' with a 
  535. structure similar to PLS. 
  536.  
  537.  
  538. File_type="A37,ASM,PAS,XYZ,C,FOR," 
  539. Language_colour 
  540. XYZ,ICALL,GREEN,72 
  541. XYZ,Next_key ,(RED,YELLOW,UNDERLINE),72 
  542.  
  543. Language_operator 
  544. XYZ,>C,ICALL 
  545.  
  546. Only the first 6 language types will allow the Expand and Structure operations 
  547. to be effective. This implies that you could not use all the features of Alpha 
  548. for a new language which did not have the call/label syntax of one of the 
  549. existing languages. 
  550.  
  551. The Alpha programme scans the keyword table in the order specified in the 
  552. profile to the comment start in the record. 
  553.  
  554.  
  555. ΓòÉΓòÉΓòÉ 6. Tool bar ΓòÉΓòÉΓòÉ
  556.  
  557. The Tool bar may be used to set an option etc. quickly. The position and state 
  558. of the Tool bar will be remembered when is closed. The following buttons are 
  559. available :- 
  560.  
  561. o - Hide/re-instate highlighted records from display. 
  562.  
  563. o - Display/Create the structure List box. 
  564.  
  565. o - Toggle statement No. display. 
  566.  
  567. o - Cascade Child windows. 
  568.  
  569. o - Tile Child windows. 
  570.  
  571. o - Toggle Tab expansion. 
  572.  
  573. o - Toggle Include option. 
  574.  
  575. o - Repeat last Locate command. 
  576.  
  577. o - Display the record references to the highlighted label. 
  578.  
  579. o - Suppress/display the comments in a language file. If a single line is 
  580.   scrolled then the comment suppression will be disabled. 
  581.  
  582. o - Edit the current line. 
  583.  
  584. o - Save the file using the file name from the Entry box. 
  585.  
  586. o - Compile the file with the command selected from the COMBO box. 
  587.  
  588. o - Copy highlighted records to Clipboard. 
  589.  
  590. o - Copy the selected records to the Clipboard and erase from memory. 
  591.  
  592. o - Insert records from the Clipboard at the current cursor position. 
  593.  
  594. o - Delete the selected records from memory. 
  595.  
  596. o - Re-insert the last deleted records. 
  597.  
  598. o - Clear the select area to blanks. 
  599.  
  600. o - Switch the select area to/from a box format. 
  601.  
  602. If mouse button 2 is held down on a button then a small help balloon will be 
  603. displayed. The structure of the Tool bar may be modified by using the Configure 
  604. Tool bar page of the Configure Notebook. 
  605.  
  606.  
  607. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  608.  
  609. The C language keywords may be specified by the Precedent_C keyword in the 
  610. profile, and the operators for the other languages by the Language_operator 
  611. keyword. 
  612.  
  613.  
  614. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  615.  
  616. The colours may take the values :- BLUE, DARKCYAN, BLACK, DARKBLUE, DARKPINK, 
  617. DARKGRAY, DARKRED, DARKGREEN, BROWN, CYAN, RED, GREEN ,PINK, YELLOW, PALEGRAY, 
  618. DEFAULT, WHITE, ORANGE, PURPLE, PALEGREEN, PALEBLUE, COLOUR1. 
  619.  
  620. The last five colours will not be available on VGA screens. The COLOUR1 value 
  621. may be set by the slider bars and will be remembered when is closed. 
  622.  
  623.  
  624. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  625.  
  626. The Help file ALPHA.HLP must be installed in the HELP path. 
  627.  
  628.  
  629. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  630.  
  631. If mouse button 1 is held down whilst the mouse is dragged to the bottom or top 
  632. of the window the area will be shaded in the Select area colour. A complete 
  633. line will be selected if the start position precedes the first character of a 
  634. line and the end position precedes the start of the following line. The 
  635. highlighted area may then be deleted, copied to the Clipboard etc.. 
  636.  
  637. If the mouse pointer is held at the bottom or top of the screen then the window 
  638. will scroll until the mouse button is released or the pointer moved back within 
  639. the window. 
  640.  
  641.  
  642. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  643.  
  644. The Structure dialog box will display the call structure for 370, 386 
  645. assembler, PASCAL, PL/AS, C and FORTRAN programmes based on the 
  646. Language_operator, Precedent_C, and File_type keywords from the profile. 
  647.  
  648. The Procedure entry names are displayed in the "Locate" colour and and the 
  649. calls in the "Comment" colour. 
  650.  
  651. If an entry is selected from the Structure List Box then the last active window 
  652. is scrolled to that line. The Print button may be used to print the contents of 
  653. the List box on LPT1. 
  654.  
  655. If the file contains Tab characters then Tab expansion should be active before 
  656. the structure tables are built. 
  657.  
  658.  
  659. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  660.  
  661. The colours may take the values :- BLUE, DARKCYAN, BLACK, DARKBLUE, DARKPINK, 
  662. DARKGRAY, DARKRED, DARKGREEN, BROWN, CYAN, RED, GREEN ,PINK, YELLOW, PALEGRAY, 
  663. DEFAULT, WHITE. 
  664.  
  665. For XGA screens etc. the colours :- ORANGE, PURPLE, PALEGREEN, PALEBLUE, 
  666. COLOUR1; may also be used. {The value of COLOUR1  may be set by adjusting the 
  667. sliders on the Colour dialogue box.} 
  668.  
  669.  
  670. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  671.  
  672. Because PL/I is similar to PL/AS you can use this file type for PL/I files. 
  673.  
  674. For REXX files, extension ".CMD", replace PLS by CMD in the File_type and 
  675. replace the PLS entries in the Language_colour by the CMD entries. {Only "CALL" 
  676. or "call" subroutine calls will be recognized.} 
  677.  
  678. For Ada files, extension ".ADA", replace PAS by ADA in the File_type and 
  679. replace the PAS entries by the ADA entries in the profile. Also specify 
  680. Comment_start="* ; --/*/*C " for the Ada comment start characters. 
  681.  
  682.  
  683. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  684.  
  685. If you wish to access files from the host then you should also install a 
  686. programme such as ALMCOPY {from OS2TOOLS}. The programme name may be specified 
  687. in the Profile. 
  688.  
  689. The data from the COMBO box is passed unmodified to the Transfer Programme, 
  690. e.g. 
  691.  
  692. H:ALPHA SCRIPT A ALPHA.SCR
  693.  
  694.  
  695. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  696.  
  697. The current line is the top line in the window unless button 1 has been pressed 
  698. when the cursor will indicate the line. 
  699.  
  700.  
  701. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  702.  
  703. o The Multi-Line Entry box may be used to modify the current line or add new 
  704.   lines. The number of lines added is the No. of lines in the MLE. 
  705.  
  706. o The Modify button will replace the current line with the contents of the MLE. 
  707.  
  708. o The Undo button will undo the changes to the MLE. 
  709.  
  710. o The Cancel button will leave the current line unchanged. 
  711.  
  712. o The number on the left shows the current cursor position in the MLE. 
  713.  
  714. o The number on the right shows the current pointer, mouse, position in the 
  715.   MLE. 
  716.  
  717. If major modifications, {The Multi-line Entry field will only accept 
  718. approximately half the number of lines in the file at a time}, are to be made 
  719. to the file then a purpose built editor should be used. The maximum record size 
  720. allowed is 256. 
  721.  
  722.  
  723. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  724.  
  725. If the file extension is an alias the names must be placed in parenthesis, e.g. 
  726. "A37,ASM,PAS,CMD,(C,CPP),FOR," 
  727.  
  728.  
  729. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  730.  
  731. The command displayed in the Compile dialogue box will be scanned and the % 
  732. replaced by the file name from the file Entry box. The resultant command will 
  733. be executed when the Execute button is pressed. 
  734.  
  735. The Standard Output for the Child process will be written to the "Output" MLE. 
  736.  
  737. The programme name is formed by appending ".EXE" to the first name of the 
  738. command line. 
  739.  
  740. If the command line is modified then it will be remembered when Alpha is 
  741. closed. 
  742.  
  743.  
  744. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  745.  
  746.  
  747. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  748.  
  749. The colour may be the text colour value or an expression, viz. :- 
  750.  
  751. (<Text colour>,<Background colour>,<UNDERLINE>)
  752.  
  753. The value UNDERLINE will select the underscore font. 
  754.  
  755.  
  756. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  757.  
  758. The Box form of the select area will cause the button 1 drag area to form a box 
  759. shape. The paste function will overwrite the appropriate size box area starting 
  760. with the cursor position as the top left of the box. 
  761.  
  762.  
  763. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  764.  
  765. If a file has been modified without saving when Alpha is closed or the child 
  766. window is closed a dialog box will be created with the options of Continue or 
  767. Cancel. 
  768.  
  769. o Continue will continue the operation of closing without saving. 
  770.  
  771. o Cancel will stop the current operation of closing so that the file may be 
  772.   saved. 
  773.