home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / OS2 / OS2GFC.ZIP / GFC.HLP (.txt) < prev    next >
OS/2 Help File  |  1993-09-03  |  9KB  |  217 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. GFC ΓòÉΓòÉΓòÉ
  3.  
  4. GFC is a graphical file comparison program. It compares two files on disk and 
  5. notes lines that are common to both. A bar chart is drawn, giving an overall 
  6. view of which lines match, and the text of either file, or a composite file, is 
  7. displayed. The default view is the composite file. 
  8.  
  9. GFC recognises UNIX-style files (i.e. files using just a newline character to 
  10. mark the end of a line, rather than OS/2's carriage return - newline 
  11. combination). 
  12.  
  13.  
  14. ΓòÉΓòÉΓòÉ 2. Open Dialog ΓòÉΓòÉΓòÉ
  15.  
  16. The Open dialog supplies lists of files and directories from which the source 
  17. files can be selected. The full path of the file is made by concatenating the 
  18. file name to the directory, so you can type subdirectories in the name field if 
  19. you want. '..' means the parent directory. If the name of File B is null, the 
  20. name from File A is used. 
  21.  
  22.  
  23. ΓòÉΓòÉΓòÉ 3. Problem Message Box ΓòÉΓòÉΓòÉ
  24.  
  25. The Problem message box informs the user of a problem in the program. This may 
  26. or may not be fatal. The user is required to acknowledge the message; the 
  27. program will take appropriate action. 
  28.  
  29.  
  30. ΓòÉΓòÉΓòÉ 4. File Menu ΓòÉΓòÉΓòÉ
  31.  
  32. The File menu contains the following items: 
  33.  
  34. Open 
  35.     Allows new source files to be opened. 
  36. Refresh 
  37.     Re-opens the files currently being contrasted, so that the latest changes 
  38.     made to them are used. 
  39. Exit 
  40.     Closes GFC. 
  41.  
  42.  
  43. ΓòÉΓòÉΓòÉ 5. Help Menu ΓòÉΓòÉΓòÉ
  44.  
  45. The Help menu contains the following items: 
  46.  
  47. Help for help 
  48.     Explains the use of the help functions. 
  49. Extended help 
  50.     Displays general help for GFC. 
  51. Keys help 
  52.     Displays help on the keys that can be used in GFC. 
  53. Help index 
  54.     Displays a list of selectable help topics. 
  55. About 
  56.     Brief information about the application. 
  57.  
  58.  
  59. ΓòÉΓòÉΓòÉ 6. Keys for GFC ΓòÉΓòÉΓòÉ
  60.  
  61. GFC assigns the following special functions to keys: 
  62.  
  63. Alt+O 
  64.     Bring up the Open dialog. 
  65. F3 
  66.     Exit the GFC program. 
  67. Alt+A 
  68. Alt+B 
  69.     Display file A or B 
  70. Alt+C 
  71.     Display the composite file 
  72. Alt+L 
  73. Alt+T 
  74. Alt+I 
  75.     Ignore leading, trailing, or all blanks for line comparison. Use the 
  76.     Options menu to see the current status. 
  77. Alt+U 
  78.     Display lines unique to either source file interleaved, as opposed to 
  79.     alternately. 
  80. Alt+D 
  81.     Bring up the Define Colours dialog. 
  82. Alt+F 
  83.     Bring up the Fonts dialog. 
  84. Arrow keys 
  85.     Scroll the displayed file by one character. 
  86. Page Up 
  87. Page Down 
  88.     Scroll the file by the height of the text window. 
  89.  
  90.  
  91. ΓòÉΓòÉΓòÉ 7. View Menu ΓòÉΓòÉΓòÉ
  92.  
  93. The View menu changes the text displayed. This can be either of the source 
  94. files, or the composite file. 
  95.  
  96.  
  97. ΓòÉΓòÉΓòÉ 8. Options Menu ΓòÉΓòÉΓòÉ
  98.  
  99. The Options menu contains the following items: 
  100.  
  101. Ignore leading blanks 
  102.     Re-contrasts the files, with white space (i.e. spaces, tabs or nulls) at 
  103.     the beginning of lines ignored. Any formatting of programs will thus be 
  104.     irrelevant. 
  105. Ignore trailing blanks 
  106.     Ignores white space at the end of lines. Some editors can be inconsistent 
  107.     about leaving this in files. 
  108. Ignore all blanks 
  109.     Disregards all white space, wherever it is in the files. This is useful for 
  110.     comparing programs in free-format languages, especially if differing 
  111.     editors have been used. 
  112. Case Sensitive 
  113.     If this option is in use, upper and lower case alphabetical characters are 
  114.     treated as different characters. If it is not in use, the case is ignored, 
  115.     i.e. 'A' is treated the same as 'a', 'B' as 'b', etc. 
  116. Interleave unique lines 
  117.     Orders unmatching blocks in the composite file so that lines from files A 
  118.     and B alternate. If this option is off, unmatching blocks will displayed as 
  119.     whole blocks from file A or B. 
  120. Define colours used 
  121.     Allows user definition of the colours used by GFC. 
  122. Set font used 
  123.     Changes the font and style used for the text display. 
  124. Set TAB equivalent 
  125.     Changes the number of spaces a TAB character is equivalent to during the 
  126.     contrasting process. 
  127.  
  128.  
  129. ΓòÉΓòÉΓòÉ 9. Bar Chart ΓòÉΓòÉΓòÉ
  130.  
  131. The bar chart is a graphical representation of the two source files. Blocks of 
  132. common lines are assigned a colour different from those around them, and drawn 
  133. on the bars representing the files; a line links the matched blocks. The 
  134. matched colours in the bar chart are used as the text colour for the file 
  135. display; the default text colour for unmatched lines is black (red or yellow on 
  136. the chart). Black lines by the bar chart show which parts of the files are 
  137. currently on display. 
  138.  
  139.  
  140. ΓòÉΓòÉΓòÉ 10. Composite ΓòÉΓòÉΓòÉ
  141.  
  142. The composite file is made from the two source files, using the common lines 
  143. where possible. 
  144.  
  145. This is the default colour scheme: 
  146.  
  147. Common lines have a white background. 
  148.  
  149. Lines unique to File A are shown in black on yellow. 
  150.  
  151. Lines unique to File B are shown in black on red. 
  152.  
  153. When a block of lines in File B has been moved from where it was in File A, the 
  154. program has to guess whether block 1 was moved up past block 2, or block 2 
  155. moved down past block 1. It shows the larger block as static, and the other as 
  156. moved in each file. The text shown as moved is written in a matched text 
  157. colour, on a yellow or red background. The bar chart shows the connections. 
  158.  
  159.  
  160. ΓòÉΓòÉΓòÉ 11. Colours ΓòÉΓòÉΓòÉ
  161.  
  162. Default colours are: 
  163.  
  164. Text Background 
  165.  
  166. Yellow 
  167.     Lines unique to File A (or moved in File A) Used in bar chart and as text 
  168.     background. 
  169. Red 
  170.     Lines unique to File B (or moved in File B) Used in bar chart and as text 
  171.     background. 
  172. White 
  173.     Lines common to File A and File B Text background only. 
  174.  
  175. See Composite for how moved blocks are coloured. 
  176.  
  177. Text Foreground 
  178.  
  179. Blue 
  180. Dark pink 
  181. Dark green 
  182. Dark cyan 
  183.     Text that has been matched in both files. The same colour is used for the 
  184.     identical text in each file; the choice of colour is such that surrounding 
  185.     blocks of matched lines use different ones. The same colour is used in the 
  186.     bar chart to show the lines. 
  187. Black 
  188.     Unmatched text. 
  189.  
  190.  The actual colours are defined by the user in the Define colours dialog. 
  191.  
  192.  
  193. ΓòÉΓòÉΓòÉ 12. Colours dialog ΓòÉΓòÉΓòÉ
  194.  
  195. The Colours dialog allows the colours used by GFC to be set to any of 16 
  196. colours provided by Presentation Manager. Five text and three background 
  197. colours need to be defined. They do not have to be all different, but the 
  198. display may be confusing if they are not. 
  199.  
  200. The default button resets all the colours to the program-supplied settings. 
  201.  
  202.  
  203. ΓòÉΓòÉΓòÉ 13. Font Dialog ΓòÉΓòÉΓòÉ
  204.  
  205. The Font dialog allows any fixed-width font present on the system to be used to 
  206. display the file. If there is no suitable font, the program will use the System 
  207. Proportional font, but text alignment will suffer as a result. The numbers 
  208. given after the font names are point sizes. 
  209.  
  210. The italic and bold checkboxes allow the font to be displayed in different 
  211. styles. 
  212.  
  213.  
  214. ΓòÉΓòÉΓòÉ 14. Set TAB equivalent Dialog ΓòÉΓòÉΓòÉ
  215.  
  216. The Set TAB dialog allows the user to set the number of spaces to which a 
  217. single TAB character in a file is equivalent, for the contrasting process.