home *** CD-ROM | disk | FTP | other *** search
/ Chip: Extra / Image.bin / os2 / gfc12 / gfc.hlp (.txt) < prev    next >
Encoding:
OS/2 Help File  |  1994-08-16  |  11.7 KB  |  317 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. Standard clipboard functions 
  8. can be used for simple editing of the composite file, which may be saved. 
  9.  
  10. GFC recognises UNIX-style files (i.e. files using just a newline character to 
  11. mark the end of a line, rather than OS/2's carriage return - newline 
  12. combination). 
  13.  
  14.  
  15. ΓòÉΓòÉΓòÉ 2. Open Dialog ΓòÉΓòÉΓòÉ
  16.  
  17. The Open dialog supplies lists of files and directories from which the source 
  18. files can be selected. The full path of the file is made by concatenating the 
  19. file name to the directory, so you can type subdirectories in the name field if 
  20. you want. '..' means the parent directory. If the name of File B is null, the 
  21. name from File A is used. 
  22.  
  23.  
  24. ΓòÉΓòÉΓòÉ 3. Problem Message Box ΓòÉΓòÉΓòÉ
  25.  
  26. The Problem message box informs the user of a problem in the program. This may 
  27. or may not be fatal. The user is required to acknowledge the message; the 
  28. program will take appropriate action. 
  29.  
  30.  
  31. ΓòÉΓòÉΓòÉ 4. File Menu ΓòÉΓòÉΓòÉ
  32.  
  33. The File menu contains the following items: 
  34.  
  35. Open 
  36.     Allows new source files to be opened. 
  37. Save 
  38.     Allows the composite file to be saved. 
  39. Refresh 
  40.     Re-opens the files currently being contrasted, so that the latest changes 
  41.     made to them are used. This will overwrite any changes made to the 
  42.     composite. 
  43. Exit 
  44.     Closes GFC. 
  45.  
  46.  
  47. ΓòÉΓòÉΓòÉ 5. Help Menu ΓòÉΓòÉΓòÉ
  48.  
  49. The Help menu contains the following items: 
  50.  
  51. Help for help 
  52.     Explains the use of the help functions. 
  53. Extended help 
  54.     Displays general help for GFC. 
  55. Keys help 
  56.     Displays help on the keys that can be used in GFC. 
  57. Help index 
  58.     Displays a list of selectable help topics. 
  59. About 
  60.     Brief information about the application. 
  61.  
  62.  
  63. ΓòÉΓòÉΓòÉ 6. Keys for GFC ΓòÉΓòÉΓòÉ
  64.  
  65. GFC assigns the following special functions to keys: 
  66.  
  67. Alt+O 
  68.     Bring up the Open dialog. 
  69. Alt+V 
  70.     Bring up the Save dialog. 
  71. Alt+R 
  72.     Rebuild the composite view. This will overwrite any changes made to the 
  73.     composite. 
  74. F3 
  75.     Exit the GFC program. 
  76. Shift+Delete 
  77.     Cut all marked lines from the composite to the clipboard. 
  78. Ctrl+Insert 
  79.     Copy all marked lines to the clipboard. 
  80. Shift+Insert 
  81.     Paste lines from the clipboard after the current line. 
  82. Alt+Delete 
  83.     Delete all marked lines from the composite view. 
  84. Alt+M 
  85.     Mark all lines in the composite. 
  86. Alt+W 
  87.     Unmark all lines in the composite. 
  88. Alt+A 
  89. Alt+B 
  90.     Display file A or B 
  91. Alt+C 
  92.     Display the composite file 
  93. Alt+L (toggle) 
  94. Alt+T (toggle) 
  95. Alt+I (toggle) 
  96.     Ignore leading, trailing, or all blanks for line comparison. Use the 
  97.     Options menu to see the current status. 
  98. Alt+S (toggle) 
  99.     Ignore the case of letters when comparing. 
  100. Alt+U (toggle) 
  101.     Display lines unique to either source file interleaved, as opposed to in 
  102.     blocks for each file. 
  103. Alt+N (toggle) 
  104.     Show a line number at the start of each line. 
  105. Alt+D 
  106.     Bring up the Define Colours dialog. 
  107. Alt+F 
  108.     Bring up the Fonts dialog. 
  109. Alt+T 
  110.     Bring up the Tab dialog. 
  111. Arrow keys 
  112.     Scroll the displayed file by one character. 
  113. Page Up 
  114. Page Down 
  115.     Scroll the file by the height of the text window. 
  116. Space bar 
  117.     Marks/unmarks the current line. 
  118.  
  119.  
  120. ΓòÉΓòÉΓòÉ 7. View Menu ΓòÉΓòÉΓòÉ
  121.  
  122. The View menu changes the text displayed. This can be either of the source 
  123. files, or the composite file. 
  124.  
  125.  
  126. ΓòÉΓòÉΓòÉ 8. Options Menu ΓòÉΓòÉΓòÉ
  127.  
  128. The Options menu contains the following items: 
  129.  
  130. Ignore leading blanks 
  131.     Re-contrasts the files, with white space (i.e. spaces, tabs or nulls) at 
  132.     the beginning of lines ignored. Any indenting of programs will thus be 
  133.     irrelevant. 
  134. Ignore trailing blanks 
  135.     Ignores white space at the end of lines. Some editors can be inconsistent 
  136.     about leaving this in files. 
  137. Ignore all blanks 
  138.     Disregards all white space, wherever it is in the files. This is useful for 
  139.     comparing programs in free-format languages, especially if differing 
  140.     editors have been used. 
  141. Case Sensitive 
  142.     If this option is in use, upper and lower case alphabetical characters are 
  143.     treated as different characters. If it is not in use, the case is ignored, 
  144.     i.e. 'A' is treated the same as 'a', 'B' as 'b', etc. 
  145. Interleave unique lines 
  146.     Orders unmatching blocks in the composite file so that lines from files A 
  147.     and B alternate. If this option is off, unmatching blocks will displayed as 
  148.     whole blocks from file A or B. 
  149.  
  150.      Altering any of the above options will overwrite any changes made to the 
  151.     composite. 
  152. Display line numbers 
  153.     Shows the line number of each line. In the composite file, the numbers for 
  154.     matched lines are taken from file A. For lines that have been pasted into 
  155.     the composite (even if they originally came from GFC), a line number of 0 
  156.     is used. 
  157. Define colours used 
  158.     Allows user definition of the colours used by GFC. 
  159. Set font used 
  160.     Changes the font and style used for the text display. 
  161. Set TAB equivalent 
  162.     Changes the number of spaces a TAB character is equivalent to during the 
  163.     contrasting process. 
  164.  
  165.  
  166. ΓòÉΓòÉΓòÉ 9. Save Composite Dialog ΓòÉΓòÉΓòÉ
  167.  
  168. The Save composite dialog allows the composite file to be saved, under whatever 
  169. name you choose. 
  170.  
  171.  
  172. ΓòÉΓòÉΓòÉ 10. Edit Menu ΓòÉΓòÉΓòÉ
  173.  
  174. The Edit menu contains the following items: 
  175.  
  176. Cut 
  177.     Cut all marked lines from the composite, and put them in the OS/2 
  178.     clipboard. 
  179. Copy 
  180.     Copy all marked lines to the OS/2 clipboard, while leaving them in the 
  181.     composite. 
  182. Paste 
  183.     Paste lines from the OS/2 clipboard after the current line (indicated by 
  184.     the flashing cursor). 
  185. Delete 
  186.     Delete all marked lines from the composite view. 
  187. Alt+M 
  188.     Mark all lines in the composite. 
  189. Alt+W 
  190.     Unmark all lines in the composite. 
  191.  
  192.  
  193. ΓòÉΓòÉΓòÉ 11. Bar Chart ΓòÉΓòÉΓòÉ
  194.  
  195. The bar chart is a graphical representation of the two source files. Blocks of 
  196. common lines are assigned a colour different from those around them, and drawn 
  197. on the bars representing the files; a line links the matched blocks. The 
  198. matched colours in the bar chart are used as the text colour for the file 
  199. display; the default text colour for unmatched lines is black (red or yellow on 
  200. the chart). Black lines by the bar chart show which parts of the files are 
  201. currently on display. 
  202.  
  203.  
  204. ΓòÉΓòÉΓòÉ 12. Composite ΓòÉΓòÉΓòÉ
  205.  
  206. The composite file is made from the two source files, using the common lines 
  207. where possible. 
  208.  
  209. This is the default colour scheme: 
  210.  
  211. o Common lines have a white background. 
  212.  
  213. o Lines unique to File A are shown in black on yellow. 
  214.  
  215. o Lines unique to File B are shown in black on red. 
  216.  
  217. o When a block of lines in File B has been moved from where it was in File A, 
  218.   the program has to guess whether block 1 was moved up past block 2, or block 
  219.   2 moved down past block 1. It shows the larger block as static, and the other 
  220.   as moved in each file. The text shown as moved is written in a matched text 
  221.   colour, on a yellow or red background. The bar chart shows the connections. 
  222.  
  223. o Lines pasted into the composite from the clipboard are shown in black on 
  224.   white. 
  225.  
  226. The actual colours used are set in the Define colours dialog. 
  227.  
  228.  
  229. ΓòÉΓòÉΓòÉ 13. Colours ΓòÉΓòÉΓòÉ
  230.  
  231. Default colours are: 
  232.  
  233. Text Background 
  234.  
  235. Yellow 
  236.     Lines unique to File A (or moved in File A) Used in bar chart and as text 
  237.     background. 
  238. Red 
  239.     Lines unique to File B (or moved in File B) Used in bar chart and as text 
  240.     background. 
  241. White 
  242.     Lines common to File A and File B, or lines pasted into the composite. Text 
  243.     background only. 
  244.  
  245. See Composite for how moved blocks are coloured. 
  246.  
  247. Text Foreground 
  248.  
  249. Blue 
  250. Dark pink 
  251. Dark green 
  252. Dark cyan 
  253.     Text that has been matched in both files. The same colour is used for the 
  254.     identical text in each file; the choice of colour is such that surrounding 
  255.     blocks of matched lines use different ones. The same colour is used in the 
  256.     bar chart to show the lines. 
  257. Black 
  258.     Unmatched text (including lines pasted in). 
  259.  
  260.  The actual colours are defined by the user in the Define colours dialog. 
  261.  
  262.  
  263. ΓòÉΓòÉΓòÉ 14. Colours dialog ΓòÉΓòÉΓòÉ
  264.  
  265. The Colours dialog allows the colours used by GFC to be set to any of 16 
  266. colours provided by Presentation Manager. Five text and three background 
  267. colours need to be defined. They do not have to be all different, but the 
  268. display may be confusing if they are not. 
  269.  
  270. The default button resets all the colours to the program-supplied settings. 
  271.  
  272.  
  273. ΓòÉΓòÉΓòÉ 15. Font Dialog ΓòÉΓòÉΓòÉ
  274.  
  275. The Font dialog allows any fixed-width font present on the system to be used to 
  276. display the file. If there is no suitable font, the program will use the System 
  277. Proportional font, but text alignment will suffer as a result. The numbers 
  278. given after the font names are point sizes. 
  279.  
  280. The bold checkbox allows the font to be displayed in a different style. 
  281.  
  282.  
  283. ΓòÉΓòÉΓòÉ 16. Set TAB equivalent Dialog ΓòÉΓòÉΓòÉ
  284.  
  285. The Set TAB dialog allows the user to set the number of spaces to which a 
  286. single TAB character in a file is equivalent, for the contrasting process. 
  287.  
  288.  
  289. ΓòÉΓòÉΓòÉ 17. Line Marking ΓòÉΓòÉΓòÉ
  290.  
  291. GFC marks individual lines of text. It cannot mark words or characters. Only 
  292. the composite file can be marked; the original A and B files are never changed. 
  293. A marked line is displayed in an italic font, and also indicated by an asterisk 
  294. to the left of the vertical line in the text window. Marking may be done by: 
  295.  
  296. o Using the Space bar to toggle the state of the current line (shown by the 
  297.   flashing cursor). 
  298.  
  299. o Clicking on a line with the mouse to toggle its state. 
  300.  
  301. o Marking (or unmarking) several lines at once by dragging the mouse over them 
  302.   with the left-hand button held down. If the mouse button was pressed over an 
  303.   unmarked line, this will mark all the lines; if it was unmarked, this will 
  304.   remove all the marks. The window will scroll up or down if the pointer is 
  305.   taken outside the text window. 
  306.  
  307. o Using the Mark all and Unmark all menu options in the Edit menu (accelerator 
  308.   keys Alt+M and Alt+W). These mark or unmark all the lines of the composite, 
  309.   whatever their previous state. 
  310.  
  311.  
  312. ΓòÉΓòÉΓòÉ 18. Overwriting the Composite ΓòÉΓòÉΓòÉ
  313.  
  314. If the composite file has been changed, either by deleting or adding lines, and 
  315. a menu option is selected which involves rebuilding the composite, a message 
  316. box is displayed, allowing the user to halt the rebuild, and preserve the 
  317. edited composite.