home *** CD-ROM | disk | FTP | other *** search
/ Source Code 1994 March / Source_Code_CD-ROM_Walnut_Creek_March_1994.iso / compsrcs / unix / volume26 / utree / part07 < prev    next >
Encoding:
Text File  |  1992-09-06  |  44.9 KB  |  1,538 lines
  1. Newsgroups: comp.sources.unix
  2. From: klin@iat.uni-paderborn.de (Peter Klingebiel)
  3. Subject: v26i070: utree - screen oriented filesystem utility (V3.03b-um), Part07/08
  4. Sender: unix-sources-moderator@pa.dec.com
  5. Approved: vixie@pa.dec.com
  6.  
  7. Submitted-By: klin@iat.uni-paderborn.de (Peter Klingebiel)
  8. Posting-Number: Volume 26, Issue 70
  9. Archive-Name: utree/part07
  10.  
  11. #! /bin/sh
  12. # This is a shell archive.  Remove anything before this line, then unpack
  13. # it by saving it into a file and typing "sh file".  To overwrite existing
  14. # files, type "sh file -c".  You can also feed this as standard input via
  15. # unshar, or by typing "sh <file", e.g..  If this archive is complete, you
  16. # will see the following message at the end:
  17. #        "End of archive 7 (of 8)."
  18. # Contents:  doc/utree.1
  19. # Wrapped by vixie@cognition.pa.dec.com on Mon Sep  7 14:39:57 1992
  20. PATH=/bin:/usr/bin:/usr/ucb ; export PATH
  21. if test -f 'doc/utree.1' -a "${1}" != "-c" ; then 
  22.   echo shar: Will not clobber existing file \"'doc/utree.1'\"
  23. else
  24. echo shar: Extracting \"'doc/utree.1'\" \(43554 characters\)
  25. sed "s/^X//" >'doc/utree.1' <<'END_OF_FILE'
  26. X'''\"
  27. X'''\"   utree.man, utree 3.03-um manual page
  28. X'''\"   klin, Fri Mar  6 11:31:02 1992
  29. X'''\"
  30. X'''\"   [x]roff -man utree.man
  31. X'''\"   groff   -man [-Tdevice] utree.man
  32. X'''\"
  33. X'''\"   SCCSID = @(#) utree.man 3.03-um Mar  6 1992
  34. X'''\"
  35. X.TH UTREE 1L "UTREE Version 3.03-um" "March 6 1992"
  36. X.SH NAME
  37. X.LP
  38. X\fButree\fR \- Screen oriented filesystem browser and utility
  39. X.SH SYNOPSIS
  40. X.LP
  41. utree [options] [rootdirectory]
  42. X.SH DESCRIPTION
  43. X.LP
  44. The screen oriented filesystem browser and utility
  45. X\fButree\fR descends the directory hierarchy
  46. rooted in your home directory,
  47. defined in a tree list file if given,
  48. or rooted in \fBrootdirectory\fR if given,
  49. and displays the directory tree on the so called \fItree screen\fR.
  50. On the \fItree screen\fR \fButree\fR lets you walk thru the tree,
  51. execute some default and user defined commands on it
  52. and change to any directory in the tree.
  53. X.br
  54. If you have changed to a directory \fButree\fR displays all files
  55. in this directory on the so called \fIfile screen\fR.
  56. On the \fIfile screen\fR \fButree\fR lets you walk thru the file list
  57. and execute some default and user defined commands on files.
  58. X.SH OPTIONS
  59. X.LP
  60. The following command line options are interpreted by \fButree\fR:
  61. X.sp
  62. X.TP 16
  63. X\fB-L\fR
  64. XFollow symbolic links to directories
  65. X.TP
  66. X\fB-S\fR
  67. Ignore default minimal screen size of 80 columns and 24 lines
  68. X.TP
  69. X\fB-V\fR
  70. Display \fButree\fR version and copyright notice
  71. X.TP
  72. X\fB-a\fR
  73. Read in all directories,
  74. including those that begin with a dot (.),
  75. which are normally skipped
  76. X.TP
  77. X\fB-b\fR
  78. Suppress ringing of the bell (useful for visual bells)
  79. X.TP
  80. X\fB-c\fR
  81. Don't display and update a clock every second
  82. X.TP
  83. X\fB-d var=[val]\fR
  84. Set the variable \fBvar\fR to value \fBval\fR
  85. or unset the variable \fBvar\fR
  86. X.TP
  87. X\fB-d typ:[cmd]\fR
  88. Define the command \fBcmd\fR for the filetype \fBtyp\fR
  89. or undefine any command for the filetype \fBtyp\fR
  90. X.TP
  91. X\fB-f lst\fR
  92. Build directory tree from list file \fBlst\fR
  93. X.TP
  94. X\fB-g\fR
  95. Don't use graphical characters
  96. X.TP
  97. X\fB-h\fR
  98. Display usage and some help about options
  99. X.TP
  100. X\fB-i ind\fR
  101. Set the tree level indention to \fBind\fR columns (3..9)
  102. X.TP
  103. X\fB-n\fR
  104. Avoid scanning the tree for changes i.e. after shell escape
  105. X.TP
  106. X\fB-l lev\fR
  107. Build the tree up to level \fBlev\fR for quicker startup
  108. X.TP
  109. X\fB-o\fR
  110. Omit saving changes in variables and filetype command definitions,
  111. command history and key bindings
  112. X.TP
  113. X\fB-p lin\fR
  114. Use \fBlin\fR lines for displaying filenames of the current directory
  115. on the \fItree screen\fR (default: 3)
  116. X.TP
  117. X\fB-q\fR
  118. Build the tree up to level 2 (like -l 2)
  119. X.TP
  120. X\fB-r\fR
  121. Build the tree scanning and reading the file system
  122. instead of reading a tree list file
  123. X.TP
  124. X\fB-s\fR
  125. Don't use hardware scrolling
  126. X.TP
  127. X\fB-u\fR
  128. Read and update all file lists after building
  129. the tree from a tree list file
  130. X.TP
  131. X\fB-v mod\fR
  132. Set using video attributes to mode \fBmod\fR.
  133. X\fBmod\fR may be \fB2\fR for all possible,
  134. X\fB1\fR for bold and underline
  135. and \fB0\fR for none video attributes.
  136. X.TP
  137. X\fB-w\fR
  138. Suppress warnings about unreadable directories
  139. X.TP
  140. X\fB-x cmd\fR
  141. Use and execute the string \fBcmd\fR as initial input at startup.
  142. The string \fBcmd\fR is a simple sequence of \fButree\fR commands
  143. X.PP
  144. The boolean options \fBbcgnosw\fR and the
  145. numerical options \fBipv\fR may also be pre-set in
  146. the environment variable \fBUTREE\fR.
  147. XE.g. if you want to suppress ringing of the bell and
  148. displaying and updating the clock and if you prefer a tree indention
  149. of 4 columns set the environment variable \fBUTREE\fR to '\fBbci4\fR'
  150. for this reason.
  151. X.br
  152. Most of the options correspond to \fButree\fR
  153. variables and therefore they may also be set or unset
  154. with the variable command (\fB=\fR).
  155. See the sections \fIglobal commands\fR and \fIvariables\fR below.
  156. X.SH UTREE STARTUP
  157. X.LP
  158. If \fButree\fR is called without the optional command line parameter
  159. X\fBrootdirectory\fR or this directory is rooted in your
  160. home directory \fButree\fR tries to build up the directory tree
  161. reading a file \fB.utreelist\fR in your home directory,
  162. which contains a list of your directory tree created
  163. by a previous \fButree\fR session
  164. or by the additional shell script \fButree.mklist\fR called before.
  165. If the command line option \fB-f lst\fR is given
  166. X\fButree\fR builds up the tree from this list file \fBlst\fR
  167. which may be created with the denoted shell script \fButree.mklist\fR
  168. or a command like \fBfind\fR.
  169. XEntries in such list files have to start with the
  170. directory separator / (slash) in the first column of the line.
  171. All other entries are ignored and skipped.
  172. X.sp
  173. If building the tree from a list file
  174. the file lists of directories are created and read in on demand only,
  175. which means when a directory becomes the current directory
  176. by moving the cursor to this directory.
  177. This speeds up the start of \fButree\fR because there is no need
  178. for scanning and reading the filesystem for subdirectories
  179. what may take some time for larger filesystems.
  180. X.sp
  181. In all others cases,
  182. if no list file is given with the
  183. command line option \fB-f lst\fR,
  184. X\fBrootdirectory\fR is rooted in your home directory
  185. and the file \fB.utreelist\fR is not found,
  186. or the command line option \fB-r\fR is given
  187. X\fButree\fR builds up the tree by
  188. scanning and reading the filesystem recursively.
  189. You can speed up the start with the commandline option
  190. X\fB-l lev\fR which causes \fButree\fR to build the
  191. initial directory tree only up to level \fBlev\fR similar to
  192. the option \fB-l\fR of the well known \fBfind\fR command.
  193. At runtime some commands let you expand the directory
  194. tree later and inspect directories and subtrees
  195. not visible at startup (see below).
  196. X.SH SCREEN LAYOUT
  197. X.LP
  198. The screen is divided into three regions.
  199. The top screen line,
  200. the so called \fIecho line\fR is for displaying
  201. messages and entering input.
  202. The second screen line,
  203. the so called \fIhelp line\fR is for displaying
  204. help messages and the \fButree\fR default
  205. or user defined menu lines.
  206. X.br
  207. The rest of the screen forms a window on the directory tree
  208. on the \fItree screen\fR or
  209. on the file list of the current directory
  210. on the \fIfile screen\fR.
  211. Or he is used for displaying variable or filetype commands settings,
  212. for displaying help pages and displaying command outputs.
  213. X.SH UTREE SCREENS AND MENUS
  214. X.LP
  215. X\fBUtree\fR knows the following screens and menus:
  216. X.sp
  217. X.TP 20
  218. X\fBtree screen\fR
  219. This is the initial screen displayed when \fButree\fR is started
  220. and has built up the directory tree.
  221. The \fItree screen\fR forms a window on the directory tree.
  222. The current directory on which most commands are
  223. working is highlighted and the last
  224. screen lines are used to display the first files
  225. of the file list of the current directory.
  226. You may move the window over the directory tree,
  227. enlarge or shrink the directory tree window
  228. or walk thru the directory tree and execute
  229. default and user defined commands on directories and subtrees.
  230. On the help line the most important commands available
  231. for directories or subtrees on
  232. the \fItree screen\fR are shown in the default \fItree menu\fR.
  233. The tree menu shows the names of the
  234. the \fItree screen\fR commands,
  235. the keystrokes to invoke a command are marked with uppercase letters.
  236. You may switch the menu to a user defined menu line
  237. displaying user defined commands for the \fItree screen\fR.
  238. XFor further information about all \fItree screen\fR commands
  239. see the sections \fIglobal commands\fR,
  240. X\fItree screen commands\fR and \fIvariables\fR of this manual page.
  241. X.sp
  242. X.TP
  243. X\fBfile screen\fR
  244. The \fIfile screen\fR forms a window on all files of the
  245. current directory.
  246. The current file on which most commands are
  247. working is highlighted.
  248. Yoy may move the window over the file list
  249. or walk thru the file list and execute
  250. default and user defined commands on files.
  251. On the help line the most important commands
  252. for files available on
  253. the \fIfile screen\fR are shown in the default \fIfile menu\fR.
  254. The file menu displays the names of the
  255. the \fIfile screen\fR commands,
  256. the keystrokes to invoke a command are marked with uppercase letters.
  257. You may switch the menu to a user define menu line
  258. displaying user defined commands for the \fIfile screen\fR.
  259. XFor further information about all \fIfile screen\fR commands
  260. see the sections \fIglobal commands\fR,
  261. X\fIfile screen commands\fR and \fIvariables\fR of this manual page.
  262. X.sp
  263. X.TP
  264. X\fBhelp screen\fR
  265. If you have switched to the \fIhelp screen\fR with
  266. the help command (\fBh\fR)
  267. on the help line the
  268. X\fIhelp menu\fR is displayed and you may
  269. select help about interesting topics.
  270. The help menu displays the names of all
  271. available help topics,
  272. the keystrokes to select help about a topic
  273. are marked with uppercase letters.
  274. XFor more information see the section \fIhelp pages\fR below.
  275. X.sp
  276. X.TP
  277. X\fBvariables screen\fR
  278. If you have switched to the \fIvariables\fR screen with
  279. the variables command (\fB=\fR)
  280. all variables and their settings are displayed
  281. and you may set or unset any of the variables.
  282. On the help line is shown how to set or unset a variable
  283. in a short form.
  284. All changes in variables definitions are
  285. saved to the file \fB.utree\fR in your home directory
  286. if the variable \fBAUTOSAVE\fR is set.
  287. XFor more information see the section \fIvariables\fR below.
  288. X.sp
  289. X.TP
  290. X\fBcommands screen\fR
  291. If you have switched to the filetype \fIcommands screen\fR with
  292. the filetype commands command (\fB:\fR)
  293. all filetype commands and their settings are displayed
  294. and you may set or unset any of the filetype commands.
  295. On the help line is shown how to set or
  296. unset a filetype command in a short form.
  297. All changes in filetype command definitions are
  298. saved to the file \fB.utree\fR in your home directory
  299. if the variable \fBAUTOSAVE\fR is set.
  300. XFor more information see the section \fIfiletype commands\fR below.
  301. X.sp
  302. X.TP
  303. X\fBshell screen\fR
  304. If you have switched to the \fIshell screen\fR with
  305. the shell command (\fB!\fR) for executing commands
  306. not supported directly by \fButree\fR
  307. all previously entered commands saved in a so called
  308. history list are displayed on the \fIshell screen\fR.
  309. You may get any command from the history list
  310. into the line editor for editing and execution
  311. or enter and execute a new command.
  312. All commands up to a maximal number defined in
  313. the variable \fBHISTSIZE\fR are saved in the
  314. history list.
  315. Before leaving \fButree\fR all saved commands
  316. in the history list are saved to a
  317. history file \fB.utreehist\fR in your home directory
  318. if the variable \fBAUTOSAVE\fR is set.
  319. At startup this file is searched for and read in
  320. if found.
  321. XFor more information see also the section \fIvariables\fR below.
  322. X.sp
  323. X.TP
  324. X\fBbindings screen\fR
  325. If you have switched to the \fIbindings screen\fR
  326. with the bindings command (\fB|\fR) all
  327. currently defined key bindings and their meaning are
  328. displayed and you may bind any key to an appropriate
  329. utree command or to insert a string into the
  330. input buffer.
  331. At startup a file \fB.utree-TERM\fR in your home directory
  332. or a file \fButree-TERM\fR in a global startup directory
  333. is read in if found containing key bindings for
  334. the terminal type defined in the environment variable \fBTERM\fR.
  335. All changes in key bindings you have done on the
  336. X\fIbindings screen\fR at runtime are saved to \fB.utree-TERM\fR
  337. if the variable \fBAUTOSAVE\fR is set.
  338. XFor more information see also the section \fBkey bindings\fR
  339. below.
  340. X.sp
  341. X.TP
  342. X\fBstatus screen\fR
  343. The status command (\fBs\fR) displays all information
  344. available about a file or directory on the \fIstatus screen\fR.
  345. Here you may change the ownership, group membership
  346. or access rights of a file or directory.
  347. On BSD systems not all of the denoted changes may be allowed
  348. for normal users.
  349. X.SH KEY NAMING CONVENTIONS AND DEFAULT KEY BINDINGS
  350. X.LP
  351. All \fButree\fR commands are simple single letter commands or
  352. control sequences.
  353. The default or user defined commands therefore
  354. are invoked with a single keystroke or a combination
  355. of the <\fICONTROL\fR> key with
  356. another key.
  357. The naming conventions in the following manual sections
  358. for \fButree\fR commands invoked by a keystroke are:
  359. X.sp
  360. X.TP  20
  361. X\fBkey\fR
  362. means hit this <\fIkey\fR> only
  363. X.TP
  364. X\fBC-key\fR
  365. means hold down the <\fICONTROL\fR>-key and hit <\fIkey\fR>
  366. X.PP
  367. To permit rebinding of pre-defined keys or
  368. binding functions keys to \fButree\fR commands
  369. all control sequences have special names.
  370. All key or functions names and their default bindings
  371. are list in the table below
  372. X.TP 20
  373. X\fBSELECT\fR
  374. CR, NL
  375. X.TP
  376. X\fBFORWARD\fR
  377. C-f
  378. X.TP
  379. X\fBBACKWARD\fR
  380. C-b
  381. X.TP
  382. X\fBNEXT\fR
  383. C-n
  384. X.TP
  385. X\fBPREVIOUS\fR
  386. C-p
  387. X.TP
  388. X\fBNEXTPAGE\fR
  389. C-v
  390. X.TP
  391. X\fBPREVPAGE\fR
  392. C-w
  393. X.TP
  394. X\fBBEGIN\fR
  395. C-a
  396. X.TP
  397. X\fBEND\fR
  398. C-e
  399. X.TP
  400. X\fBUP\fR
  401. C-u
  402. X.TP
  403. X\fBDOWN\fR
  404. C-d
  405. X.TP
  406. X\fBINSERT\fR
  407. C-o
  408. X.TP
  409. X\fBDELETE\fR
  410. BS
  411. X.TP
  412. X\fBKILL\fR
  413. C-k
  414. X.TP
  415. X\fBSETMARK\fR
  416. C-@
  417. X.TP
  418. X\fBGOTOMARK\fR
  419. C-g
  420. X.TP
  421. X\fBGOTOTAG\fR
  422. C-t,TAB
  423. X.TP
  424. X\fBHELP\fR
  425. C-r
  426. X.TP
  427. X\fBREFRESH\fR
  428. C-l
  429. X.TP
  430. X\fBCANCEL\fR
  431. C-x
  432. X.TP
  433. X\fBBREAK\fR
  434. C-c,C-y
  435. X.TP
  436. X\fBEXIT\fR
  437. C-z
  438. X.PP
  439. In the following sections of this manual page the
  440. default key bindings are used instead of the
  441. names or functions.
  442. X.PP
  443. Some function keys are supported by \fButree\fR,
  444. i.e. the four arrow or cursor keys,
  445. and are bound to appropriate functions.
  446. See the sections \fIkey bindings\fR and \fIfunction keys\fR
  447. below for more details.
  448. X.SH HELP PAGES
  449. X.LP
  450. If the \fButree\fR help pages contained in the file \fButree.help\fR
  451. are accessible in a directory defined at compile time or defined in
  452. the environment variable \fBUTLIB\fR you can get help
  453. on all screens or from within the line editor
  454. with the help command (\fBh\fR or \fB?\fR) or the help key (\fBC-r\fR).
  455. After displaying help about your current context,
  456. i.e. help about tree commands if you are on the \fItree screen\fR,
  457. you can switch to the help menu and
  458. select help about all topics with a single keystroke.
  459. All \fIhelp screen\fR commmands and the menu items of the help menu
  460. displayed on the help line are:
  461. X.sp
  462. X.TP 16
  463. X\fBh\fR
  464. X(Help) About the help pages and the help menu
  465. X.TP
  466. X\fBa\fR
  467. X(About) Information about \fButree\fR and key naming conventions
  468. X.TP
  469. X\fBu\fR
  470. X(Usage) Description of \fButree\fR usage and commandline options
  471. X.TP
  472. X\fBg\fR
  473. X(Global) Global commands common for the \fItree\fR and the \fIfile screen\fR
  474. X.TP
  475. X\fBt\fR
  476. X(Tree) Commands for the \fItree screen\fR
  477. X.TP
  478. X\fBf\fR
  479. X(File) Commands for the \fIfile screen\fR
  480. X.TP
  481. X\fBe\fR
  482. X(Edit) Commands of the builtin line editor
  483. X.TP
  484. X\fBv\fR
  485. X(Vars) \fBUtree\fR variables and variable definition
  486. X.TP
  487. X\fBc\fR
  488. X(Cmds) Filetype commands and filetype command definition
  489. X.TP
  490. X\fBl\fR
  491. X(Line) Line format for user defined tree, file and filetype commands.
  492. X.TP
  493. X\fBk\fR
  494. X(Keys) Function keys used by \fButree\fR
  495. X.TP
  496. X\fBp\fR
  497. X(Patterns) File pattern matching, filename, modification time and
  498. file size patterns
  499. X.TP
  500. X\fBq\fR
  501. X(Quit)
  502. Leave \fIhelp screen\fR
  503. X.PP
  504. The help pages contain in short form most information given
  505. in the sections of this manual page.
  506. X.SH GLOBAL COMMANDS
  507. X.LP
  508. The following commands are common for the \fItree\fR and \fIfile screen\fR
  509. They can be given in lowercase or uppercase letters:
  510. X.sp
  511. X.TP 20
  512. X\fBC-z\fR
  513. XExit \fButree\fR from all screens
  514. X.TP
  515. X\fBC-c,C-y\fR
  516. Cancel or break current command or input
  517. X.TP
  518. X\fBC-l\fR
  519. Redisplay the current screen or the input line
  520. X.TP
  521. X\fBTAB,C-t\fR
  522. Move to the next tagged file or the next directory
  523. containing tagged files
  524. X.TP
  525. X\fBh,?,C-r\fR
  526. Display help pages and switch to the \fIhelp screen\fR
  527. and the help menu
  528. X.TP
  529. X\fB@,C-@\fR
  530. Mark the current directory or file
  531. X.TP
  532. X\fB#,C-g\fR
  533. Goto to a previously marked directory or file
  534. X.TP
  535. X\fBa\fR
  536. Display \fButree\fR version and copyright notice
  537. X.TP
  538. X\fBd\fR
  539. Display current date and time
  540. X.TP
  541. X\fBj\fR
  542. Move to the next directory or file (for vi fans)
  543. X.TP
  544. X\fBk\fR
  545. Move to the previous directory or file (for vi fans)
  546. X.TP
  547. X\fBn\fR
  548. Change sort criteria from lexical order to modification time order
  549. or vice versa and resort files in the file list
  550. X.TP
  551. X\fBt\fR
  552. Tag files matching a file pattern for further processing
  553. X.TP
  554. X\fBu\fR
  555. Untag files
  556. X.TP
  557. X\fBw\fR
  558. Display full pathname of the current directory
  559. X.TP
  560. X\fBz\fR
  561. Zoom files from filelist matching a file pattern
  562. X.TP
  563. X\fB=\fR
  564. Switch to the \fIvariables screen\fR,
  565. display and set or unset variables
  566. X.TP
  567. X\fB:\fR
  568. Switch to the \fIcommands screen\fR,
  569. display and set or unset
  570. filetype commands
  571. X.TP
  572. X\fB|\fR
  573. Switch to the \fIbindings screen\fR,
  574. display all key bindings
  575. and bind or rebind keys
  576. X.TP
  577. X\fB!\fR
  578. Switch to the \fIshell screen\fR, display all commands
  579. from the shell command history list, enter and execute
  580. commands not supported directly from \fButree\fR.
  581. Before a given command is executed the command line
  582. is searched for some sprintf like format characters
  583. lead in by a percent sign (%) which are expanded.
  584. See the section \fIline formats\fR for more
  585. information
  586. X.TP
  587. X\fB$\fR
  588. XEscape to an interactive shell
  589. X.SH TREE SCREEN COMMANDS
  590. X.LP
  591. All commands on the \fItree screen\fR can be given in
  592. lowercase or uppercase letters with the meaning denoted below.
  593. Commands given in lowercase letters affect the current directory only.
  594. Commands given in uppercase letters
  595. indicated by an uppercase letter in the table below
  596. affect the subtree rooted in the current directory
  597. or all tagged files in the subtree rooted in the current directory.
  598. The \fItree screen\fR commmands and the menu items of the
  599. default tree menu displayed on the help line are:
  600. X.sp
  601. X.TP 20
  602. X\fB>,CR,NL,SP,>\fR
  603. Change to the \fIfile screen\fR of the current directory
  604. X.TP
  605. X\fB<\fR
  606. Change to the \fIfile screen\fR of the parent directory
  607. X.TP
  608. X\fBC-n\fR
  609. Move to the next directory
  610. X.TP
  611. X\fBC-p\fR
  612. Move to the previous directory
  613. X.TP
  614. X\fBC-f\fR
  615. Move to the next directory on same level as the current directory
  616. X.TP
  617. X\fBC-b\fR
  618. Move to the previous directory on same level as the current directory
  619. X.TP
  620. X\fBC-v\fR
  621. Move one page forward
  622. X.TP
  623. X\fBC-w\fR
  624. Move one page backward
  625. X.TP
  626. X\fBC-a\fR
  627. Move to the beginning of the directory tree
  628. X.TP
  629. X\fBC-e\fR
  630. Move to the end of the directory tree
  631. X.TP
  632. X\fBTAB,C-t\fR
  633. Move to next the directory containing tagged files
  634. X.TP
  635. X\fBC-u\fR
  636. Scroll up one line the directory tree
  637. X.TP
  638. X\fBC-d\fR
  639. Scroll down one line the directory tree
  640. X.TP
  641. X\fB@,C-@\fR
  642. Mark the current directory
  643. X.TP
  644. X\fB#,C-g\fR
  645. Move to a previously marked directory
  646. X.TP
  647. X\fBh,?\fR
  648. X(Help) Help about \fItree screen\fR commands
  649. X.TP
  650. X\fBb,B\fR
  651. X(Backup) Backup the current directory or tree or
  652. backup all tagged files in the subtree
  653. X.TP
  654. X\fBc,C\fR
  655. X(Chdir) Move to a directory or copy all tagged files
  656. in the subtree. Before you move to a directory you are requested
  657. for the name of this directory before.
  658. Instead entering a name you can select a directory
  659. from the tree with C-n and C-p.
  660. Instead of entering a name of a directory
  661. where to copy the tagged files you can
  662. select a directory from the tree with C-n and C-p
  663. or directly from \fItree screen\fR using CR.
  664. X.TP
  665. X\fBf,F\fR
  666. X(Find) Find files in the current directory or subtree matching a
  667. file pattern you have to enter before.
  668. If a file matching the given pattern is found
  669. you may tag this file,
  670. change to the directory containing the found file
  671. or continue find
  672. X.TP
  673. X\fBg,G\fR
  674. X(Grep) Search for pattern in files in the current directory or subtree.
  675. You are requested for a file and a search pattern.
  676. If a file matching the search pattern is found
  677. you may tag this file,
  678. change to the directory containing the found file
  679. or continue search
  680. X.TP
  681. X\fBi\fR
  682. X(Info) Display some short information about the current directory.
  683. Displayed are access rights, modification time and
  684. the disk usage of the current directory or subtree
  685. X.TP
  686. X\fBl,L\fR
  687. X(List) List files in the current directory or subtree matching a file pattern
  688. you are requested before or list all tagged files in the subtree
  689. X.TP
  690. X\fBm,M\fR
  691. X(Mkdir) Create a new directory rooted in the current directory
  692. or move all tagged files to a destination directory.
  693. Instead of entering the directory name you can select
  694. this name from the directory tree with C-n and C-p
  695. or directly from \fItree screen\fR using CR.
  696. X.TP
  697. X\fBn,N\fR
  698. Change the sort criteria from lexical order to modification time order
  699. or vice versa and resort the file list of the current directory
  700. or subtree
  701. X.TP
  702. X\fBo\fR
  703. X(Out) Write a list of directories, files, tagged files,
  704. files matching a file pattern or a formatted tree list to a list file.
  705. A formatted tree list file can later be displayed on the screen
  706. or send to a printer using the additional filter command
  707. X\fButree.prlist\fR
  708. X.TP
  709. X\fBq\fR
  710. X(Quit) Leave the \fItree screen\fR and exit \fButree\fR
  711. X.TP
  712. X\fBr,R\fR
  713. X(Rmdir) Remove the current directory or all tagged files in
  714. the subtree.
  715. A directory to be removed may not
  716. contain any subdirectories.
  717. X.TP
  718. X\fBs\fR
  719. X(Stat) Switch to the \fIstatus screen\fR,
  720. display all status information of the current directory
  721. and change owner, group and access rights of the current directory
  722. X.TP
  723. X\fBt,T\fR
  724. X(Tag) Tag files in the current directory or subtree matching a file pattern
  725. you are requested before
  726. X.TP
  727. X\fBu,U\fR
  728. X(Untag) Untag files in the current directory or subtree
  729. X.TP
  730. X\fBz,Z\fR
  731. Zoom files matching a file pattern in the
  732. current directory or subtree.
  733. Zooming means that only those files mating the file pattern
  734. are displayed and visible for further processing.
  735. X.TP
  736. X\fB+\fR
  737. XEnlarge the tree window, shrink the file window one line
  738. X.TP
  739. X\fB-\fR
  740. Shrink the tree window, enlage the file window one line
  741. X.TP
  742. X\fB/\fR
  743. Scan the current directory or tree and rebuild directories
  744. if they need rebuilding
  745. X(i.e. if they are not yet read in or have changed)
  746. X.TP
  747. X\fB\e\fR
  748. Scan the current directory for subdirectories
  749. and build up and insert the subtree into the directory tree.
  750. You are requested for the maximal tree level to build up
  751. before
  752. X.TP
  753. X\fB0\fR
  754. Switch the tree menuline from the default to the user defined
  755. tree commands or vice versa
  756. X.TP
  757. X\fB1..9\fR
  758. XExecute the user defined tree command 1 .. 9
  759. X.PP
  760. XFor further information about file patterns for the commands find,
  761. grep, list, tag and untag see the section \fIfile patterns\fR below.
  762. XFor user defined tree commands see the section \fIvariables\fR.
  763. X.SH FILE SCREEN COMMANDS
  764. X.LP
  765. All commands on the \fIfile screen\fR can be given in lowercase
  766. or uppercase letters with the meaning denoted below.
  767. Commands given in lowercase letters  affect the current file only.
  768. Commands given in uppercase letters indicated by an uppercase letter
  769. in the table below affect
  770. all tagged (selected) files if files are tagged or the current
  771. file if no files are tagged.
  772. The file \fIscreen commmands\fR and the menu items of the
  773. default file menu displayed on the help line are:
  774. X.sp
  775. X.TP 20
  776. X\fBq,CR,NL,SP\fR
  777. X(Quit) Leave the \fIfile screen\fR and change back to the \fItree screen\fR
  778. X.TP
  779. X\fBC-f\fR
  780. Move to the next file
  781. X.TP
  782. X\fBC-b\fR
  783. Move to the previous file
  784. X.TP
  785. X\fBC-n\fR
  786. Move to the file on the next line
  787. X.TP
  788. X\fBC-p\fR
  789. Move to the file on the previous line
  790. X.TP
  791. X\fBC-v\fR
  792. Move one page forward
  793. X.TP
  794. X\fBC-w\fR
  795. Move one page backward
  796. X.TP
  797. X\fBC-a\fR
  798. Move to the beginning of the file list
  799. X.TP
  800. X\fBC-e\fR
  801. Move to the end of the file list
  802. X.TP
  803. X\fBTAB,C-t\fR
  804. Move to the next tagged file
  805. X.TP
  806. X\fBC-u\fR
  807. Scroll up one line the \fIfile screen\fR
  808. X.TP
  809. X\fBC-d\fR
  810. Scroll down one line the \fIfile screen\fR
  811. X.TP
  812. X\fB@,C-@\fR
  813. Mark the current file
  814. X.TP
  815. X\fB#,C-g\fR
  816. Move to a previously marked file
  817. X.TP
  818. X\fBh,?\fR
  819. X(Help) Help about \fIfile screen\fR commands and
  820. switch to the \fIhelp screen\fR
  821. X.TP
  822. X\fBc,C\fR
  823. X(Copy) Copy the current file or tagged files.
  824. You are requested for a destination file or directory
  825. where to copy the file or tagged files.
  826. Instead of entering a directory name you can select
  827. a destination directory using C-n and C-p or
  828. select directly on the \fItree screen\fR with CR
  829. X.TP
  830. X\fBe,E\fR
  831. X(Edit) Edit the current file or tagged files
  832. X.TP
  833. X\fBf\fR
  834. X(Find) Find files matching a file pattern you are requested before
  835. X.TP
  836. X\fBg,G\fR
  837. X(Grep) Search for a pattern in the current file or tagged files.
  838. Before search you are requested for a file pattern and the
  839. search pattern to search for
  840. X.TP
  841. X\fBi,I\fR
  842. Display some short information about the current file or tagged files.
  843. Displayed are the access rights, the size and the
  844. modification time of the current file or tagged files
  845. X.TP
  846. X\fBl,L\fR
  847. X(List) List files matching a file pattern you are requested before
  848. or all tagged files
  849. X.TP
  850. X\fBm,M\fR
  851. X(Move) Move or rename the current file or tagged files.
  852. You are requested for the new file name or a destination
  853. directory where to move the current file or tagged files
  854. Instead of entering the name of a destination directory
  855. you can select a directory using C-n and C-p
  856. or directly on the \fItree screen\fR with CR
  857. X.TP
  858. X\fBn\fR
  859. Change the sort criteria from lexical order to modification time order
  860. or vice versa and resort the file list
  861. X.TP
  862. X\fBp,P\fR
  863. X(Print) Print out the current file or tagged files
  864. X.TP
  865. X\fBr,R\fR
  866. X(Remove) Remove the current file or tagged files.
  867. Before removing you are asked if you really
  868. want to remove the current file or tagged files
  869. X.TP
  870. X\fBs,S\fR
  871. X(Stat) Switch to the \fIstatus screen\fR
  872. display all status information of the current or tagged files
  873. and change owner, group and access rights of
  874. the current file or tagged files
  875. X.TP
  876. X\fBt,T\fR
  877. X(Tag) Tag  the current file or files matching a file pattern
  878. you are requested before for further processing
  879. X.TP
  880. X\fBu,U\fR
  881. X(Untag) Untag the current file or files matching a file pattern
  882. you are requested before
  883. X.TP
  884. X\fBv,V\fR
  885. X(View) View the current file or tagged files
  886. X.TP
  887. X\fBx,X\fR
  888. XExecute the current file or tagged files.
  889. If a filetype command is defined for this file
  890. you can execute this filetype command,
  891. otherwise you are requested for a command
  892. or for parameters to execute
  893. X.TP
  894. X\fBz\fR
  895. Zoom files matching a file pattern
  896. X.TP
  897. X\fB>\fR
  898. If the current file is a directory
  899. change to the \fIfile screen\fR of this directory
  900. X.TP
  901. X\fB<\fR
  902. Change back to the \fIfile screen\fR of the parent directory
  903. X.TP
  904. X\fB/\fR
  905. Rebuild the file list (i.e. after shell escape)
  906. X.TP
  907. X\fB0\fR
  908. Switch the menuline from the default to the user defined
  909. file commands or vice versa
  910. X.TP
  911. X\fB1..9\fR
  912. XExecute the user defined file commands 1 .. 9
  913. X.PP
  914. XFor further information about file patterns for the commands find,
  915. grep, list, tag and untag see the section \fIfile patterns\fR below.
  916. XFor user defined file commands see the section
  917. X\fIvariables\fR.
  918. XFor filetype command execution invoked with the command \fBx\fR
  919. see the section \fIfiletype commands\fR below.
  920. X.SH LINE EDITOR COMMANDS
  921. X.LP
  922. Many \fButree\fR commands need some user input for
  923. further processing which is done with a builtin
  924. simple line editor.
  925. Many commands pre-set the input buffer with
  926. a default input line if this default is known.
  927. XFor some commands you can use the keys
  928. C-n and C-p to scroll in already existing
  929. input lists and select an input line
  930. for editing or processing
  931. without entering the line completely.
  932. The line editor knows about the following functions:
  933. X.sp
  934. X.TP 20
  935. X\fBCR,NL\fR
  936. Accept and send the input line
  937. X.TP
  938. X\fBC-c,C-y\fR
  939. Cancel input and leave the line editor
  940. X.TP
  941. X\fBC-o\fR
  942. Switch from overwrite-mode to insert-mode or vice versa
  943. X.TP
  944. X\fBC-l\fR
  945. Redisplay the input line
  946. X.TP
  947. X\fBC-f\fR
  948. Move the cursor one character forward
  949. X.TP
  950. X\fBC-b\fR
  951. Move the cursor one character backward
  952. X.TP
  953. X\fBC-a\fR
  954. Move the cursor to the beginning of the input line
  955. X.TP
  956. X\fBC-e\fR
  957. Move the cursor to the end of the input line
  958. X.TP
  959. X\fBC-v\fR
  960. Scroll horizontally forward the input line
  961. X.TP
  962. X\fBC-w\fR
  963. Scroll horizontally backward the input line
  964. X.TP
  965. X\fBC-d\fR
  966. Delete one character under the cursor
  967. X.TP
  968. X\fBC-h,DEL\fR
  969. Delete one character left from the cursor
  970. X.TP
  971. X\fBC-x\fR
  972. Delete the input line completely
  973. X.TP
  974. X\fBC-k\fR
  975. Delete the input line from the cursor position to the end
  976. X.TP
  977. X\fBC-t\fR
  978. Transpose two characters under and left from the cursor
  979. X.TP
  980. X\fBC-r\fR
  981. Display help pages and switch to the \fIhelp screen\fR
  982. X.TP
  983. X\fBC-@\fR
  984. Set a mark at the current cursor position
  985. X.TP
  986. X\fBC-g\fR
  987. Move the cursor to the previously marked position
  988. X.TP
  989. X\fBC-n\fR
  990. Get the next entry into the line editor
  991. X.TP
  992. X\fBC-p\fR
  993. Get the previous entry into the line editor
  994. X.PP
  995. All other printable characters are appended at the end of input line,
  996. inserted in insert-mode
  997. or overwrite the character under the cursor in overwrite-mode.
  998. The current mode is displayed at the end of the help line.
  999. Most line editor commands are also available with function keys,
  1000. see the section \fIfunction keys\fR below.
  1001. X.SH VARIABLES
  1002. X.LP
  1003. Utree knows about and uses the following variables which may be
  1004. set or unset at startup in the startupfile \fB$HOME/.utree\fR,
  1005. with some commandline options (see \fIoptions\fR above),
  1006. or the variables command (\fB=\fR) on the \fIvariables screen\fR:
  1007. X.sp
  1008. X.TP 20
  1009. X\fBBELL\fR
  1010. or \fBBL\fR: Allow ringing of the bell if set
  1011. X.TP
  1012. X\fBCLOCK\fR
  1013. or \fBCL\fR: Show and update clock every second if set
  1014. X.TP
  1015. X\fBGRAPHCHARS\fR
  1016. or \fBGC\fR: Use the graphical character set if set.
  1017. Not all terminal database termcap or terminfo
  1018. definitions of the graphical character set are
  1019. correct
  1020. X.TP
  1021. X\fBTERMSCROLL\fR
  1022. or \fBTS\fR: Use hardware terminal scrolling if set.
  1023. On some terminals (i.e. on the X terminal emulator xterm)
  1024. redrawing the screen may be faster than scrolling
  1025. X.TP
  1026. X\fBSCANTREE\fR
  1027. or \fBST\fR: Allow scanning the tree for changes if set.
  1028. Many commands scan the directory tree after execution
  1029. what may take some time.
  1030. Prohibiting tree scanning
  1031. therefore may speed up \fButree\fR a little bit
  1032. X.TP
  1033. X\fBWARNDIRS\fR
  1034. or \fBWD\fR: Allow warnings and requests about unreadable directories if set
  1035. X.TP
  1036. X\fBLEXSORT\fR
  1037. or \fBLS\fR: Sort filenames in lexical order if set,
  1038. in order of modification times if not set.
  1039. X.TP
  1040. X\fBAUTOSAVE\fR
  1041. or \fBAS\fR: Save changes in variables or filetype commands definitions,
  1042. key bindings and history list
  1043. to appropriate files in the home directory
  1044. X.TP
  1045. X\fBTREEINDENT\fR
  1046. or \fBTI\fR: Set the tree level indention column (3 .. 9) if possible.
  1047. Normally the tree level indention column is calculated dependent
  1048. on the number of screen columns and the maximal filesystem depth automatically
  1049. X.TP
  1050. X\fBVIDEOMODE\fR
  1051. or \fBVM\fR: Set using of video attributes.
  1052. X2 means use all possible attributes and their combinations.
  1053. X1 means use the attributes reverse and underline only.
  1054. X0 means don't use any video attribute.
  1055. X.TP
  1056. X\fBFILELINES\fR
  1057. or \fBFL\fR: Number of lines of the file window on the \fItree screen\fR
  1058. X(1 .. 9, default 3)
  1059. X.TP
  1060. X\fBHISTSIZE\fR
  1061. or \fBHS\fR: Maximal number of shell commands which are hold
  1062. in the shell commands history list (6 .. 99, default: 22)
  1063. X.TP
  1064. X\fBEDITOR\fR
  1065. or \fBED\fR: Program for editing files.
  1066. When redefining the editor variable don't forget to
  1067. check and set or unset the editopts variable for
  1068. editor options
  1069. X.TP
  1070. X\fBEDITOPTS\fR
  1071. or \fBEO\fR: File editor options
  1072. X.TP
  1073. X\fBPAGER\fR
  1074. or \fBPG\fR: Program for viewing files.
  1075. When redefining the pager variable don't forget to
  1076. check and set or unset the pageopts variable
  1077. for pager options
  1078. X.TP
  1079. X\fBPAGEOPTS\fR
  1080. or \fBPO\fR: File pager options
  1081. X.TP
  1082. X\fBXDUMPER\fR
  1083. or \fBXD\fR: Program for hexdumping files.
  1084. When redefining the hexdumper variable don't forget to
  1085. check and set or unset the xdumpopts variable
  1086. for hexdumper options
  1087. X.TP
  1088. X\fBXDUMPOPTS\fR
  1089. or \fBXO\fR: File hexdumper options
  1090. X.TP
  1091. X\fBLPRINTER\fR
  1092. or \fBLP\fR: Program for printing files or sending files to the
  1093. printer spooling system.
  1094. When redefining the lineprinter variable don't forget to
  1095. check and set or unset the lprintopts variable
  1096. for lineprinter options
  1097. X.TP
  1098. X\fBLPRINTOPTS\fR
  1099. or \fBLO\fR: Printer options
  1100. X.TP
  1101. X\fBBACKUP\fR
  1102. or \fBBK\fR: Program or shell script for backing up a directory or tree
  1103. X.TP
  1104. X\fBBACKUPOPTS\fR
  1105. or \fBBO\fR: Backup options
  1106. X.TP
  1107. X\fBSHELL\fR
  1108. or \fBSH\fR: Interactive shell for shell escape
  1109. X.TP
  1110. X\fBTREECMD1..9\fR
  1111. or \fBT1..9\fR: User defined \fItree screen\fR commands 1 .. 9
  1112. X.TP
  1113. X\fBFILECMD1..9\fR
  1114. or \fBF1..9\fR: User defined \fIfile screen\fR commands 1 .. 9
  1115. X.PP
  1116. Variables are set with a line '\fBvariable=value\fR'
  1117. or '\fBshorthand=value\fR'
  1118. X(i.e. '\fBtreecmd1=ps -ef\fR' or '\fBt1=ps -ef\fR')
  1119. and unset with a line '\fBvariable=\fR' or '\fBshorthand=\fR'
  1120. X(i.e. '\fBt1=\fR').
  1121. When defining user tree or file commands some sprintf
  1122. like format characters lead in by a percent sign (\fB%\fR) have a
  1123. special meaning and are expanded before the command is executed.
  1124. XFor further information about the command line format see the
  1125. section \fIline formats\fR below.
  1126. X.br
  1127. The last sharp sign (\fB#\fR) in a variable definition is used as leadin
  1128. for a menu item of the defined user file or tree command.
  1129. XExample: the variable definition '\fBfc1=wc -l %F #Count\fR' for the user
  1130. defined file command 1 is expanded to '\fBwc -l filename\fR'
  1131. and in the user command file menu '\fBCount\fR' is displayed
  1132. behind menu item 1.
  1133. X.SH FILETYPE COMMANDS
  1134. X.LP
  1135. On \fIfile screen\fR you can execute a file or a command on it
  1136. with the \fButree\fR execute command (\fBx\fR).
  1137. You are requested for parameters if the current file is executable,
  1138. for a command to execute on the
  1139. current file if it is not executable.
  1140. XFor a type of file you can define so called \fIfiletype commands\fR
  1141. which are called if the current file matches a given file pattern.
  1142. X.br
  1143. XFiletype commands can be set and unset at startup in
  1144. the startupfile \fB$HOME/.utree\fR,
  1145. with the commandline option \fB-d\fR
  1146. or the filetype command (\fB:\fR) similar
  1147. to setting and unsetting variables.
  1148. XFiletype commands are set with a line like '\fBfiletype:command\fR'
  1149. X(i.e. '\fB*.c:cc -c -O\fR').
  1150. The command (i.e. '\fBcc -c -O\fR') is then executed
  1151. if the current file matches the given file pattern
  1152. X(i.e. '\fB*.c\fR' for a C source file ending with '\fB.c\fR').
  1153. XFiletype commands are unset with a line '\fBfiletype:\fR'
  1154. X(i.e. '\fB*.c:\fR').
  1155. X.br
  1156. When defining filetype commands some sprintf like format characters
  1157. lead in by a percent sign (\fB%\fR) have a special meaning and are
  1158. expanded before the command is executed. For further information
  1159. about file patterns and the format line
  1160. characters and her meaning
  1161. see the sections \fIfile patterns\fR
  1162. and \fIline formats\fR below.
  1163. X.SH LINE FORMATS
  1164. X.LP
  1165. When defining a user tree or file command
  1166. or a filetype command some sprintf like format line
  1167. characters are known and expanded before the command is executed.
  1168. These format line characters and their meaning are:
  1169. X.sp
  1170. X.TP 20
  1171. X\fB%B\fR or \fB%b\fR
  1172. is expanded to the basename (filename without extension)
  1173. of the current file or directory
  1174. X.TP
  1175. X\fB%D\fR or \fB%d\fR
  1176. is expanded to the full pathname of the current directory
  1177. X.TP
  1178. X\fB%F\fR or \fB%f\fR
  1179. is expanded to the filename of the current file or directory
  1180. X.TP
  1181. X\fB%H\fR or \fB%h\fR
  1182. is expanded to the pathname of your home directory
  1183. X.TP
  1184. X\fB%P\fR or \fB%p\fR
  1185. is expanded to the full pathname of the current file or directory
  1186. X.TP
  1187. X\fB%R\fR or \fB%r\fR
  1188. is expanded to the pathname of the root directory
  1189. from where \fButree\fR was started
  1190. X.TP
  1191. X\fB%S\fR or \fB%s\fR
  1192. is expanded to additional parameter(s) for a command which are requested
  1193. before the command is executed
  1194. X.PP
  1195. The command line '\fBcommand %s %f >%b.out\fR' i.e. is expanded before execution
  1196. to '\fBcommand parameters filename >basename.out\fR'
  1197. with filename of the current file or directory (\fB%f\fR),
  1198. basename.out of the current file or directory (\fB%b.out\fR)
  1199. and additional parameters (\fB%s\fR)
  1200. which are requested before command execution.
  1201. X.br
  1202. XFor further information about tree, file and filetype commands
  1203. see the sections \fIvariables\fR and \fIfiletype commands\fR.
  1204. X.SH FILE PATTERNS
  1205. X.LP
  1206. Some commands (list, find, grep, tag or untag) require
  1207. file patterns for matching files using some
  1208. special (or meta) characters.
  1209. X.br
  1210. Shell like filename pattern matching interprets the
  1211. following meta characters:
  1212. X.sp
  1213. X.TP 20
  1214. X\fB*\fR
  1215. matches all characters in a filename
  1216. X.TP
  1217. X\fB?\fR
  1218. matches one character in a filename
  1219. X.TP
  1220. X\fB[class]\fR
  1221. matches one character from a character class.
  1222. A character class includes all characters enclosed between
  1223. the opening and closing brackets (\fB[\fR and \fB]\fR).
  1224. If in a class definition a minus sign (\fB-\fR) is found
  1225. between two other characters
  1226. this means the range from the character before and the
  1227. character behind the minus sign.
  1228. If the first character of a class definition is a exclamation mark
  1229. X(\fB!\fR) this means matching of all characters excluded those
  1230. defined in the class, i.e.
  1231. X.TP
  1232. X[abc]
  1233. matches the characters 'a', 'b' and 'c'
  1234. X.TP
  1235. X[a-z_]
  1236. matches the characters from 'a' to  'z' and '_'
  1237. X.TP
  1238. X[!a-z_]
  1239. matches all characters except 'a' to 'z' and '_'
  1240. X.PP
  1241. XFile size pattern matching interprets the following
  1242. meta characters:
  1243. X.sp
  1244. X.TP 20
  1245. X\fB=size\fR
  1246. matches all files of size \fBsize\fR
  1247. X.TP
  1248. X\fB!size\fR
  1249. matches all files not of size \fBsize\fR
  1250. X.TP
  1251. X\fB>size\fR
  1252. matches all files larger than \fBsize\fR
  1253. X.TP
  1254. X\fB<size\fR
  1255. matches all files smaller than \fBsize\fR
  1256. X.PP
  1257. Size may be specified in bytes (\fBb\fR, default),
  1258. kilo bytes (\fBk\fR) or mega bytes (\fBm\fR),
  1259. i.e. '\fB>2k\fR' matches all files larger than
  1260. X2 kilo bytes or 2048 bytes.
  1261. X.sp
  1262. X.PP
  1263. The additional file time pattern matching interprets the
  1264. following meta characters:
  1265. X.sp
  1266. X.TP 20
  1267. X\fB)time\fR
  1268. matches all files modified within \fBtime\fR
  1269. X.TP
  1270. X\fB(time\fR
  1271. matches all files not modified within \fBtime\fR
  1272. X.PP
  1273. Time may be specified in minutes (\fBm\fR),
  1274. hours (\fBh\fR, default), days (\fBd\fR) or weeks (\fBw\fR),
  1275. i.e. '\fB)2d\fR' matches all files modified within last 2 days.
  1276. X.sp
  1277. To combine shell like filename patterns and/or
  1278. additional file size and modification time patterns use
  1279. X.sp
  1280. X.TP 20
  1281. X\fB&\fR
  1282. for \fBAND\fRing of patterns
  1283. X.TP
  1284. X\fB|\fR
  1285. for \fBOR\fRing of patterns
  1286. X.PP
  1287. If a character is preceeded by a backslash or enclosed in quotes
  1288. his interpretation is suppressed and he is used as he is.
  1289. X.SH KEY BINDINGS
  1290. X.LP
  1291. All defaults key bindings are listed in the section
  1292. X\fIkey naming conventions and default key bindings\fR above.
  1293. All supported function keys if defined in the termcap or
  1294. terminfo terminal database and their default bindings
  1295. are listed in the next section.
  1296. Rebindings of default keys or additional bindings
  1297. of other keys may be done in terminal dependent
  1298. startupfiles \fButree-TERM\fR in a global directory
  1299. containing \fButree\fR startupfiles or in
  1300. files \fB.utree-TERM\fR in your home directory where \fBTERM\fR denotes
  1301. the terminal type as defined in the environment variable \fBTERM\fR.
  1302. These startup files are built from lines
  1303. like \fB'key_sequence=utree_key'\fR
  1304. or \fB'key_sequence="string"'\fR.
  1305. Key_sequence describes the function key string,
  1306. utree_key the \fButree\fR key or function name,
  1307. a string enclosed in braces a string to insert
  1308. into the input buffer.
  1309. A comment lead in by a sharp sign (#) should
  1310. contain the name of the bound key.
  1311. XFor defining key sequences of function keys
  1312. control keys are defined with a
  1313. leading caret (^, i.e. ^x, ^? means DEL)
  1314. and some other special characters
  1315. may be defined lead in by a backslash (\e).
  1316. These escaped characters and their meaning are:
  1317. b backspace (^h),  f formfeed (^l),
  1318. n newline (^j), r return (^m), t tab (^i),
  1319. e or E escape (^[ or ESC) and s space.
  1320. If a backslash is followed from up to three
  1321. digits this defines an octal given character.
  1322. I.e. the definition '\ee^O\e003=END' binds the
  1323. keystring <ESCAPE> <CONTROL-O> <ASCII-3> to the
  1324. X\fButree\fR key or function END.
  1325. X.PP
  1326. The simplest way to define keys is to switch
  1327. to the \fIbindings screen\fR and there to do all bindings.
  1328. You have only to hit the key to bind and terminate
  1329. the key sequence with CR or NL.
  1330. Therefore CR or NL or key sequences containing CR or NL
  1331. cannot be bound on the \fIbindings screen\fR.
  1332. Then you have to enter the \fButree\fR name where the key
  1333. is to bind to.
  1334. You can use C-n and C-p to select the wanted name.
  1335. At last you should give a short comment to the
  1336. bound key(i.e. the key name) for documentation.
  1337. If you want to bind a key for insertion of a string
  1338. X(and so to bind function keys to simple letter commands)
  1339. you have to enter the string enclosed in braces.
  1340. I.e. the binding \fB'\eeh="h"'\fR binds the
  1341. key <ESCAPE> <h> to the string <h> and the
  1342. so called help.
  1343. Any bindings you have done on the \fIbindings screen\fR
  1344. are saved to a file \fB.utree-TERM\fR into your home directory
  1345. if the variable AUTOSAVE is set.
  1346. X.SH FUNCTION KEYS
  1347. X.LP
  1348. The following function keys are supported by \fButree\fR
  1349. and pre-bound at startup to appropriate functions
  1350. if they are defined in your system's termcap or terminfo database:
  1351. X.sp
  1352. X.TP 20
  1353. X\fBCursorRight\fR
  1354. Move forward (FORWARD, \fBC-f\fR)
  1355. X.TP
  1356. X\fBCursorLeft\fR
  1357. Move backward (BACKWARD, \fBC-b\fR)
  1358. X.TP
  1359. X\fBCursorUp\fR
  1360. Move up (PREVIOUS, \fBC-p\fR)
  1361. X.TP
  1362. X\fBCursorDown\fR
  1363. Move down (NEXT, \fBC-n\fR)
  1364. X.TP
  1365. X\fBHome/Begin\fR
  1366. Move to beginning (BEGIN, \fBC-a\fR)
  1367. X.TP
  1368. X\fBEnd\fR
  1369. Move to end (END, \fBC-e\fR)
  1370. X.TP
  1371. X\fBNextPage/PageDown\fR
  1372. Move one page down (NEXTPAGE, \fBC-v\fR)
  1373. X.TP
  1374. X\fBPrevPage/PageUp\fR
  1375. Move one page up (PREVPAGE, \fBC-w\fR)
  1376. X.TP
  1377. X\fBScrollUp\fR
  1378. Scroll one line up (UP, \fBC-u\fR)
  1379. X.TP
  1380. X\fBScrollDown\fR
  1381. Scroll one line down or delecte character (DOWN, \fBC-d\fR)
  1382. X.TP
  1383. X\fBInsert\fR
  1384. Change to directory (\fB>\fR) or
  1385. switch insert/overwrite mode (INSERT, \fBC-o\fR)
  1386. X.TP
  1387. X\fBDelete\fR
  1388. Change to parent directory (\fB<\fR)
  1389. or delete character under cursor like (DELETE, \fBC-h\fR)
  1390. X.TP
  1391. X\fBClear\fR
  1392. Refresh screen or input line (REFRESH, \fBC-l\fR)
  1393. X.TP
  1394. X\fBHelp\fR
  1395. Call the help menu (HELP, \fBC-r\fR)
  1396. X.TP
  1397. X\fBSelect\fR
  1398. Select and/or accept (SELECT, \fBCR,NL\fR)
  1399. X.TP
  1400. X\fBDo/Command\fR
  1401. Select and/or accept (SELECT, \fBCR,NL\fR)
  1402. X.TP
  1403. X\fBMark\fR
  1404. Set a mark (SETMARK, \fBC-@\fR)
  1405. X.TP
  1406. X\fBEnter\fR
  1407. Select and/or accept (SELECT, \fBCR,NL\fR)
  1408. X.PP
  1409. This function keys may be rebound
  1410. or other function keys may be bound
  1411. on the \fIbindings screen\fR.
  1412. XFor more information about key bindings
  1413. see the section \fBkey bindings\fR above.
  1414. X.SH ENVIRONMENT
  1415. X.LP
  1416. X.TP 20
  1417. X\fBUTREE\fR
  1418. Some boolean and numerical settings for \fButree\fR
  1419. X.TP
  1420. X\fBUTLIB\fR
  1421. Directory for \fButree\fR help pages and startup files
  1422. X.TP
  1423. X\fBHOME\fR
  1424. User's home directory
  1425. X.TP
  1426. X\fBTERM\fR
  1427. Terminal type
  1428. X.TP
  1429. X\fBEDITOR\fR
  1430. XFile editor
  1431. X.TP
  1432. X\fBPAGER\fR
  1433. XFile pager/viewer
  1434. X.TP
  1435. X\fBSHELL\fR
  1436. Interactive shell for shell escape
  1437. X.PP
  1438. X.SH FILES
  1439. X.LP
  1440. X.TP 20
  1441. X\fBHOME/.utreelist\fR
  1442. Tree list file of user's filesystem
  1443. X.TP
  1444. X\fBHOME/.utreehist\fR
  1445. History list of shell commands
  1446. X.TP
  1447. X\fBHOME/.utree\fR
  1448. User's \fButree\fR startup file
  1449. containing variables and filetype commands definitions
  1450. X.TP
  1451. X\fBUTLIB/utree\fR
  1452. Global \fButree\fR startup file
  1453. containing variables and filetype commands definitions
  1454. X.TP
  1455. X\fBUTLIB/utree-TERM\fR
  1456. Global key bindings for terminal type TERM
  1457. X.TP
  1458. X\fBHOME/.utree-TERM\fR
  1459. User's key bindings for terminal type TERM
  1460. X.TP
  1461. X\fBUTLIB/utree.help\fR
  1462. X\fBUtree\fR help pages
  1463. X.TP
  1464. X\fBBIN/utree.backup\fR
  1465. Backup shell script or program
  1466. X.TP
  1467. X\fBBIN/utree.mklist\fR
  1468. Create directory tree list shell script
  1469. X.TP
  1470. X\fBBIN/utree.prlist\fR
  1471. Display or print a formatted tree list file
  1472. X.PP
  1473. X\fBUTLIB\fR can be a system default directory containing
  1474. library files (i.e. /usr/local/lib)
  1475. defined at compile time or a directory defined in the
  1476. environment variable \fBUTLIB\fR.
  1477. X\fBBIN\fR is a public directory containing executable
  1478. files (i.e. /usr/local/bin) and should be
  1479. included in the command search path environment variable \fBPATH\fR.
  1480. X.SH SEE ALSO
  1481. X.LP
  1482. utree.prlist(1L)
  1483. X.br
  1484. cp(1) grep(1) ls(1) mv(1) rm(1)
  1485. X.br
  1486. du(1) mkdir(1) rmdir(1)
  1487. X.br
  1488. find(1) sh(1)
  1489. X.SH BUGS
  1490. X.LP
  1491. Changes in filesystem after shell escape or editor session
  1492. are not always detected.
  1493. X.br
  1494. Directory tree depth >32 may be confusing.
  1495. X.br
  1496. Screen sizes smaller than 80x24 may be confusing.
  1497. X.br
  1498. Symbolic links to directories may be confusing.
  1499. X.br
  1500. On most BSD systems changing owner and/or group of files
  1501. for normal users is not allowed.
  1502. X.SH AUTHOR
  1503. X.LP
  1504. Peter Klingebiel
  1505. X.SH COPYRIGHT
  1506. X.LP
  1507. X\(co 1991/1992 Peter Klingebiel & UNIX Magazin Munich
  1508. X.sp
  1509. Permission is granted to copy and distribute \fButree\fR in modified
  1510. or unmodified form, for noncommercial use, provided (a) this copyright
  1511. notice is preserved, (b) no attempt is made to restrict redistribution
  1512. of this file, and (c) this file is not distributed as part of any
  1513. collection whose redistribution is restricted by a compilation copyright.
  1514. X
  1515. END_OF_FILE
  1516. if test 43554 -ne `wc -c <'doc/utree.1'`; then
  1517.     echo shar: \"'doc/utree.1'\" unpacked with wrong size!
  1518. fi
  1519. # end of 'doc/utree.1'
  1520. fi
  1521. echo shar: End of archive 7 \(of 8\).
  1522. cp /dev/null ark7isdone
  1523. MISSING=""
  1524. for I in 1 2 3 4 5 6 7 8 ; do
  1525.     if test ! -f ark${I}isdone ; then
  1526.     MISSING="${MISSING} ${I}"
  1527.     fi
  1528. done
  1529. if test "${MISSING}" = "" ; then
  1530.     echo You have unpacked all 8 archives.
  1531.     rm -f ark[1-9]isdone
  1532. else
  1533.     echo You still need to unpack the following archives:
  1534.     echo "        " ${MISSING}
  1535. fi
  1536. ##  End of shell archive.
  1537. exit 0
  1538.