home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / editor / pmview / pmview.hlp (.txt) < prev    next >
OS/2 Help File  |  1994-01-31  |  12KB  |  378 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Help for PM File View ΓòÉΓòÉΓòÉ
  3.  
  4. PM File View is a file browsing utility for the OS/2 Presentation Manager.  It 
  5. displays files either in ASCII or in hex (see Display ASCII, Display Hex-ASCII, 
  6. and Display Hex-EBCDIC), and additionally permits searching by phrase or 
  7. jumping directly to a specified point in a file (see Find, Repeat Find, and 
  8. Goto). 
  9.  
  10. PM File View can be invoked either from an OS/2 window or from the full-screen 
  11. command line.  If no filename is entered initially, or the filename contains 
  12. wildcards, a dialog box is opened listing the available drives and files from 
  13. which a file may be selected (see Open). PM File View can also be made a part 
  14. of a Desktop Manager group, in which case it can be selected from a menu. 
  15. Adding the optional /i switch, either at the command line or as a parameter of 
  16. the Program Properties menu, will load PM File View with a specified filename 
  17. and immediately shrink it to an icon at start-up, making the file information 
  18. instantly available with the double-click of the mouse on the icon (see Command 
  19. Line Options). Note that even if PM File View is started from a menu with the 
  20. "Minimized" Initial window size option selected, it will still be necesssary to 
  21. specify the /i switch as a parameter to prevent the initial File Open dialog 
  22. box from popping up. 
  23.  
  24. At any time, a file can also be viewed by "dragging" its file name from a File 
  25. Manager list and "dropping" it on the PM File View icon or window in the same 
  26. manner that files can be "dragged" and "dropped" on the Print Manager. The same 
  27. can be done with any file object in an application supporting the public OS/2 
  28. 1.3/2.0 Drag and Drop protocol.  You should be aware, however, that if a list 
  29. containing more than one file name is dragged and dropped, only the first file 
  30. in the list will be displayed. 
  31.  
  32. The selected filename is shown in the title bar of the display window and as 
  33. the title of an icon when the window is minimized.  A status line containing 
  34. the file position (line number or byte offset) can optionally also be displayed 
  35. at the bottom of the display window (see File Position). 
  36.  
  37. Search menu options for PM File View permit entering either a phrase or an 
  38. offset to which the utility will jump. Configuration options permit customizing 
  39. the screen color, display font size, display format, tab stop setting, and 
  40. whether or not the scroll bars and/or the file position status line should be 
  41. shown (see also Font Size). These settings become program defaults, but may be 
  42. changed at any time. 
  43.  
  44.  
  45. ΓòÉΓòÉΓòÉ 1.1. Keys Help ΓòÉΓòÉΓòÉ
  46.  
  47.  F1 
  48.            Displays Help for Show Picture. 
  49.  
  50.  Esc 
  51.            Displays the Open File dialog box if a dialog box is not displayed. 
  52.            Cancels (removes) a file dialog box if one is displayed. (see File 
  53.            Open) 
  54.  
  55.  The following keys may be used only when there are no dialog boxes displayed: 
  56.  
  57.  F3 
  58.            Terminates PM File View. (see File Exit) 
  59.  
  60.  Ctrl-N 
  61.            Closes the current file being displayed, and brings up the Open File 
  62.            dialog box for selection of another file. (see File New) 
  63.  
  64.  Ctrl-O 
  65.            Displays the Open File dialog box. (see File Open) 
  66.  
  67.  Ctrl-F 
  68.            Displays the Find dialog box for entry of search parameters, and 
  69.            then searches the file for the specified text or hex string. (see 
  70.            Search Find) 
  71.  
  72.  Ctrl-R 
  73.            Repeats the last Find. (see Search Repeat Find) 
  74.  
  75.  Ctrl-G 
  76.            Displays the Goto dialog box for entry of a file offset, and then 
  77.            positions the file offset line at the top of the display window. 
  78.            (see Search Goto) 
  79.  
  80.  Ctrl-C 
  81.            Displays a dialog box for configuring the display appearance. (see 
  82.            Display Configure) 
  83.  
  84.  Ctrl-A 
  85.            Displays the file in ASCII format. (see Display ASCII) 
  86.  
  87.  Ctrl-H 
  88.            Displays the file in Hexadecimal - ASCII format. (see Display 
  89.            Hex-ASCII) 
  90.  
  91.  Ctrl-E 
  92.            Displays the file in Hexadecimal - EBCDIC format. (see Display 
  93.            Hex-EBCDIC) 
  94.  
  95.  Ctrl-P 
  96.            Toggles the inclusion / exclusion of a file position status line in 
  97.            the display window. (see Display File Position) 
  98.  
  99.  Ctrl-B 
  100.            Toggles the inclusion / exclusion of scroll bars in the display 
  101.            window. (see Display Scroll Bars) 
  102.  
  103.  Ctrl-S 
  104.            Depending on the display, either toggles the font size (between 
  105.            large and small) or displays a dialog box for selecting a font size. 
  106.            (see Display Font Size) 
  107.  
  108.   
  109.            Moves the display window down one line in the file. 
  110.  
  111.   
  112.            Moves the display window up one line in the file. 
  113.  
  114.  ΓöÇ 
  115.            Moves the display window one character to the right. 
  116.  
  117.  ΓöÇ 
  118.            Moves the display window one character to the left. 
  119.  
  120.  Page Down 
  121.            Moves the display window down one screen in the file. 
  122.  
  123.  Page Up 
  124.            Moves the display window up one screen in the file. 
  125.  
  126.  Home 
  127.            Moves the display window to the top of the file. 
  128.  
  129.  End 
  130.            Moves the display window to the end of the file. 
  131.  
  132.  
  133. ΓòÉΓòÉΓòÉ 1.2. Open ΓòÉΓòÉΓòÉ
  134.  
  135. Use File Open... to select a file to be displayed. 
  136.  
  137. This selection will open a dialog box, from which a file can be selected or 
  138. specified in the entry box of the dialog.  Wildcards specified in the entry box 
  139. will filter the list of filenames displayed in the dialog box. 
  140.  
  141. Shortcut keys: Ctrl-O, Esc 
  142.  
  143.  
  144. ΓòÉΓòÉΓòÉ 1.3. New ΓòÉΓòÉΓòÉ
  145.  
  146. Use File New... to close the current file and display an Open File dialog box. 
  147. As PM File View does not allow other applications to write to the file being 
  148. displayed, this selection is useful when it is needed to make the currently 
  149. displayed file available to other programs for writing without exiting PM File 
  150. View or opening another file. 
  151.  
  152. Shortcut key: Ctrl-N 
  153.  
  154.  
  155. ΓòÉΓòÉΓòÉ 1.4. Exit ΓòÉΓòÉΓòÉ
  156.  
  157. Selection of File Exit will terminate PM File View. 
  158.  
  159. Shortcut key: F3 
  160.  
  161. (The shortcut key cannot be used when a dialog box is displayed) 
  162.  
  163.  
  164. ΓòÉΓòÉΓòÉ 1.5. Find ΓòÉΓòÉΓòÉ
  165.  
  166. Use Search Find... to locate a text or hexadecimal string in the displayed 
  167. file.  The line containing the string becomes the top line in the display 
  168. window. 
  169.  
  170. Use the Find dialog box to enter the string to be located. The string entered 
  171. is assumed to be ASCII text unless the Hex String box is checked.  If it is 
  172. desired to find the ASCII text exactly as entered in the dialog box, check the 
  173. Case Sensitive box; otherwise, the upper / lower case of characters in the 
  174. search string and the file will be ignored in their comparison, e.g. an a will 
  175. match an A. 
  176.  
  177. Hexadecimal strings may be entered with or without spaces between bytes and 
  178. with upper and/or lower case hexadecimal digits. For example, 
  179.  
  180. 6FAC880D
  181.  
  182. can also be entered as 
  183.  
  184. 6f Ac 88 0d
  185.  
  186. However, be aware that the hexadecimal string entry 
  187.  
  188. 6 f a c 8 8 0 d
  189.  
  190. will be treated as 
  191.  
  192. 060f0a0c0808000d
  193.  
  194. The search will start from the current file position (the top line in the 
  195. display window) unless the Search from Top box is checked, in which case the 
  196. search is started from the beginning of the file. 
  197.  
  198. Shortcut key: Ctrl-F 
  199.  
  200.  
  201. ΓòÉΓòÉΓòÉ 1.6. Repeat Find ΓòÉΓòÉΓòÉ
  202.  
  203. Use Search Repeat Find to find the next occurrence of the last string entered 
  204. in the Find dialog box.  Note that if the Search from Top box was checked when 
  205. the last Find was executed, repeated use of the Repeat Find selection will 
  206. always go to the same point in the file -- the first occurrence of the search 
  207. string in the file.  In other words, the Repeat Find command is most useful 
  208. when the Search from Top box in the Find dialog box is not checked. 
  209.  
  210. Shortcut key: Ctrl-R 
  211.  
  212.  
  213. ΓòÉΓòÉΓòÉ 1.7. Goto ΓòÉΓòÉΓòÉ
  214.  
  215. Use Search Goto... to move the display window to a specified offset position in 
  216. the file.  The offset position and type of offset are entered in a Goto dialog 
  217. box when the Goto... selection is invoked.  If a byte offset is specified, the 
  218. character in the file at the offset position is displayed at the top row and 
  219. leftmost column of the display window; an offset of zero corresponds to the 
  220. first character (byte) in the file.  If the offset is a line number, n, then 
  221. the nth line in the file is displayed as top line in the display window (the 
  222. first line in the file is line number 1). 
  223.  
  224. To specify a byte offset, enter the offset in the dialog box and click on the 
  225. either the Decimal button if the offset is a decimal number, or the Hexadecimal 
  226. button if the offset is a hexadecimal value.  A line offset is specified by 
  227. typing the line number in the dialog box entry field and clicking on the Line 
  228. No. button. 
  229.  
  230. The actual positioning of the file to the specified offset occurs when the Goto 
  231. button is clicked or the Enter key is pressed.  Clicking on the Cancel button 
  232. or pressing the Esc key terminates the Goto dialog without performing any file 
  233. positioning. 
  234.  
  235. Shortcut key: Ctrl-G 
  236.  
  237.  
  238. ΓòÉΓòÉΓòÉ 1.8. Configure ΓòÉΓòÉΓòÉ
  239.  
  240. Use Display Configure... to open a dialog box to change and save various 
  241. display characteristics, including the window text and background colors, font 
  242. size, file display mode, number of characters between tab stops, whether or not 
  243. scroll bars should be included in the display, and whether or not a file 
  244. position status line should be displayed. 
  245.  
  246. Pressing the Enter key or clicking on the OK button will change the display 
  247. according to the selections in the dialog box.  If the Save values to disk box 
  248. is checked, the selections will also be saved to disk.  Then, each time PM File 
  249. View is started, the saved selections will be invoked. If the Save window 
  250. position box is checked, the current size and position of the PM FIle View 
  251. window will also be saved and then will be restored each time the program is 
  252. started. 
  253.  
  254. If the Cancel button is clicked or the Esc key is pressed, the display is not 
  255. changed, and the settings are not saved to disk. 
  256.  
  257. Shortcut key: Ctrl-C 
  258.  
  259.  
  260. ΓòÉΓòÉΓòÉ 1.9. Display ASCII ΓòÉΓòÉΓòÉ
  261.  
  262. Select the Display Display ASCII pull-down menu item to view the file as 
  263. characters and symbols.  This is the normal mode to view text files. 
  264. Non-text/ASCII files viewed with this selection will appear as gibberish and 
  265. will likely not have meaningful line layouts; use one of the Hex display modes 
  266. for these types of files. (see Display Hex-ASCII, and Display Hex-EBCDIC). 
  267.  
  268. Shortcut key: Ctrl-A 
  269.  
  270.  
  271. ΓòÉΓòÉΓòÉ 1.10. Display Hex-ASCII ΓòÉΓòÉΓòÉ
  272.  
  273. Select the Display Display Hex-ASCII pull-down menu item to view the file as 
  274. hexadecimal bytes with their corresponding ASCII characters and PC symbols. 
  275. Each line contains three sections: (1) an eight-digit byte file offset of the 
  276. first byte on the line; (2) sixteen hexadecimal bytes of the file; and (3) the 
  277. ASCII characters or PC symbols corresponding to the hexadecimal values. 
  278.  
  279. This display format is most often used with non-text PC files.  For text/ASCII 
  280. and IBM Host files, see Display ASCII, and Display Hex-EBCDIC. 
  281.  
  282. Shortcut key: Ctrl-H 
  283.  
  284.  
  285. ΓòÉΓòÉΓòÉ 1.11. Display Hex-EBCDIC ΓòÉΓòÉΓòÉ
  286.  
  287. Select the Display Display Hex-EBCDIC pull-down menu item to view the file as 
  288. hexadecimal bytes with their corresponding EBCDIC characters.  Each line 
  289. contains three sections: (1) an eight-digit byte file offset of the first byte 
  290. on the line; (2) sixteen hexadecimal bytes of the file; and (3) the EBCDIC 
  291. characters corresponding to the hexadecimal values. 
  292.  
  293. This display format is most often used with IBM Host and DisplayWrite DOC and 
  294. RFT files.  For text/ASCII and non-text PC files, see Display ASCII, and 
  295. Display Hex-ASCII. 
  296.  
  297. Shortcut key: Ctrl-E 
  298.  
  299.  
  300. ΓòÉΓòÉΓòÉ 1.12. File Position ΓòÉΓòÉΓòÉ
  301.  
  302. Use the Display File Position menu item to toggle the display of the line 
  303. number or byte offset status line at the bottom of the display window.  If this 
  304. item is not checked, selecting it will display the status line; if this item is 
  305. checked, selecting it will remove the line.  Note: Displaying the File Position 
  306. status line with Display ASCII selected may slow down response, particularly 
  307. with large files, as the lines are counted while loading and moving through the 
  308. file. 
  309.  
  310. With Display ASCII selected, the status line will display the number of the 
  311. line in the file currently displayed at the top of the display window, along 
  312. with the total number of lines in the file.  The latter number may be one 
  313. greater than similar line totals displayed in line editors, as PM File View 
  314. considers anything after the last line-feed, including the end-of-file (hex 1A) 
  315. character, to be another line. The line number starts with 1. 
  316.  
  317. With Display Hex-ASCII or Display Hex-EBCDIC selected, the status line will 
  318. display in decimal format the offset into the file of the first byte displayed 
  319. on the top line of the display window.  Thus the first byte of the file is 
  320. numbered 0.  Also displayed on the status line, in both decimal and hexadecimal 
  321. formats, is the offset number of the last byte in the file.  Therefore, this 
  322. latter number is one less than the number of bytes in the file. 
  323.  
  324. Shortcut key: Ctrl-P 
  325.  
  326.  
  327. ΓòÉΓòÉΓòÉ 1.13. Scroll Bars ΓòÉΓòÉΓòÉ
  328.  
  329. Use the Display Scroll Bars pull-down menu item to remove the the scroll bars 
  330. from the PM File View window if they are displayed, or to add scroll bars if 
  331. they are not present. 
  332.  
  333. Removing the scroll bars will allow more of the file to be displayed, but the 
  334. keyboard (arrow, page, Home and End keys) must then be used to move through the 
  335. file. 
  336.  
  337. Shortcut key: Ctrl-B 
  338.  
  339.  
  340. ΓòÉΓòÉΓòÉ 1.14. Font Size ΓòÉΓòÉΓòÉ
  341.  
  342. Use the font size pull-down menu item to change the font used to display the 
  343. file.  Selection of this item will then bring up the Font Size list box / 
  344. dialog window, from which a font can be selected. 
  345.  
  346. The Display  Configure... menu item can also be used to set the font size for 
  347. any display. 
  348.  
  349. Shortcut key: Ctrl-S 
  350.  
  351.  
  352. ΓòÉΓòÉΓòÉ 1.15. Command Line Options ΓòÉΓòÉΓòÉ
  353.  
  354. PM File View is invoked with the following syntax (the parameters must be 
  355. separated by at least one space): 
  356.  
  357. PMVIEW [filename.ext] [/i] [/M] 
  358.  
  359. where: 
  360.  
  361.  filename.ext 
  362.            optionally is the name of a file to be displayed.  If a filename.ext 
  363.            is not given or contains wildcards, PM File View displays the Open 
  364.            File dialog box on start-up. If wildcards are included in the 
  365.            filename.ext, only files which meet the wildcard criteria are listed 
  366.            in the dialog box. 
  367.  
  368.  /i 
  369.            is an optional parameter which causes PM File View to start up as an 
  370.            icon. Note that filename.ext must be given when this option is used. 
  371.  
  372.  /M 
  373.            is an optional parameter which causes the Minimize button to be 
  374.            excluded from the frame window.  This option is used only in special 
  375.            circumstances where it is necessary to prevent the inadvertent use 
  376.            of the Minimize button as a "Close" button. 
  377.  
  378.