home *** CD-ROM | disk | FTP | other *** search
/ vsiftp.vmssoftware.com / VSIPUBLIC@vsiftp.vmssoftware.com.tar / FREEWARE / FREEWARE40.ZIP / flistfrontend / doc / m3.rno < prev    next >
Encoding:
Text File  |  1985-01-25  |  3.5 KB  |  98 lines
  1. .; $Id: m3.rno,v 1.2 1985/01/25 00:38:04 tom Exp $
  2. .ch Invoking BROWSE
  3. .; invoking more
  4. To run BROWSE, type the DCL command "BROWSE", followed by the name of
  5. the file which you wish to browse.
  6. No default filetype is used.
  7. For example, the command
  8. .b;########BROWSE  XYZ
  9. .b;is equivalent to
  10. .b;########BROWSE  XYZ.
  11. .b;BROWSE recognizes several options, which you may supply in any
  12. order:
  13. .lm+8
  14. .b.i-4;/BG
  15. .x /BG qualifier
  16. .br;The BitGraph terminal is VT100-compatible,
  17. but in its native mode it displays 65 lines on the screen.
  18. The VMS terminal driver coerces the BitGraph to VT100 mode
  19. when BROWSE is invoked.
  20. To run the BitGraph in native mode, use the /BG option.
  21. This restores the terminal to native mode after the terminal
  22. driver has set it to VT100 mode.
  23. .b
  24. This option may not be used if BROWSE is called from FLIST,
  25. since the screen buffer has already been allocated.
  26. .;
  27. .b.i-4;/MARKS
  28. .x /MARKS qualifier
  29. .br;The /MARKS option directs BROWSE to show the file address
  30. and number of each record in the input file.
  31. The resulting prefix-display (file address and record number)
  32. may be toggled on and off with the M-command.
  33. .b
  34. .x /JOIN qualifier
  35. .x /SQUEEZE qualifier
  36. The /JOIN and /SQUEEZE options may alter the displayed record
  37. number from the true value seen by VMS.
  38. The file address, however, is unaffected.
  39. .;
  40. .b.i-4;/NOJOIN
  41. .x /JOIN qualifier
  42. .br;BROWSE examines the record attributes of your file.
  43. If it does not have the carriage-control attribute,
  44. then BROWSE assumes this is a file with embedded carriage-control
  45. characters such as that produced by RUNOFF.
  46. For this case, the JOIN option is, by default, active.
  47. When JOIN is active, BROWSE joins together records which do not
  48. end with a LINE-FEED, so that overstrikes constructed using RETURN
  49. may be shown on a single display line.
  50. .b
  51. To disable this mode (and see the true record structure of a binary
  52. file, for instance), use the /NOJOIN command.
  53. .;
  54. .b.i-4;/OVER
  55. .x /OVER qualifier
  56. .br;If no value is specified, /OVER initially places BROWSE in a
  57. display mode where backspace, RETURN and TAB are shown respectively
  58. as "_^H", "_^M" and "_^I", rather than used as carriage control.
  59. This may be toggled with the O-command.
  60. .b
  61. If the value 2 is given (e.g., "/OVER:2"), then BROWSE treats
  62. the O-command as a three-state toggle.
  63. The third state causes all control characters to be shown as ".".
  64. .;
  65. .b.i-4;/SQUEEZE
  66. .x /SQUEEZE qualifier
  67. .br;Normally BROWSE displays your file exactly as it really is.
  68. However, formatted files (such as those produced by RUNOFF)
  69. may contain a lot of blank lines.
  70. The /SQUEEZE option directs BROWSE to combine into a single "record"
  71. sequences of records which contain only whitespace characters
  72. (e.g., space, TAB, RETURN).
  73. .b
  74. It does not affect the (very rare) cases in which a single
  75. record contains a sequence of LINE-FEED characters embedded
  76. within non-whitespace characters.
  77. .;
  78. .b.i-4;/TRIM
  79. .x /TRIM qualifier
  80. .br;Depending on the current state of ruler-mode,
  81. the J-command causes BROWSE to move the cursor to the next end-of-line,
  82. or to simply scroll to put the rightmost end-of-line on the
  83. screen.
  84. BROWSE normally counts trailing blanks.
  85. They are, after all, part of the file.
  86. To cause BROWSE to ignore trailing blanks,
  87. use the /TRIM option.
  88. .;
  89. .b.i-4;/WIDE
  90. .x /WIDE qualifier
  91. .br;The /WIDE option tells BROWSE to assume that your terminal
  92. is really set to 132-column mode, even though you have told VMS
  93. (via a "SET#TERMINAL") that it is not.
  94. .b
  95. This option may not be used if BROWSE is called from FLIST,
  96. since the screen buffer has already been allocated.
  97. .lm
  98.