readme.rio 6.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178
  1. Rio is the Plan 9 window system.
  2. To read more of this window, the up and down arrows
  3. scroll the text up and down half screens.
  4. To effectively use rio, you need at least a three
  5. button mouse. If you only have a two button mouse you
  6. can emulate the middle button by holding down shift key
  7. whilst pressing the right button.
  8. Button 1, 2, and 3 are used to refer to the left,
  9. middle, and right buttons respectively.
  10. THE POP-UP MENU
  11. Pressing and holding down button 3 on the desktop or
  12. shell window will give you a menu with the following
  13. options:
  14. * New - create a new window
  15. * Resize - reshape a window
  16. * Move - move a window without reshaping it
  17. * Delete - close a window
  18. * Hide - hides a window from display (it will appear
  19. in this menu)
  20. * <label> - the label of a hidden window,
  21. selecting it unhides it
  22. You select an item by releasing the button over the
  23. menu item. rio uses the same button that started an
  24. action throughout that operation. If you press another
  25. button during the action the operation is aborted and
  26. any intermediate changes are reversed.
  27. The menu acts as a action verb selector which then
  28. requires an object (i.e. window) to be picked to
  29. indicate which window the verb is to act on. A further
  30. mouse action may then be required.
  31. EXAMPLES
  32. After selecting New, the cursor will change into a
  33. cross. Using button 3 again, you should then drag out
  34. a rectangle to indicate the size and location of the
  35. new window. When you release the button a new window
  36. will be created.
  37. New windows will contain the rc shell. Invoking a rio
  38. program from the shell will allow that program to take
  39. over the window. As there is no job control in the
  40. shell (e.g. &, fg, bg), you just create another window
  41. if you want to run another program concurrently.
  42. To Resize a window, you select Resize, then click
  43. (remember using the same button that started the
  44. action, i.e. button 3) on the window you want to
  45. resize. The cursor will change to a cross-hair theat
  46. will allow you to drag out the desired shape of the
  47. window.
  48. After selecting Move, click and keep the button
  49. depressed over the window you want to move, then move
  50. the mouse to move the red rectangle that represents the
  51. new location you want. Release the button to finish
  52. the action.
  53. Delete and Hide both operate by requiring you to click
  54. on the window you wish to respectively Delete or Hide.
  55. WINDOW CONTROL TIPS
  56. Clicking on a window brings it to the front.
  57. You can directly change the shape of a window by
  58. clicking and dragging on the edge or corner of the
  59. window border. Button 1 or 2 will allow you to drag
  60. the edge or corner to a new size, and Button 3 will
  61. allow you to move the window.
  62. The pop-up menu remembers the last command chosen, so
  63. as a short cut you can just press and release button 3
  64. without moving the mouse between pressing and releasing
  65. to select the previous command again.
  66. BASIC TEXT CONTROL
  67. Unlike in other systems, the text cursor can only be
  68. controlled by the mouse or the side-effects of certain
  69. commands.
  70. Clicking with button 1 will move the text insertion
  71. point (indicated by an I-beam) to just before the
  72. character closest to the mouse pointer. Dragging
  73. across a section of text will select that portion of
  74. text. It may be useful to know that the insertion
  75. I-beam represents an empty selection (between two
  76. characters). In text editors, the current selection is
  77. known as "dot".
  78. In the shell window button 2 will invoke a pop-up menu.
  79. Most of it's commands operate on dot.
  80. * cut - moves the contents of the dot to the clipboard
  81. if dot is non-empty
  82. * paste - replaces dot with the contents of the clipboard
  83. * snarf - copies dot to the clipboard
  84. * plumb - sends dot (or text surrounding dot, if dot is
  85. empty)to the plumber.
  86. * send - completes the current input line with the dot,
  87. if it is non-empty, or the contents of the clipboard.
  88. If the dot is non-empty it does a snarf at the same time.
  89. * scroll - toggles the automatic scrolling of the window
  90. on output.
  91. Double-clicking will allow you to automatically select
  92. a section of text surrounding that point. The
  93. selection is made by an analysis of appropriate
  94. delimeters. A whole line is selected by
  95. double-clicking at either end of the line. A quoted or
  96. bracketed selection is made by double-clicking just
  97. inside of the quote or bracket.
  98. SCROLLING
  99. The arrow keys will let you scroll up or down by half a
  100. page at a time.
  101. Clicking button 1 on the scrollbar scrolls up by half a
  102. page. Button 3 scrolls down by half a page. Button 2
  103. jumps to position in the document relative to the
  104. position on the scrollbar clicked. Holding a button on
  105. the scrollbar will have the effect of invoking the
  106. clicking action continuously.
  107. The white elevator box on the scrollbar is sized
  108. proportionally to the proportion of the document that
  109. is currently visible.
  110. Scrolling does not affect the text cursor.
  111. RIO AND THE RC SHELL WINDOW
  112. Rc is a command interpreter for Plan 9 that provides
  113. similar facilities to UNIX's Bourne shell. See the
  114. additional references at the end of this document for
  115. information specifically about rc.
  116. Rio provides some additional features that enhance the
  117. interface to programs that use the text console. The
  118. rc shell command interpreter is one such program.
  119. Rc commands are typed after the prompt on the last line
  120. of the text buffer. The commands are sent to rc only
  121. after each newline so line editing may be performed if
  122. desired. You can move the cursor and edit the previous
  123. lines of commands and program output but none of this
  124. will be interpreted by rc shell.
  125. The interpretation of commands is supressed altogether
  126. when ESC is pressed to put the window in hold mode.
  127. The window border and text will change to dark blue to
  128. indicate the hold mode is active. In this mode you can
  129. type multiple lines of commands and edit them.
  130. Pressing ESC again will release the hold and send the
  131. lines of text to the rc command interpreter.
  132. The DEL key sends an 'interrupt' note to all processes
  133. in the window's process group. The usual intent is to
  134. terminate the execution of the current command. It is
  135. also a convenient short cut for ensuring you have a
  136. fresh command prompt.
  137. FURTHER INFORMATION
  138. For further information, try the rio(1) manual page.
  139. Type "man rio" or click on rio(1) in either of these
  140. sentences and select plumb from the button 2 menu.