home *** CD-ROM | disk | FTP | other *** search
/ vsiftp.vmssoftware.com / VSIPUBLIC@vsiftp.vmssoftware.com.tar / FREEWARE / FREEWARE40.ZIP / flistfrontend / doc / m2.rno < prev    next >
Encoding:
Text File  |  1985-01-27  |  18.9 KB  |  502 lines
  1. .; $Id: m2.rno,v 1.2 1985/01/27 20:08:36 tom Exp $
  2. .ch BROWSE Commands
  3. .; more commands
  4. .;.req "d0.req"
  5. This chapter describes in detail the BROWSE browsing commands.
  6.  
  7. .hl    Scrolling Commands
  8. BROWSE permits you to scroll forward or backward in units of a half-screen,
  9. or left or right in units of a column.
  10. The restriction to half-screen scrolling is made to reduce the
  11. overhead required to examine a file.
  12. This permits you to examine files which are larger than those which
  13. you could edit.
  14. .b
  15. Most scrolling operations are performed in a single keystroke.
  16. You may provide a repeat-count to modify the basic half-screen
  17. operations.
  18.  
  19. .hl+1    Forward/Backward
  20. You may scroll through your file in either direction.
  21. BROWSE provides you with several commands for this purpose:
  22. .lm+8
  23. .b.i-4
  24. .x Control characters>CTRL/U
  25. .x U, up
  26. U    The UP command (also CTRL/U)
  27. directs BROWSE to scroll up by one half-screen.
  28. You may not scroll up past the beginning of the file.
  29. .b.i-4
  30. .x Control characters>CTRL/D
  31. .x D, down
  32. D    The DOWN command (also CTRL/D)
  33. directs BROWSE to scroll down by one half-screen.
  34. You may not scroll past the end of the file.
  35. .b.i-4
  36. .x Control characters>CTRL/F
  37. .x F, forward
  38. F    The FORWARD command (also CTRL/F and space)
  39. directs BROWSE to scroll down by a full screen.
  40. .b.i-4
  41. .x Control characters>CTRL/B
  42. .x B, backward
  43. B    The BACKWARD command (also CTRL/B)
  44. directs BROWSE to scroll up by a full screen.
  45. .b.i-4
  46. .x Control characters>CTRL/T
  47. .x T, top
  48. T    The TOP command (also CTRL/T)
  49. directs BROWSE to scroll to the top of the file (i.e., the first line).
  50. .b.i-4
  51. .x Control characters>CTRL/E
  52. .x E, end
  53. E    The END command (also CTRL/E)
  54. directs BROWSE to scroll to the end of the file.
  55. .b.lm-8
  56. As you scroll or skip forward through a file,
  57. BROWSE constructs a table which permits it to rapidly return to
  58. the places where you have been.
  59. This is useful for returning to the end of the file.
  60. It also permits BROWSE to return to the same point on upward scrolling.
  61. Each half-screen display overlaps by one line.
  62. The overlap-lines are the tabulated positions in the file.
  63. .b
  64. .x Number>Repeat count
  65. By supplying a number before the scrolling command,
  66. you direct BROWSE to repeat that operation (without, of course
  67. the extra screen operations).
  68. For example, if you type
  69. .b;########10D
  70. .b;BROWSE will scroll forward by ten half-screens (normally 110 lines).
  71. (Repeat counts are not applicable to the TOP and END commands.)
  72. .b
  73. Whenever BROWSE skips forward into a part of the file it has not read
  74. before, it displays (in the status line) the half-screen number
  75. which it is currently reading.
  76. Because I/O on a heavily-loaded VMS system may be slow,
  77. this tells you how far BROWSE has gotten.
  78. Scrolling to parts of the file which you have previously viewed
  79. is much more rapid;
  80. BROWSE need reread only the text to display on that screen.
  81. .b
  82. .x Arrow keys>UP-ARROW
  83. .x Arrow keys>DOWN-ARROW
  84. The arrow keys (UP-ARROW and DOWN-ARROW) are normally assigned
  85. to the UP and DOWN half-screen scrolling commands.
  86.  
  87. .hl    Aborting a Scrolling Operation
  88. .x X, aborting I/O
  89. If you direct BROWSE to scroll to the end of a file,
  90. it will attempt to do just that.
  91. However, you may change your mind;
  92. you hadn't realized just how big the file really was.
  93. To stop BROWSE, type "X".
  94. This will cause BROWSE to cease reading new pages.
  95. The last screen read will be displayed.
  96.  
  97. .hl    Left/Right
  98. You may direct BROWSE to display the file shifted to the left or the right.
  99. Unlike vertical scrolling, you may scroll left or right by single columns.
  100. BROWSE provides you with several horizontal-scrolling commands:
  101. .lm+8
  102. .b.i-4
  103. .x Control characters>CTRL/H
  104. .y Control characters>Backspace, see CTRL/H
  105. .x H, home
  106. H    The HOME command (also CTRL/H, or backspace) returns the
  107. display to the "home" column (the leftmost one).
  108. .b.i-4
  109. .x Control characters>CTRL/J
  110. .y Control characters>LINE-FEED, see CTRL/J
  111. .x J, jump to end-of-line
  112. J    The JUMP command (also CTRL/J, or LINE-FEED) causes BROWSE
  113. to scroll right until the end of the longest line (in the current
  114. range of lines) is visible in the display.
  115. .b.i-4
  116. .x Control characters>CTRL/L
  117. .x L, left
  118. L    The LEFT command (also CTRL/L) causes BROWSE to scroll left
  119. by one half-screen.
  120. You may not scroll left past the home-column.
  121. .b.i-4
  122. .x Control characters>CTRL/R
  123. .x R, right
  124. R    The RIGHT command (also CTRL/R) causes BROWSE to scroll right by
  125. one half-screen.
  126. Right-scrolling is limited, based on the current display mode and
  127. the maximum record length of the file.
  128. .lm-8
  129. .b
  130. You may modify the operation of the HOME, LEFT and RIGHT commands
  131. by providing a number before the command:
  132. .lm+8
  133. .b.i-4
  134. .x Number>Columns
  135. o    A number provided for the HOME command directs BROWSE to
  136. scroll left or right, placing that particular column at the leftmost
  137. position in the screen.
  138. .b.i-4
  139. .x Number>Repeat count
  140. o    A number provided for the LEFT or RIGHT command directs
  141. BROWSE to scroll left or right by that number of columns.
  142. .lm-8
  143. .b
  144. .x Arrow keys>LEFT-ARROW
  145. .x Arrow keys>RIGHT-ARROW
  146. The arrow keys (LEFT-ARROW and RIGHT-ARROW) are normally assigned to
  147. the LEFT and RIGHT commands.
  148.  
  149. .hl    Column and Line Display
  150. There are many applications in which you need to know the exact location
  151. of parts of the file which you are examining.
  152. .x Ruler-mode
  153. .x Toggle-commands>"__", Ruler-mode
  154. BROWSE provides you with a "ruler" mode.
  155. When you select ruler-mode (by typing an underscore, "__")
  156. BROWSE changes the status line to a combined scale plus line number.
  157. The cursor's column is reflected in the scale;
  158. its line number is shown as well.
  159. Examples of ruler-mode display are reproduced in Figures 1-6 and 1-8.
  160. .b
  161. You may move the cursor in units of single columns or lines using
  162. the arrow keys.
  163. You may temporarily exit ruler mode, and return.
  164. The cursor will return to the point at which you exited ruler mode
  165. (unless, of course, you scroll to a new screen).
  166. .b
  167. .x Ruler-mode
  168. The following commands are provided in ruler mode:
  169. .lm+8
  170. .x Arrow keys>UP-ARROW
  171. .b.i-4;UP-ARROW
  172. .br;moves the cursor up one line.
  173. If the cursor is already at the top-of-screen,
  174. BROWSE scrolls up by a half-screen.
  175. .x Arrow keys>DOWN-ARROW
  176. .b.i-4;DOWN-ARROW
  177. .br;moves the cursor down one line.
  178. If the cursor is already at the bottom of the current screen,
  179. BROWSE scrolls down by a half-screen.
  180. .x Arrow keys>LEFT-ARROW
  181. .b.i-4;LEFT-ARROW
  182. .br;moves the cursor left one column.
  183. If the cursor is in the leftmost display-column,
  184. BROWSE scrolls left by a half-screen.
  185. .x Arrow keys>RIGHT-ARROW
  186. .b.i-4;RIGHT-ARROW
  187. .br;moves the cursor right one column.
  188. If the cursor is at the end of the scale,
  189. BROWSE scrolls to the right by a half-screen.
  190. .x Control characters>CTRL/H
  191. .x H, home
  192. .b.i-4;H    (also CTRL/H, or backspace)
  193. moves the cursor to the HOME-column.
  194. If the cursor is already in the HOME-column,
  195. BROWSE moves the cursor up one line.
  196. .x Control characters>CTRL/I
  197. .y Control characters>TAB, see CTRL/I
  198. .x I, tab
  199. .b.i-4;I    (also CTRL/I, or TAB)
  200. moves the cursor right, to the next tab stop (multiples of 8 columns).
  201. .x Control characters>CTRL/J
  202. .x J, jump to end-of-line
  203. .b.i-4;J    (also CTRL/J, or LINE-FEED)
  204. moves the cursor to the end of the current display line.
  205. If the cursor is already at the end of the display line,
  206. BROWSE moves the cursor down one line.
  207. .b.lm-8
  208. You may modify the effect of the arrow keys, as well as the
  209. I-command by prefixing the command with a repeat count.
  210. .b
  211. .x Ruler-mode
  212. In ruler mode, you may use the other BROWSE commands as well.
  213.  
  214. .hl-1    Searching
  215. .x Highlighting>Searching
  216. BROWSE provides you with a simple, easy to use search command.
  217. It displays the points in the file at which the target is found
  218. by highlighting each occurrence.
  219. .;
  220. .hl+1    Initiating a Search
  221. .x "/", search forward
  222. .x "_\", search backward
  223. To initiate a search, type "/" or "_\".
  224. A forward slash ("/") initiates a forward search;
  225. a backward slash ("_\") a backward search.
  226. BROWSE will prompt you for a search target.
  227. You may provide only printing characters (counting space).
  228. .x Control characters>CTRL/U
  229. .x Control characters>CTRL/X
  230. .x CTRL/U, abort input
  231. .x CTRL/X, abort input
  232. To make corrections, use the DELETE key, or CTRL/U or CTRL/X to abort the
  233. input.
  234. Hit the RETURN or ENTER key to complete the text-entry.
  235. .b
  236. Whatever you have entered becomes the current search target.
  237. A space in your target matches any number of white-space characters
  238. (i.e., space, TAB, FORM-FEED or RETURN) in the display.
  239. BROWSE begins searching in the current screen for matches against this target.
  240. If no matches are found, BROWSE continues the search in the given direction.
  241. If BROWSE reaches the end of the file without finding a match,
  242. it sounds an alarm, and retains its original position.
  243. If a match is found, BROWSE scrolls to the corresponding screen
  244. and highlights all matching positions.
  245. .x Highlighting>Searching
  246. Matching positions which happen to lie to the left or right of
  247. the current column limits are flagged by highlighting the end of
  248. the display line closest to the match.
  249. .b
  250. .x Control characters>CTRL/U
  251. .x Control characters>CTRL/X
  252. .x CTRL/U, abort input
  253. .x CTRL/X, abort input
  254. If you provide no input (i.e., by hitting CTRL/U or CTRL/X, or by simply
  255. hitting RETURN), this clears the search target.
  256. .x Highlighting>Overstruck text
  257. If no search target is active, BROWSE highlights overstruck text.
  258. .;
  259. .hl    Continuing a Search
  260. You may continue a search in either direction,
  261. regardless of the direction in which you initiated it:
  262. .lm+8
  263. .b.i-4
  264. .x Control characters>CTRL/N
  265. .x N, next
  266. N    The NEXT command (also CTRL/N) directs BROWSE to search forward
  267. in the file, for the next matching positions.
  268. .b.i-4
  269. .x Control characters>CTRL/P
  270. .x P, previous
  271. P    The PREVIOUS command (also CTRL/P) directs BROWSE to search backward
  272. in the file, for the previous matches.
  273. .lm-8
  274. .;
  275. .hl    Aborting a Search
  276. .x X, aborting I/O
  277. Searching a file always requires I/O, and can be slow.
  278. If you wish to stop a search, type "X".
  279. This will cause BROWSE to halt the search, and return to its original position.
  280.  
  281. .hl-1    Altering the Display Format
  282. BROWSE is used to examine ^&text\& files, rather than ^&binary\& ones.
  283. You may direct BROWSE to display your file in alternate forms to see its
  284. structure (i.e., the actual characters used to make up overstrikes,
  285. and the record numbering).
  286. The alternatives are intentionally limited to those which are applicable
  287. to text (or printer) files.
  288. You may not, for instance, use BROWSE as a screen-oriented hexadecimal dump
  289. (it strips parity from all characters).
  290. Nor does BROWSE interpret escape sequences (it prevents them from
  291. affecting your screen).
  292. .b
  293. BROWSE, in fact, is designed to be quite robust.
  294. It can display the contents of any sequential file without
  295. causing your terminal to lock up.
  296. Any control characters which are not in its repertoire are
  297. converted to "_^"-form (e.g., ESCAPE becomes "_^_[").
  298. You may use BROWSE to examine binary (".EXE" and ".OBJ") files.
  299. Note, however, that a LINE-FEED always causes BROWSE to begin a
  300. new line.
  301. .;
  302. .hl+1    Overstrikes
  303. .x Highlighting>Overstruck text
  304. Normally BROWSE interprets overstruck text (created by either backspacing
  305. or embedded RETURN characters) and highlights it.
  306. For binary files, this may be inappropriate.
  307. Or you may wish to expand the sequence of characters which make up
  308. the overstruck text.
  309. .x Control characters>Noncommand>CTRL/O
  310. To do this, use the O-command ("O" only, not CTRL/O).
  311. BROWSE will alter its interpretation of backspace and RETURN characters.
  312. Backspaces are shown as "_^H", and RETURN as "_^M".
  313. Tab characters also are shown as "_^I".
  314. .x Toggle-commands>O, overstrikes
  315. .y O, see Toggle-commands
  316. To undo this command, type "O" again; it simply toggles the display.
  317. .b
  318. If you have invoked BROWSE with the qualifier
  319. .b;########/OVER:2
  320. .b;then the O-command becomes a three-state toggle.
  321. The third state shows all control characters (except LINE-FEED) as a ".".
  322. This permits you to examine a binary file looking only for character
  323. strings.
  324. .b
  325. Figure 1-3 illustrates the second state of the O-command.
  326. Figures 1-7 and 1-8 illustrate the third state of the O-command.
  327. .;
  328. .hl    Marks and Record Numbers
  329. You may also use BROWSE to examine the record structure of a text file.
  330. VMS files are organized in records
  331. which may be of any length up to 32768 characters.
  332. Files may have either variable record lengths, or fixed (i.e., all the same).
  333. For most text files, records are synonymous with lines,
  334. i.e., the record attributes imply carriage control at the end of each
  335. record.
  336. However, there are files (such as those produced by RUNOFF) which
  337. do not have carriage control.
  338. Also, even for files having carriage control attributes,
  339. carriage control characters (e.g., LINE-FEED) may be embedded within
  340. a record.
  341. BROWSE makes sense of all this and shows your file as it really is.
  342. .b
  343. When it opens a  file for examination, BROWSE allocates a buffer large
  344. enough to show the longest display line which could be made.
  345. Files with no carriage control attributes are assumed to be like those
  346. produced by RUNOFF:
  347. each record contains characters as needed to produce the desired
  348. carriage control.
  349. BROWSE appends records until a LINE-FEED is found, either explicitly,
  350. or as part of the record attributes.
  351. (You may override this action with the "/NOJOIN" qualifier).
  352. .b
  353. A record may correspond to a fraction of a display line,
  354. or it may be one or more display lines.
  355. You may examine the record structure of the display by using the
  356. "_^"- and M-commands:
  357. .lm+8
  358. .b.i-4
  359. .x Toggle-commands>"_^", Set temporary MARK-mode
  360. .y M, see Toggle-commands
  361. .x Toggle-commands>M, mark (file-address)
  362. o    The "_^" command sets MARK-mode.
  363. BROWSE redisplays the current screen with a prefix before each
  364. line (see Figures 1-4, 1-5, 1-7 and 1-8).
  365. There are either two or four columns of numbers shown in the prefix:
  366. .lm+8
  367. .b.i-4
  368. -    If two, the first is the record file address (the number of
  369. characters from the beginning of the file), and the second is the
  370. display line number.
  371. .b.i-4
  372. -    If four, the first is the record file address,
  373. the second is the offset into a record, and the third and
  374. fourth are the record number and line number.
  375. .lm-8
  376. .b.i-4
  377. .x Toggle-commands>M, mark (file-address)
  378. .y Control characters>RETURN, see CTRL/M
  379. .x Control characters>CTRL/M
  380. o    The M-command (also CTRL/M or RETURN) toggles this prefix mode,
  381. showing the record lengths, rather than their offsets.
  382. It is a three-state toggle; the third state resumes the original
  383. display mode.
  384. .b.lm-8
  385. Normally the M-command becomes inactive again on reaching the
  386. original display mode.
  387. .x /MARKS qualifier
  388. If you use the qualifier
  389. .b;########/MARKS
  390. .b;however, it is permanently enabled.
  391.  
  392. .hl-1    Other Commands
  393. The remaining BROWSE commands are all one-of-a-kind,
  394. but all useful:
  395. .;
  396. .hl+1    Exiting from BROWSE
  397. .x Control characters>Noncommand>CTRL/Q
  398. .x Control characters>CTRL/Z
  399. .x Q, quit
  400. .x Z, end-of-input (quit)
  401. To exit from BROWSE, use the Q (quit) command, or Z (also CTRL/Z).
  402. .;
  403. .hl    Help-Screen
  404. .x "?", help
  405. .x PF2, help
  406. You may obtain online help from BROWSE by typing "?" (or PF2).
  407. BROWSE displays the help-screen shown in Figure 1:
  408. .;
  409. .;
  410. .req "d0.req"
  411. .lm+3.k.nf.nj
  412. Screen dumped: 21-JAN-1985 06:39:56
  413. Image top: 0  bottom: 22
  414.  
  415. +---------------------------------------------------------------------+
  416. |BROWSE - Browsing program                                              |
  417. |Commands:                                                            |
  418. |    Q,Z  - ^&Quit\&.                                                     |
  419. |    _?    - display this message-screen                               |
  420. |    __    - toggle scale/normal mode (alters arrow keys also)         |
  421. |    T,E  - scroll to ^&Top\&/^&End\& of file.                                |
  422. |    F,B  - scroll ^&Forward\&/^&Backward\& by a full-screen.                 |
  423. |    U,D  - scroll ^&Up\&/^&Down\& 1/2 screen (arrow).                        |
  424. |    R,L  - scroll ^&Right\&/^&Left\& 1/2 screen (arrow)                      |
  425. |    H    - scroll left to ^&Home\&-column (in scale-mode, move cursor up |
  426. |    I,J  - (scale-mode) move cursor to next ^&tab\& stop or to next ^&end-o\&|
  427. |    /,_\  - search (if '_\', backward) for a string                    |
  428. |    N,P  - search for ^&Next\&/^&Previous\& occurrence of string.            |
  429. |    W    - refresh display ^&Window\&                                    |
  430. |    X    - ^&aborts\& search/skip                                        |
  431. |    _<number_> - Permit H,L/R scroll by specified ^&number\& of columns,   |
  432. |           or ^&repeat\& of U,D,B,F,I or arrow keys                      |
  433. |Special:                                                             |
  434. |    K   - Copy screen to SNAPSHOT.CRT                                |
  435. |    M   - Toggle ^&MARK\& mode (active if /MARK option)                  |
  436. |    O   - Toggle ^&OVER\& mode (3 states if /OVER, else 2)               |
  437. |    V   - Display current ^&Version\&                                    |
  438. |    _^   - Toggle ^&MARK\& (^&DEBUG\&) modes                                  |
  439. |^&FL.HLP;   Lines 1:23  Cols 1:71 (77)\&                                 |
  440. +---------------------------------------------------------------------+
  441. .lm.nk.f.j
  442. .b2.c;Figure#1##^*Help Summary\*
  443. .;.stc2,1,Help Summary
  444. .b
  445. .;
  446. .;
  447. .hl    Screen-Refresh
  448. If your screen becomes corrupted by line noise, or by unexpected
  449. system messages,
  450. you may direct BROWSE to refresh the screen.
  451. The W command causes BROWSE to re-read the current page and then redisplay it.
  452. .x Control characters>CTRL/W
  453. .x W, window refresh
  454. .x Control characters>Differences from noncontrol>CTRL/W
  455. A CTRL/W may be given at any time (even while entering a search target),
  456. and refreshes the screen without re-reading the page.
  457. The re-read operation is provided to make BROWSE cleaner:
  458. .lm+8
  459. .b.i-4
  460. o    If you have directed BROWSE to display the help-screen,
  461. the W command will redisplay the file, rather than the help-screen.
  462. .b.i-4
  463. .x Toggle-commands>M, mark (file-address)
  464. o    If you are using the M-command to display record marks,
  465. BROWSE may discover in the middle of a page that the file actually
  466. has records with embedded carriage control.
  467. The prefix jumps, from two columns of numbers, to four.
  468. Requiring BROWSE to read each page first to determine this case
  469. would make it slower.
  470. The W command re-reads the page and makes the prefix columns all the
  471. same width.
  472. .lm-8
  473. .;
  474. .hl    Screen-Dump
  475. .x Control characters>CTRL/K
  476. .x K, copy screen
  477. You may obtain a copy of the screen contents by using the
  478. K command (also CTRL/K).
  479. All of the figures in this document were generated using
  480. this facility.
  481. .b
  482. When you issue a screen-dump command, the screen driver makes
  483. a copy of the current screen and writes it to a file:
  484. .b;########SYS_$LOGIN:SNAPSHOT.CRT
  485. .b;When you exit from BROWSE, this file is closed and you may print it.
  486. .x Highlighting>Screen dump
  487. Highlighting is represented in the snapshot-file by underlining.
  488. The time and date of the snapshot are written to the file as well.
  489. Each time you invoke the screen dump, BROWSE informs you of how many
  490. times you have done so.
  491. .b
  492. .x Control characters>CTRL/K
  493. .x Control characters>Differences from noncontrol>CTRL/K
  494. The CTRL/K screen dump is recognized at all times by BROWSE.
  495. The K command, of course, is not recognized during prompts.
  496. .;
  497. .hl    Version
  498. .x Control characters>CTRL/V
  499. .x V, version
  500. Typing a V (also CTRL/V) causes BROWSE to display its version number
  501. in the status line.
  502.