home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 2 / Apprentice-Release2.iso / Source Code / C / Libraries / stdwin / Doc / man / ubr.man < prev    next >
Encoding:
Text File  |  1987-08-14  |  6.3 KB  |  214 lines  |  [TEXT/????]
  1. .\" Optional .TH arguments: $3 is bottom center, $4 bottom left, $5 top center
  2. .TH UBR 1 "18 June 1987" "CWI"
  3. .SH NAME
  4. ubr \- Universal BRowser
  5. .SH SYNOPSIS
  6. .B ubr
  7. [ directory ] ...
  8. .SH DESCRIPTION
  9. .I Ubr
  10. is a modern version of the old
  11. .I dired
  12. program, posted to USENET several times in the past.
  13. (Ubr does not contain any code from dired.)
  14. .PP
  15. Command input to Ubr usually consists of one- or two-character escape
  16. sequences, such as
  17. .B ESC-o
  18. or
  19. .B ^X-n.
  20. Arrow keys also have a meaning.
  21. Commands can also be selected from a group of
  22. .I menus,
  23. activated by pressing
  24. .B ESC-ESC,
  25. through which one can navigate using the arrow keys (also the Emacs
  26. equivalents
  27. .B ^F, ^B, ^P
  28. and
  29. .BR ^N ).
  30. Press Return to select a command; press
  31. .B ^C
  32. or
  33. .B ESC-ESC
  34. (again) to cancel menu selection mode.
  35. All menu items have shortcuts which are displayed next to the menu
  36. items; this description only mentions the shortcuts because these are
  37. what you'll normally use.
  38. .PP
  39. .I Ubr
  40. displays one or more directory listings (very much like the output of
  41. .IR ls (1)),
  42. each in its own
  43. .I window.
  44. A window is really just a segment of the screen; a window has a title
  45. line, showing the name of the directory displayed in the window,
  46. centered in dashes.
  47. At any moment there is a current window, whose title line is shown in
  48. inverse video.
  49. The directory displayed in the current window is used as the initial
  50. working directory, also known as current directory, for all shell
  51. commands issued; the term
  52. .I current directory
  53. therefore can be used without confusion.
  54. There are a number of commands that merely affect which window is
  55. current:
  56. .B ^X-n
  57. makes the next window on the screen the current window,
  58. .B ^X-p
  59. makes the previous window current,
  60. .B ^X-d
  61. or
  62. .B ESC-k
  63. closes (deletes) the current window.
  64. when all windows are closed,
  65. .I ubr
  66. quits;
  67. .B ESC-q
  68. or
  69. .B ^C
  70. can be used to quit immediately.
  71. .PP
  72. In each directory window, there is a
  73. .I selection
  74. which may be any subset (including the empty set) of the files displayed
  75. in the window.
  76. The names of selected files are displayed in inverse video.
  77. The following commands affect what files are selected in the current
  78. window:
  79. .B up-arrow
  80. (also
  81. .BR ^P )
  82. and
  83. .B down-arrow
  84. (also
  85. .BR ^N )
  86. move the selection one line up or down, if possible.
  87. .B ESC-a
  88. selects all files in the window.
  89. .B ESC-s
  90. prompts for a file name pattern like the ones used by
  91. .IR sh (1)
  92. and selects all file names in the current window matching that pattern.
  93. .B ^G
  94. or
  95. .B ESC-^G
  96. only works on HP 2621 terminals (and even then only if you use a
  97. beefed-up
  98. .I termcap
  99. file).
  100. It selects the file currently at the cursor (which is movable by using
  101. the arrow keys without pressing the shift key at the same time).
  102. On a BLIT, using Sape's tty driver (or mine), you may be able to use
  103. mouse clicks to select files.
  104. .PP
  105. Besides the selection, which is rather volatile, there is a more
  106. permanent
  107. .I marking
  108. of files, indicated by a `!' before the file name.
  109. These marks can be set or cleared by selecting a file and pressing
  110. .B ESC-f
  111. (flip marks).
  112. If more than one file is selected, the effect of
  113. .B ESC-f
  114. depends on the mark of the first selected file: if set, all marks of
  115. selected files are cleared, if clear, all marks are set.
  116. The marks are used for deleting, moving and copying files.
  117. .PP
  118. .B ESC-o
  119. attempts to open all selected files as subdirectories.
  120. If a non-directory is selected, an error message is issued.
  121. .B ESC-O
  122. (type ESC-shift-letter Oh)
  123. prompts for a pathname of a directory and displays its contents in a
  124. window.
  125. .PP
  126. .B ESC-/
  127. (re-read directory contents) is a command which is sometimes necessary
  128. after a background job or another user has changed a directory's
  129. contents.
  130. It reads the directory's contents and conpares it with the window
  131. contents; files that have been deleted are deleted from the window, new
  132. files are added (and selected!), and the status information for other
  133. files is updated if it has changed.
  134. .PP
  135. The commands
  136. .B ESC-m,
  137. .B ESC-l
  138. and
  139. .B ESC-c
  140. can move, link and copy files between directories.
  141. They take all marked files in other windows and respectively move, link
  142. or copy them to the current directory, where they are made the curernt
  143. selection.
  144. .B ESC-d
  145. deletes all marked files from the current directory.
  146. Note that to delete a file, three actions are necessary: select it, mark
  147. it and press ESC-d, so you have a reasonable protection against
  148. mistakes.
  149. (Also, files are never really deleted but just given a new name that
  150. begins with a `,'; such files are removed automatically after a few
  151. days, and are not seen by
  152. .IR ubr .)
  153. .B ESC-r
  154. requires that a single file is selected; it prompts for a new name and
  155. the file is given that new name (if there are no conflicts).
  156. .B ESC-n
  157. prompts for a name and creates a new, empty subdirectory with that name.
  158. The new subdirectory is selected but not opened.
  159. .PP
  160. .B ESC-;
  161. prompts for a shell command and executes the command in the current
  162. directory, with the files currently selected (if any) as parameters.
  163. .B ESC-!
  164. prompts for a shell commands and executes it in the current directory;
  165. it does not explicitly pass it the selected files, but the shell
  166. variables $1, $2, ... (together referred as $* or ``$@'') contain the
  167. selected files names.
  168. .B ESC-$
  169. starts an interactive subshell in the current directory.
  170. .B ESC-e
  171. edits the selected files using the editor set in the environment
  172. variable $EDITOR (default
  173. .IR vi ).
  174. .B ESC-p
  175. pages the selected files using the pager set in the environment variable
  176. $PAGER (default
  177. .IR more ).
  178. .SH FILES
  179. .B ~guido/bin/ubr
  180. the program.
  181. .br
  182. .B .
  183. current directory, opened if no arguments.
  184. .br
  185. .B /etc/termcap
  186. default
  187. .I termcap
  188. file; if you want special effects on HP 2621 terminals, you should use
  189. .B ~guido/lib/termcap
  190. instead (put this pathname in the
  191. .I TERMCAP
  192. variable).
  193. .SH SEE ALSO
  194. ls(1), sh(1)
  195. .SH DIAGNOSTICS
  196. Intended to be self-explanatory.
  197. .SH BUGS
  198. Sometimes the display gets messed up or updated incompletely.
  199. Use control-L to fix this.
  200. .br
  201. Files whose name begins with a comma are not listed.
  202. .br
  203. There should be a way to edit or at least page files in a window, rather
  204. than relying completely on ESC-e and ESC-p.
  205. .br
  206. Attempts to open a file should result in paging it instead of refusal.
  207. .br
  208. .I Ubr
  209. is still a very rough version of the program I had in mind.
  210. Please report any problems you have, and any features you would like to
  211. see in a program like this, to the author.
  212. .SH AUTHOR
  213. Guido van Rossum.
  214.