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