home *** CD-ROM | disk | FTP | other *** search
/ vsiftp.vmssoftware.com / VSIPUBLIC@vsiftp.vmssoftware.com.tar / FREEWARE / FREEWARE40.ZIP / flistfrontend / doc / db.rno < prev    next >
Encoding:
Text File  |  1995-10-27  |  32.0 KB  |  1,088 lines
  1. .; $Id: db.rno,v 1.3 1995/10/27 13:25:39 tom Exp $
  2. .; This is the help-file for FLIST.  The following variants are possible:
  3. .;
  4. .;    PAGED - format for document
  5. .;    FILE - run with normal RUNOFF options
  6. .;    LIB - run with RUNOFF/NOUNDERLINE/VARIANT=LIB
  7. .;
  8. .if paged
  9. .req "d0.req"
  10. .else paged
  11. .npa.nhd.dix.fl bold
  12. .endif paged
  13. .rm 77
  14. .if lib
  15. .lm0;1 FLIST - Directory Editor
  16. .else lib
  17. .if file
  18. .lm0;^&FLIST_ -_ Directory_ Editor\&
  19. .else file
  20. .lm0;^*FLIST - Directory Editor\*
  21. .endif file
  22. .endif lib
  23. .lm 2.b
  24. FLIST (directory management system/file-list)
  25. permits the user to sort directories, examine files, delete
  26. rename or alter the protection code on files,
  27. all via a dynamic display.
  28. .b
  29. Format:
  30. .b
  31.     FLIST [_*._*;_*]
  32. .rm -2.ts 17,31,45
  33. .; 19,35,51
  34.  
  35. .x /AFTER qualifier
  36. .if lib
  37. .lm0;2 /AFTER#############
  38. .br.lm1
  39. .else lib
  40. .b2.lm0;^*Options:\*
  41. .lm2
  42. .lm +15
  43. .b.i-15;/AFTER    
  44. .nsp
  45. .endif lib
  46. /AFTER=time
  47. .sk1
  48. Same as /SINCE.
  49. .sk1
  50. Selects only those files that are dated after the specified time.
  51. .sk1
  52. You must specify an absolute time.
  53. See  Section 2.5 in the VAX/VMS  DCL Dictionary
  54. (or  access  the  HELP topic SPECIFY) for  complete  information  on
  55. specifying  time  values.
  56. You  can  also  use the  keywords  TODAY, TOMORROW, and YESTERDAY.
  57. .;
  58. .x /ALL qualifier
  59. .if lib
  60. .lm0;2 /ALL#(D)###########
  61. .br.lm1
  62. .else lib
  63. .b.i-15;/ALL (D)    
  64. .nsp
  65. .endif lib
  66. Read directory entries for all filenames, even if insufficient privilege.
  67. .;
  68. .x /BACKUP qualifier
  69. .if lib
  70. .lm0;2 /BACKUP############
  71. .br.lm1
  72. .else lib
  73. .b.i-15;/BACKUP    
  74. .nsp
  75. .endif lib
  76. Selects files according to the dates of  their  most  recent  backup.
  77. This qualifier is relevant only when used with the /BEFORE or /SINCE
  78. qualifier.  Use  of  the  /BACKUP  qualifier  is  incompatible  with
  79. /CREATED, /EXPIRED, and /MODIFIED.  /CREATED is the default.
  80. .sk1
  81. /BACKUP implicitly sets /DBACKUP.
  82. .;
  83. .x /BEFORE qualifier
  84. .if lib
  85. .lm0;2 /BEFORE############
  86. .br.lm1
  87. .else lib
  88. .b.i-15;/BEFORE    
  89. .nsp
  90. .endif lib
  91. /BEFORE=time
  92. .sk1
  93. Selects only those files that are dated before the specified time.
  94. .sk1
  95. You must specify an absolute time.
  96. See  Section 2.5 in the VAX/VMS  DCL Dictionary
  97. (or  access  the  HELP topic SPECIFY) for  complete  information  on
  98. specifying  time  values.
  99. You  can  also  use the  keywords  TODAY, TOMORROW, and YESTERDAY.
  100. .;
  101. .x /COMMAND qualifier
  102. .if lib
  103. .lm0;2 /COMMAND###########
  104. .br.lm1
  105. .else lib
  106. .b.i-15;/COMMAND    
  107. .nsp
  108. .endif lib
  109. Read commands from the specified file
  110. (default FLIST.CMD in your login directory).
  111. On end-of-file, resume interactively.
  112. .;
  113. .x /CREATED qualifier
  114. .if lib
  115. .lm0;2 /CREATED###########
  116. .br.lm1
  117. .else lib
  118. .b.i-15;/CREATED    
  119. .nsp
  120. .endif lib
  121. Selects files based on their date of  creation.   This  qualifier  is
  122. relevant  only  when used with the /BEFORE or /SINCE qualifier.  Use
  123. of the /CREATED qualifier is incompatible  with  /BACKUP,  /EXPIRED,
  124. and /MODIFIED.  /CREATED is the default.
  125. .;
  126. .x /DBACKUP qualifier
  127. .if lib
  128. .lm0;2 /DBACKUP###########
  129. .br.lm1
  130. .else lib
  131. .b.i-15;/DBACKUP    
  132. .nsp
  133. .endif lib
  134. Show backup dates instead of creation dates
  135. .;
  136. .x /DREVISED qualifier
  137. .if lib
  138. .lm0;2 /DREVISED##########
  139. .br.lm1
  140. .else lib
  141. .b.i-15;/DREVISED    
  142. .nsp
  143. .endif lib
  144. Show file revision dates instead of creation dates
  145. .;
  146. .x /FAST qualifier
  147. .if lib
  148. .lm0;2 /FAST##############
  149. .br.lm1
  150. .else lib
  151. .b.i-15;/FAST    
  152. .nsp
  153. .endif lib
  154. Suppress all fields other than the filename (_*3 faster)
  155. .;
  156. .x /LOG qualifier
  157. .if lib
  158. .lm0;2 /LOG###############
  159. .br.lm1
  160. .else lib
  161. .b.i-15;/LOG    
  162. .nsp
  163. .endif lib
  164. Record commands, informational- and error- messages in a log-file
  165. (default FLIST.LOG in your login directory).
  166. .;
  167. .x /MODIFIED qualifier
  168. .if lib
  169. .lm0;2 /MODIFIED##########
  170. .br.lm1
  171. .else lib
  172. .b.i-15;/MODIFIED    
  173. .nsp
  174. .endif lib
  175. Selects files  according  to  the  dates  on  which  they  were  last
  176. modified.
  177. This  qualifier  is  relevant  only  when  used with the
  178. /BEFORE or /SINCE qualifier.  Use  of  the  /MODIFIED  qualifier  is
  179. incompatible  with /BACKUP, /CREATED, and /EXPIRED.  /CREATED is the
  180. default.
  181. .sk1
  182. /MODIFIED implicitly sets /DREVISED
  183. .;
  184. .x /NOALL qualifier
  185. .if lib
  186. .lm0;2 /NOALL#############
  187. .br.lm1
  188. .else lib
  189. .b.i-15;/NOALL    
  190. .nsp
  191. .endif lib
  192. Suppress filename if no privilege for other data
  193. .;
  194. .x /NODATE qualifier
  195. .if lib
  196. .lm0;2 /NODATE############
  197. .br.lm1
  198. .else lib
  199. .b.i-15;/NODATE    
  200. .nsp
  201. .endif lib
  202. Suppress creation-date+time
  203. .;
  204. .if lib
  205. .lm0;2 /NOFAST#(D)########
  206. .br.lm1
  207. .else lib
  208. .b.i-15;/NOFAST    
  209. .nsp
  210. .endif lib
  211. Open each file to obtain auxiliary information (e.g., date, size).
  212. .;
  213. .x /NOOWNER qualifier
  214. .if lib
  215. .lm0;2 /NOOWNER###########
  216. .br.lm1
  217. .else lib
  218. .b.i-15;/NOOWNER    
  219. .nsp
  220. .endif lib
  221. Suppress display of owner code
  222. .;
  223. .x /NOPROTECTION qualifier
  224. .if lib
  225. .lm0;2 /NOPROTECTION######
  226. .br.lm1
  227. .else lib
  228. .b.i-15;/NOPROTECTION    
  229. .nsp
  230. .endif lib
  231. Suppress display of protection mask
  232. .;
  233. .x /NOSIZE qualifier
  234. .if lib
  235. .lm0;2 /NOSIZE############
  236. .br.lm1
  237. .else lib
  238. .b.i-15;/NOSIZE    
  239. .nsp
  240. .endif lib
  241. Suppress allocation (size) data
  242. .;
  243. .x /NOVERSIONS qualifier
  244. .if lib
  245. .lm0;2 /NOVERSIONS########
  246. .br.lm1
  247. .else lib
  248. .b.i-15;/NOVERSIONS    
  249. .nsp
  250. .endif lib
  251. Show only highest version of each file
  252. .;
  253. .x /SINCE qualifier
  254. .if lib
  255. .lm0;2 /SINCE#############
  256. .br.lm1
  257. .else lib
  258. .b.i-15;/SINCE    
  259. .nsp
  260. .endif lib
  261. /SINCE=time
  262. .sk1
  263. Selects only those files that are dated after the specified time.
  264. .sk1
  265. You must specify an absolute time.
  266. See  Section 2.5 in the VAX/VMS  DCL Dictionary
  267. (or  access  the  HELP topic SPECIFY) for  complete  information  on
  268. specifying  time  values.
  269. You  can  also  use the  keywords  TODAY, TOMORROW, and YESTERDAY.
  270.  
  271. .if lib
  272. .lm0;2 Commands###########
  273. .else lib
  274. .b2
  275. .lm0;^*Commands:\*
  276. .endif lib
  277. .lm2.b
  278. FLIST's commands are listed below
  279. (capital letters indicate the allowable abbreviation).
  280. .lm2.b
  281. Main    Alternate    Description
  282. .lm2.br.rpt 73 "-"
  283. .lm +29
  284. .x HELP, show command summary
  285. .x ?HELP, show command summary
  286. .i-29;Help    ?help    Show this helpfile.
  287. .x QUIT
  288. .x Key assignments>CTRL/Z, quit
  289. .x CTRL/Z, quit
  290. .i-29;Quit    CTRL/Z    Quit the current directory level.
  291. A numeric argument causes FLIST to quit that many times
  292. .x SHELL
  293. .x Spawned subprocesses>SHELL
  294. .i-29;SHell        Spawn DECShell process, return to FLIST on LOGOFF
  295. .x SPAWN
  296. .x Spawned subprocesses>SPAWN
  297. .i-29;SPawn        Spawn new process, return to FLIST on LOGOFF
  298. .lm2.br.rpt 73 "-"
  299. .c;(The following use arguments; most imply the current entry)
  300. .lm2.br.rpt 73 "-"
  301. .lm +29
  302. .x File management>APPEND
  303. .x APPEND
  304. .x Spawned subprocesses>APPEND
  305. .i-29;APpend        Append the current file to the argument
  306. .x File management>COPY
  307. .x COPY
  308. .x Spawned subprocesses>COPY
  309. .i-29;COpy        Copy the current file to the argument
  310. .x File management>CREATE
  311. .x CREATE
  312. .x Spawned subprocesses>CREATE
  313. .i-29;CReate        Create the specified file or directory
  314. .x File management>DELETE
  315. .x DELETE
  316. .i-29;DELete        Delete the current file
  317. .x File management>EDIT
  318. .x EDIT
  319. .x Spawned subprocesses>EDIT
  320. .i-29;Edit        Edit (if file), else enter new directory level.
  321. .x Searching>FIND
  322. .x FIND
  323. .i-29;Find        Search for the filename specified as argument
  324. .x Display commands>INSPECT
  325. .x INSPECT
  326. .i-29;Inspect        Inspect files, showing source-format.
  327. .x Browsing>BROWSE
  328. .x BROWSE
  329. .i-29;Browse        Run BROWSE to display the current file.
  330. .x Searching>NEXT
  331. .x NEXT
  332. .x Searching>CTRL/N, NEXT
  333. .x Key assignments>CTRL/N, NEXT
  334. .x CTRL/N, NEXT
  335. .i-29;Next    CTRL/N    Search for next occurrence of filename.
  336. .x Searching>NFIND
  337. .x NFIND
  338. .i-29;NFind        Search for entry not matching pattern.
  339. .x File management>PRINT
  340. .x PRINT
  341. .x Spawned subprocesses>PRINT
  342. .i-29;PRint        Enqueue the file to be printed
  343. .x File management>PROTECT
  344. .x PROTECT, change protection
  345. .x Key assignments>CTRL/P, protection edit
  346. .x CTRL/P, protection edit
  347. .i-29;PROtect    CTRL/P    Enter protection-code edit
  348. .x File management>PURGE
  349. .x PURGE
  350. .i-29;PURge        Delete lower versions of the current file
  351. .x File management>RENAME
  352. .x RENAME
  353. .i-29;REName        Rename the current file (requires arguments)
  354. .x SUBMIT
  355. .x Spawned subprocesses>SUBMIT
  356. .i-29;Submit        Submit the current file as a BATCH job.
  357. .x Browsing>VIEW
  358. .x VIEW
  359. .x Spawned subprocesses>VIEW
  360. .i-29;View        EDIT/READONLY
  361. .lm2.br.rpt 73 "-"
  362.  
  363. .if lib
  364. .lm0;2 Direction##########
  365. .else lib
  366. .b2
  367. .lm0;^*Direction:\*
  368. .endif lib
  369. .lm2.b
  370. /FORWARD and /BACKWARD set the current-direction flag, used by /PAGE
  371. to determine the direction of scrolling.
  372. Each of these commands accepts a single argument: number of lines.
  373. If no argument is given, the amount of scrolling is one screen.
  374.  
  375. .if lib
  376. .lm0;2 Display############
  377. .else lib
  378. .b2.lm0;^*Display:\*
  379. .endif lib
  380. .lm2.b
  381. .x Display commands
  382. The only fixed-fields in FLIST's display format are the filename, filetype and
  383. version.
  384. The pathname for the current-file is automatically displayed in the
  385. summary line.
  386. The "/d"-commands alter the DATE-field to alternate formats to
  387. permit different date-sorting.  The "/columns" command permits the user to set
  388. the display to any combination of fields for which FLIST has read the data:
  389. .lm2.b
  390. .lm2.br.rpt 73 "-"
  391. .lm +29
  392. .x DATE-toggle>/DCREATED
  393. .x /DCREATED, toggle DATE to CREATED
  394. .i-29;/Dcreated        Toggle date-display to CREATED
  395. .x DATE-toggle>/DBACKUP
  396. .x /DBACKUP, toggle DATE to BACKUP
  397. .i-29;/DBackup        Toggle date-display to BACKUP
  398. .x DATE-toggle>/DREVISED
  399. .x /DREVISED, toggle DATE to REVISED
  400. .i-29;/DRevised        Toggle date-display to REVISED
  401. .x DATE-toggle>/DSHORT
  402. .x Date format>/DSHORT
  403. .x /DSHORT, set short date format
  404. .i-29;/DShort        Set date to short-format
  405. .x DATE-toggle>/DLONG
  406. .x Date format>/DLONG
  407. .x /DLONG, set long date format
  408. .i-29;/DLong        Show date in long (day-of-week) format
  409. .lm2.br.rpt 73 "-"
  410. .lm +29
  411. .x Display commands>/COLUMNS
  412. .x /COLUMNS, set column-list
  413. .x Column-list>/COLUMNS
  414. .i-29;/Columns        (see keyword list)
  415. .x Column-rotation>/CLEFT
  416. .x /CLEFT, rotate column-list
  417. .i-29;/CLeft        Rotates list to the left
  418. .x Column-rotation>/CRIGHT
  419. .x /CRIGHT, rotate column-list
  420. .i-29;/CRight        Rotates list to the right
  421. .x Column-width>/CWIDTH
  422. .x /CWIDTH, set column width
  423. .i-29;/CWIDTH        Set name.type column width
  424. .x Display commands>/TIMES
  425. .x /TIMES, reset timer
  426. .i-29;/TImes        Display, reset elapsed, actual CPU times
  427. .lm2.br.rpt 73 "-"
  428. .;
  429. .if lib
  430. .lm0;3 Keywords
  431. .else lib
  432. .b2.lm4;^*Keywords:\*
  433. .endif lib
  434. .b.lm2.rm -2
  435. .x Column keywords
  436. .x Column keywords>ALLOC
  437. .x Column keywords>BACKUP
  438. .x Column keywords>CREATED
  439. .x Column keywords>DATE
  440. .x Column keywords>EXPIRED
  441. .x Column keywords>FORMAT
  442. .x Column keywords>ID
  443. .x Column keywords>LENGTH
  444. .x Column keywords>MASK
  445. .x Column keywords>OWNER
  446. .x Column keywords>PATH
  447. .x Column keywords>REVISED
  448. .x Column keywords>SIZE
  449. .x Column keywords>XAB
  450. Column keywords include:  ALLOC,  BACKUP,  CREATED,  DATE, EXPIRED, FORMAT,
  451. ID, LENGTH, MASK, OWNER,
  452. PATH, REVISED, SIZE, USER and XAB (record attributes).
  453. For example, the standard
  454. display is:
  455. .b.c;/columns size date mask
  456. .b
  457. Only the first character of each keyword need be given.  If an asterisk  "_*"
  458. is given, the entire prior list is entered.
  459. This provides a convenient  means to append to the list.
  460. .rm+2
  461. .;
  462. .if lib
  463. .lm0;3 Width
  464. .else lib
  465. .b2.lm4;^*Width:\*
  466. .endif lib
  467. .b.lm2.rm-2
  468. FLIST normally sets the displayed width of the filename and filetype to
  469. the maximum of any file in the list, so that all names and types will fall
  470. into columns.
  471. Under VMS 4.x, name- and type-components may be quite long
  472. (39 characters each).
  473. The resulting display may not fit well on your terminal.
  474. You may override the column-width by the /CWIDTH command:
  475. .b;.i4;/CWIDTH n.t
  476. .b;for example
  477. .b.i4;/CWIDTH 9.3
  478. .b;If you do not give an argument, FLIST resets the display to its default
  479. state; either "n" or "t" may be defaulted.
  480. .rm+2
  481.  
  482. .if lib
  483. .lm0;2 Hierarchy##########
  484. .else lib
  485. .b2.lm0;^*Hierarchy:\*
  486. .endif lib
  487. .lm2.b
  488. .x Display hierarchy
  489. FLIST permits you to enter up to eight display levels (counting the original
  490. invocation).
  491. FLIST assumes a new level if you EDIT a directory, if your EDIT command
  492. implies a wildcard (e.g., inexplicit version number), or if you explicitly
  493. edit a directory which is not in the current display list.
  494. Column settings are inherited as you enter a new level, and restored
  495. as you exit.
  496. .b
  497. On entry to a new level, the date-selection options are reset
  498. (i.e., "_/BEFORE" and "_/SINCE").
  499. You may use the date-selection options in your initial EDIT-directory
  500. call on a new level.
  501.  
  502. .if lib
  503. .lm0;2 Keypad#############
  504. .else lib
  505. .b2.lm0;^*Keypad:\*
  506. .endif lib
  507. .lm2.b
  508. The keypad functions provided by FLIST are, where possible, analogous to  the
  509. ones of the EDT editor.  Those indicated in "{...}" differ from the functions
  510. afforded by typing the command directly:
  511. .lm +10
  512. .b.i -5
  513. {recall} - retrieves the prior command text.
  514. The "-" (non-keypad) itself does only a one-level recall.
  515. The command history stores up to 30 levels.
  516. Once in command-edit, up/down arrows may be used to select  a
  517. previous command-string.
  518. .b.i -5
  519. /mark and /nomark - select/deselect a file entry for successive fixed-point
  520. sorting.
  521. .lm -10
  522. .if paged
  523. .tp24
  524. .endif paged
  525. .b.ts 17,45
  526. Key    (Without GOLD)    (With GOLD)
  527. .lm2.br.rpt 73 "-"
  528. .x Key assignments>PF1, GOLD
  529. .x PF1, GOLD
  530. .br;PF1    {GOLD}    {GOLD}
  531. .x Key assignments>PF2, HELP
  532. .x PF2, HELP
  533. .br;PF2    HELP    HELP
  534. .x Key assignments>PF3>NEXT
  535. .x PF3>NEXT
  536. .x Key assignments>PF3>FIND (GOLD)
  537. .x PF3>FIND (GOLD)
  538. .br;PF3    NEXT    FIND
  539. .x Key assignments>PF4>column-rotation
  540. .x PF4>column-rotation
  541. .br;PF4    /CLEFT    /CRIGHT
  542. .x Key assignments>Keypad#0>sort by NAME
  543. .x Keypad#0>sort by NAME
  544. .br;0    /SNAME    /RNAME
  545. .x Key assignments>Keypad#1, sort by TYPE
  546. .x Keypad#1, sort by TYPE
  547. .br;1    /STYPE    /RTYPE
  548. .x Key assignments>Keypad#2>sort by DATE
  549. .x Keypad#2>sort by DATE
  550. .br;2    /SDATE    /RDATE
  551. .x Key assignments>Keypad#3, sort by SIZE
  552. .x Keypad#3, sort by SIZE
  553. .br;3    /SSIZE    /RSIZE
  554. .x Key assignments>Keypad#4>scroll forward
  555. .x Keypad#4>scroll forward
  556. .x Key assignments>Keypad#4>scroll to end (GOLD)
  557. .x Keypad#4>scroll to end (GOLD)
  558. .br;4    /FORWARD#0    /END
  559. .x Key assignments>Keypad#5>scroll backward
  560. .x Keypad#5>scroll backward
  561. .x Key assignments>Keypad#5>scroll to top (GOLD)
  562. .x Keypad#5>scroll to top (GOLD)
  563. .br;5    /BACKWARD#0    /TOP
  564. .x Key assignments>Keypad#6>display timer
  565. .x Keypad#6>display timer
  566. .x Key assignments>Keypad#6>reset timer (GOLD)
  567. .x Keypad#6>reset timer (GOLD)
  568. .br;6    ?TIMES    /TIMES
  569. .x Key assignments>Keypad#7>EDIT
  570. .x Keypad#7>EDIT
  571. .x Key assignments>Keypad#7>VIEW (GOLD)
  572. .x Keypad#7>VIEW (GOLD)
  573. .br;7    EDIT    VIEW
  574. .x Key assignments>Keypad#8, scroll up or down
  575. .x Keypad#8, scroll up or down
  576. .br;8    /PAGE    {}
  577. .x Key assignments>Keypad#9, BROWSE
  578. .x Keypad#9, BROWSE
  579. .br;9    BROWSE    BROWSE/O:3/M
  580. .x Key assignments>Keypad#"-", recall
  581. .x Keypad#"-", recall
  582. .br;_-    {recall}    {recall}
  583. .br;_,    ?MEMORY    {}
  584. .x Key assignments>Keypad#".", Fixed-point sorting
  585. .x Keypad#".", Fixed-point sorting
  586. .br;_.    /MARK    /NOMARK
  587. .br;ENTER    {return}    {return}
  588. .lm2.br.rpt 73 "-"
  589.  
  590. .if lib
  591. .lm0;2 Line-editing#######
  592. .else lib
  593. .b2.lm0;^*Line-editing:\*
  594. .endif lib
  595. .lm2.b.ts 17,31,45
  596. .x Line editing
  597. Any non-editing command may be given to FLIST by typing the abbreviation (with
  598. printable characters) next to the file.
  599. These commands are terminated with an ENTER or RETURN.
  600. .x Key assignments>Return key>enter command
  601. .x Return key>enter command
  602. .x Key assignments>ENTER key>enter command
  603. .x ENTER key>enter command
  604. All printing characters are echoed (and highlighted, if  the
  605. terminal permits).
  606. The input command may be edited:
  607. .lm2.b
  608. Key    (also)    Operation
  609. .lm2.br.rpt 73 "-"
  610. .lm +29
  611. .i-29;{printing}        Insert printing characters at the cursor.
  612. .x Key assignments>Backspace key>move to beginning of line
  613. .x Backspace key>move to beginning of line
  614. .x Key assignments>Keypad#0>move to beginning of line
  615. .x Keypad#0>move to beginning of line
  616. .i-29;{backspace}    {keypad-0}    Move to the beginning of the input line.
  617. .x Key assignments>CTRL/E>move to end of line
  618. .x CTRL/E>move to end of line
  619. .x Key assignments>Keypad#2>move to end of line
  620. .x Keypad#2>move to end of line
  621. .i-29;CTRL/E    {keypad-2}    Move to the end of the input line.
  622. .x Key assignments>CTRL/D, move cursor left
  623. .x CTRL/D, move cursor left
  624. .x Key assignments>Left-arrow, move cursor left
  625. .x Left-arrow, move cursor left
  626. .i-29;CTRL/D    {left-arrow}    Move the cursor left one column
  627. .x Key assignments>CTRL/F>move cursor right
  628. .x CTRL/F>move cursor right
  629. .x Key assignments>Right-arrow, move cursor right
  630. .x Right-arrow, move cursor right
  631. .i-29;CTRL/F    {right-arrow}    Move the cursor right one column
  632. .x Key assignments>Delete key, delete a character
  633. .x Delete key, delete a character
  634. .i-29;{delete}        Delete the character before the cursor point.
  635. .x Key assignments>Line-feed key, delete a word
  636. .x Line-feed key, delete a word
  637. .i-29;{line-feed}        Delete the "word" before the cursor point
  638. .x Key assignments>ENTER key>enter command
  639. .x ENTER key>enter command
  640. .x Key assignments>Return key>enter command
  641. .x Return key>enter command
  642. .i-29;ENTER    {return}    Complete the command, issue it.
  643. .x Key assignments>CTRL/U, abort command
  644. .x CTRL/U, abort command
  645. .x Key assignments>CTRL/X, abort command
  646. .x CTRL/X, abort command
  647. .i-29;CTRL/U    CTRL/X    Abort the command.
  648. .lm2.br.rpt 73 "-"
  649.  
  650. .if lib
  651. .lm0;2 Pathname###########
  652. .else lib
  653. .b2.lm0;^*Pathname:\*
  654. .endif lib
  655. .lm2.b
  656. .x Pathname
  657. .x Working directory
  658. As you move your cursor up or down through the display list, FLIST
  659. sets the default directory to match that of the current file.
  660. The default directory's name is shown in the status line.
  661. .b
  662. You need not specify the pathname (device+directory) of files which
  663. are in the default directory while performing operations upon them.
  664. Furthermore, if your command implicitly affects only files within the
  665. display list (e.g., FIND), then if you do not specify a pathname,
  666. then FLIST treats it as a wildcard ("_*_:").
  667. .b
  668. Commands which are not limited to operating upon the current contents
  669. of the display list (e.g., EDIT, COPY, RENAME) do not use this
  670. implicit-wildcard for the pathname.
  671.  
  672. .if lib
  673. .lm0;2 Protection#########
  674. .else lib
  675. .b2.lm0;^*Protection:\*
  676. .endif lib
  677. .lm2.b
  678. .x Protection edit
  679. .x PROTECT, change protection
  680. .x Key assignments>CTRL/P, protection edit
  681. .x CTRL/P, protection edit
  682. Protection edit-mode is entered either by typing  PROtect  or  CTRL/P.  If the
  683. first (i.e., no arguments), the changes made  in  the  edit will  be saved for
  684. last-command retrieval.
  685. .b
  686. Protection  fields  are edited using the following commands, aimed at the flag
  687. at the current cursor position:
  688. .lm2.b
  689. Key    (also)    Operation
  690. .lm2.br.rpt 73 "-"
  691. .lm +29
  692. .x Key assignments>Up-arrow>enable protection
  693. .x Up-arrow>enable protection
  694. .i-29;{up-arrow}        Enable the flag
  695. .x Key assignments>Down-arrow>disable protection
  696. .x Down-arrow>disable protection
  697. .i-29;down-arrow}        Disable the flag
  698. .x Key assignments>Left-arrow, move cursor left
  699. .x Left-arrow, move cursor left
  700. .x Key assignments>CTRL/D, move cursor left
  701. .x CTRL/D, move cursor left
  702. .i-29;{left-arrow}    CTRL/D    Move left
  703. .x Key assignments>Right-arrow, move cursor right
  704. .x Right-arrow, move cursor right
  705. .x Key assignments>CTRL/F>move cursor right
  706. .x CTRL/F>move cursor right
  707. .i-29;{right-arrow}    CTRL/F    Move right
  708. .x Key assignments>"Y", copy protection-level code
  709. .x "Y", copy protection-level code
  710. .i-29;y    Y    Enable the entire group (for command-copy)
  711. .x Key assignments>"N", don't copy protection code
  712. .x "N", don't copy protection code
  713. .i-29;n    N    Disable the entire group
  714. .x Key assignments>",", move to next protection-level
  715. .x ",", move to next protection-level
  716. .i-29;,        Move to next group
  717. .x Key assignments>Return key>enter command
  718. .x Return key>enter command
  719. .x Key assignments>ENTER key>enter command
  720. .x ENTER key>enter command
  721. .i-29;ENTER    {return}    Complete the command, change protection
  722. .x Key assignments>CTRL/U, abort command
  723. .x CTRL/U, abort command
  724. .x Key assignments>CTRL/X, abort command
  725. .x CTRL/X, abort command
  726. .i-29;CTRL/U    CTRL/X    Abort the command
  727. .x Key assignments>"?", HELP (immediate in protection edit)
  728. .x "?", HELP (immediate in protection edit)
  729. .x Key assignments>PF2, HELP
  730. .x PF2, HELP
  731. .i-29;?    PF2    Help-display
  732. .lm2.br.rpt 73 "-"
  733.  
  734. .if lib
  735. .lm0;2 Refresh############
  736. .else lib
  737. .b2
  738. .lm0;^*Refresh:\*
  739. .endif lib
  740. .lm2.b
  741. The following commands are used to update the FLIST database/display-list:
  742. .b
  743. Main    Alternate    Description
  744. .lm2.br.rpt 73 "-"
  745. .lm +29
  746. .x Read-list>READ
  747. .x READ
  748. .i-29;Read        Re-read directory (or if argument, new entries)
  749. .x Read-list>UPDATE
  750. .x UPDATE
  751. .i-29;Update        Re-read directory, forcing database update
  752. .x Display list>VERIFY
  753. .x VERIFY
  754. .x Key assignments>CTRL/V, verify
  755. .x CTRL/V, verify
  756. .i-29;VErify    CTRL/V    Scan to remove files other programs deleted
  757. .lm2.br.rpt 73 "-"
  758. .lm +29
  759. .x Read-list>CTRL/R, reread line
  760. .x Key assignments>CTRL/R, reread line
  761. .x CTRL/R, reread line
  762. .i-29;    CTRL/R    Re-read/refresh current line
  763. .x Refresh display
  764. .x Key assignments>CTRL/W, refresh display
  765. .x CTRL/W, refresh display
  766. .i-29;    CTRL/W    Refresh screen-display
  767. .y Files>SNAPSHOT.CRT>see Screen dump
  768. .x Screen dump>CTRL/K
  769. .x Key assignments>CTRL/K, screen dump
  770. .x CTRL/K, screen dump
  771. .i-29;    CTRL/K    Dump a copy of screen to SNAPSHOT.CRT
  772. .lm2.br.rpt 73 "-"
  773. .lm +29
  774. .x Display commands>/HOLD
  775. .i-29;/HOLd        Prompt after all spawned commands (e.g., EDIT)
  776. .x Display commands>/NOHOLD
  777. .i-29;/NOHold        No prompt after spawned commands (default)
  778. .lm2.br.rpt 73 "-"
  779.  
  780. .if lib
  781. .lm0;2 Scrolling##########
  782. .else lib
  783. .b2
  784. .lm0;^*Scrolling:\*
  785. .endif lib
  786. .lm2.b
  787. Main    Alternate    Description
  788. .lm2.br.rpt 73 "-"
  789. .lm +29
  790. .x Scrolling commands>/TOP, scroll to top
  791. .x /TOP, scroll to top
  792. .x Key assignments>CTRL/T, scroll to top
  793. .x CTRL/T, scroll to top
  794. .i-29;/TOP    CTRL/T    Move (scrolling) to the top of the list.
  795. .x Scrolling commands>/END, scroll to end
  796. .x /END, scroll to end
  797. .x Key assignments>CTRL/E>scroll to end
  798. .x CTRL/E>scroll to end
  799. .i-29;/END    CTRL/E    Move (scrolling) to the end of the list.
  800. .x Scrolling commands>/FORWARD, scroll forward
  801. .x /FORWARD, scroll forward
  802. .x Key assignments>CTRL/F>scroll forward
  803. .x CTRL/F>scroll forward
  804. .i-29;/Forward    CTRL/F    Scroll forward one screen.
  805. .x Scrolling commands>/BACKWARD, scroll backward
  806. .x /BACKWARD, scroll backward
  807. .x Key assignments>CTRL/B, scroll backward
  808. .x CTRL/B, scroll backward
  809. .i-29;/Backward    CTRL/B    Scroll backward one screen.
  810. .x Scrolling commands>/FORWARD, scroll forward
  811. .x /PAGE, scroll one screen
  812. .i-29;/Page        Scroll one screen (direction: /F or /B)
  813. .x Scrolling commands>/HOME
  814. .x /HOME
  815. .i-29;/Home        Move to the top of the screen.
  816. .x Scrolling commands>/MIDDLE
  817. .x /MIDDLE
  818. .i-29;/Middle        Move to the middle of the screen.
  819. .x Scrolling commands>/LOW
  820. .x /LOW
  821. .i-29;/Low        Move to last file entry on current screen.
  822. .x Scrolling commands>Backspace key, move up
  823. .x Key assignments>Backspace key>move up
  824. .x Backspace key>move up
  825. .x Scrolling commands>Up-arrow, move up
  826. .x Key assignments>Up-arrow>move up
  827. .x Up-arrow>move up
  828. .i-29;{backspace}    {up-arrow}    Move to previous line.
  829. .x Scrolling commands>Return key, move down
  830. .x Key assignments>Return key>move down
  831. .x Return key>move down
  832. .x Scrolling commands>ENTER key, move down
  833. .x Key assignments>ENTER key>move down
  834. .x ENTER key>move down
  835. .x Scrolling commands>Down-arrow, move down
  836. .x Key assignments>Down-arrow>move down
  837. .x Down-arrow>move down
  838. .i-29;{return}    {down-arrow}    Move to next line (also ENTER)
  839. .x Scrolling commands>Number
  840. .x Number-scrolling
  841. .i-29;{number}        Move to specified index in file list (trailing sign
  842. permitted for relative movement).
  843. .x Scrolling commands>Slash
  844. .x Slash-scrolling
  845. .i-29;/        Scroll to put current line to top of screen.
  846. .lm2.br.rpt 73 "-"
  847.  
  848. .if lib
  849. .lm0;2 Sorting############
  850. .else lib
  851. .b2
  852. .lm0;^*Sorting:\*
  853. .endif lib
  854. .lm2.b
  855. .x Sorting commands
  856. Name-fields are sorted in increasing order, while numbers (including dates)
  857. are sorted in decreasing order.
  858. The "/r" sorts reverse this.
  859. A  single  file
  860. may be set as a "fixed-point" during the sort (either by the keypad ".", or  by
  861. another "/" before the sort command, e.g., "//sn").  If fixed-point, then after
  862. sorting the cursor is returned to the selected file.
  863. .lm2.b
  864. Normal    Reverse    Description
  865. .lm2.br.rpt 73 "-"
  866. .lm +29
  867. .x Sorting commands>/SPATH, sort by PATH
  868. .x /SPATH, sort by PATH
  869. .x Sorting commands>/RPATH, sort by PATH
  870. .x /RPATH, sort by PATH
  871. .i-29;/SPath    /RPath    Sort by PATH name, then name, type, version.
  872. .x Sorting commands>/SNAME, sort by NAME
  873. .x /SNAME, sort by NAME
  874. .x Sorting commands>/RNAME, sort by NAME
  875. .x /RNAME, sort by NAME
  876. .i-29;/Sname    /Rname    Sort by file NAME, then path, etc.
  877. .x Sorting commands>/STYPE, sort by TYPE
  878. .x /STYPE, sort by TYPE
  879. .x Sorting commands>/RTYPE, sort by TYPE
  880. .x /RTYPE, sort by TYPE
  881. .i-29;/SType    /RType    Sort by file TYPE, then path, name, etc.
  882. .x Sorting commands>/SVERSION, sort by VERSION
  883. .x /SVERSION, sort by VERSION
  884. .x Sorting commands>/RVERSION, sort by VERSION
  885. .x /RVERSION, sort by VERSION
  886. .i-29;/SVersion    /RVersion    Sort by VERSION
  887. .lm2.br.rpt 73 "-"
  888. .lm+29
  889. .x Sorting commands>/SALLOC, sort by allocation
  890. .x /SALLOC, sort by allocation
  891. .x Sorting commands>/RALLOC, sort by allocation
  892. .x /RALLOC, sort by allocation
  893. .i-29;/SAlloc    /RAlloc    Sort by ALLOCated size
  894. .x Sorting commands>/SBACKUP, sort by BACKUP date
  895. .x /SBACKUP, sort by BACKUP date
  896. .x Sorting commands>/RBACKUP, sort by BACKUP date
  897. .x /RBACKUP, sort by BACKUP date
  898. .i-29;/SBackup    /RBackup    Sort by BACKUP date
  899. .x Sorting commands>/SCREATED, sort by CREATED date
  900. .x /SCREATED, sort by CREATED date
  901. .x Sorting commands>/RCREATED, sort by CREATED date
  902. .x /RCREATED, sort by CREATED date
  903. .i-29;/SCreated    /RCreated    Sort by CREATED date
  904. .x Sorting commands>/SDATE, sort by DATE
  905. .x /SDATE, sort by DATE
  906. .x Sorting commands>/RDATE, sort by DATE
  907. .x /RDATE, sort by DATE
  908. .i-29;/SDate    /RDate    Sort by DATE
  909. .x Sorting commands>/SEXPIRED, sort by EXPIRED date
  910. .x /SEXPIRED, sort by EXPIRED date
  911. .x Sorting commands>/REXPIRED, sort by EXPIRED date
  912. .x /REXPIRED, sort by EXPIRED date
  913. .i-29;/SExpired    /RExpired    Sort by EXPIRED date
  914. .x Sorting commands>/SFORMAT, sort by format
  915. .x /SFORMAT, sort by format
  916. .x Sorting commands>/RFORMAT, sort by format
  917. .x /RFORMAT, sort by format
  918. .i-29;/SFormat    /RFormat    Sort by FORMAT (of file)
  919. .x Sorting commands>/SHOUR, sort by hour of DATE
  920. .x /SHOUR, sort by hour of DATE
  921. .x Sorting commands>/RHOUR, sort by hour of DATE
  922. .x /RHOUR, sort by hour of DATE
  923. .i-29;/SHour    /RHour    Sort by HOUR (of current "/D" mode)
  924. .x Sorting commands>/SID, sort by file-id
  925. .x /SID, sort by file-id
  926. .x Sorting commands>/RID, sort by file-id
  927. .x /RID, sort by file-id
  928. .i-29;/SId    /RId    Sort by file-id
  929. .x Sorting commands>/SLENGTH, sort by record-length
  930. .x /SLENGTH, sort by record-length
  931. .x Sorting commands>/RLENGTH, sort by record-length
  932. .x /RLENGTH, sort by record-length
  933. .i-29;/SLength    /RLength    Sort by record-length
  934. .x Sorting commands>/SMASK, sort by protection mask
  935. .x /SMASK, sort by protection mask
  936. .x Sorting commands>/RMASK, sort by protection mask
  937. .x /RMASK, sort by protection mask
  938. .i-29;/SMask    /RMask    Sort by protection MASK
  939. .x Sorting commands>/SOWNER, sort by owner
  940. .x /SOWNER, sort by owner
  941. .x Sorting commands>/ROWNER, sort by owner
  942. .x /ROWNER, sort by owner
  943. .i-29;/SOwner    /ROwner    Sort by OWNER
  944. .x Sorting commands>/SREVISED, sort by REVISED date
  945. .x /SREVISED, sort by REVISED date
  946. .x Sorting commands>/RREVISED, sort by REVISED date
  947. .x /RREVISED, sort by REVISED date
  948. .i-29;/SRevised    /RRevised    Sort by REVISED date
  949. .x Sorting commands>/SSIZE, sort by SIZE
  950. .x /SSIZE, sort by SIZE
  951. .x Sorting commands>/RSIZE, sort by SIZE
  952. .x /RSIZE, sort by SIZE
  953. .i-29;/SSize    /RSize    Sort by SIZE
  954. .x Sorting commands>/SUSER, sort by file owner's user name
  955. .x /SUSER, sort by file owner's user name
  956. .x Sorting commands>/RUSER, sort by file owner's user name
  957. .x /RUSER, sort by file owner's user name
  958. .i-29;/SUser    /RUser    Sort by file owner's user name
  959. .x Sorting commands>/SWEEK, sort by DATE's weekday
  960. .x /SWEEK, sort by DATE's weekday
  961. .x Sorting commands>/RWEEK, sort by DATE's weekday
  962. .x /RWEEK, sort by DATE's weekday
  963. .i-29;/SWeek    /RWeek    Sort by day of WEEK
  964. .x Sorting commands>/SXAB, sort by extra attributes
  965. .x /SXAB, sort by extra attributes
  966. .x Sorting commands>/RXAB, sort by extra attributes
  967. .x /RXAB, sort by extra attributes
  968. .i-29;/SXab    /RXab    Sort by record attributes
  969. .lm2.br.rpt 73 "-"
  970. .lm+29
  971. .x Sorting commands>/MARK, latch fixed-point
  972. .x /MARK, latch fixed-point
  973. .x Fixed-point sorting>/MARK
  974. .i-29;/MARk        Select the current file as a fixed point.
  975. .x Sorting commands>/NOMARK, unlatch fixed-point
  976. .x /NOMARK, unlatch fixed-point
  977. .x Fixed-point sorting>/NOMARK
  978. .i-29;/NOMark        Deselect the fix-point file.
  979. .lm2.br.rpt 73 "-"
  980.  
  981. .if lib
  982. .lm0;2 Status#############
  983. .else lib
  984. .b2.lm0;^*Status:\*
  985. .endif lib
  986. .lm2.b
  987. .x Status commands
  988. The following commands display status information known to FLIST, which is not
  989. easily determinable by other methods:
  990. .lm2.b
  991. .lm2.br.rpt 73 "-"
  992. .lm +15
  993. .i -15
  994. .x Status commands>?COLUMNS, show column-list
  995. .x ?COLUMNS, show column-list
  996. ?Columns    Shows the display-columns names (cf: "/columns").
  997. .i -15
  998. .x Status commands>?DATE, show current date
  999. .x ?DATE, show current date
  1000. ?Date    Shows the current date and time.
  1001. .i -15
  1002. .x Status commands>?FIND, show search-target
  1003. .x ?HELP, show search target
  1004. ?Find    Shows the current target of NEXT
  1005. .i -15
  1006. .x Status commands>?HELP, show command summary
  1007. .x ?HELP, show command summary
  1008. ?help    Shows the help-file for FLIST.
  1009. .i -15
  1010. .x Status commands>?LEVEL, show display level
  1011. .x ?LEVEL, show display level
  1012. ?Level    Shows the current nesting-level of FLIST (cf: QUIT).
  1013. .i-15
  1014. .x Status commands>?MEMORY, show dynamic memory usage
  1015. .x ?MEMORY, show dynamic memory usage
  1016. ?Memory    Shows the amount of dynamic memory allocated by FLIST.
  1017. .;    i -15
  1018. .;    x Status commands>?QUOTA, show user's disk quota
  1019. .;    x ?QUOTA, show user's disk quota
  1020. .;    ?Quota    Shows the user's disk quota.
  1021. .i-15
  1022. .x Status commands>?READ, show read-list and options
  1023. .x ?READ, show read-list and options
  1024. ?Read    Shows the read-list and current option settings.
  1025. .i -15
  1026. .x Status commands>?SIZE, show blocks in display list
  1027. .x ?SIZE, show blocks in display list
  1028. ?Size    Shows the total block-count of files in the list.
  1029. .i -15
  1030. .x Status commands>?TIMES, show timer
  1031. .x ?TIMES, show timer
  1032. ?Times    Shows elapsed, actual CPU times, amount of I/O.
  1033. .i -15
  1034. .x Status commands>?VERSION, show FLIST version
  1035. .x ?VERSION, show FLIST version
  1036. ?Version    Shows the version and build-date of FLIST.
  1037. .lm2.br.rpt 73 "-"
  1038.  
  1039. .if lib
  1040. .lm0;2 Substitution#######
  1041. .else lib
  1042. .b2.lm0;^*Substitution:\*
  1043. .endif lib
  1044. .lm2.b
  1045. .x Command substitution
  1046. .y Order of arguments>see Command substitution
  1047. The text of a visible command is directed to the current-file entry.  In most
  1048. cases, the order of arguments is unambiguous:
  1049. .b.lm +8
  1050. DELETE    - no arguments, simply delete the current-file
  1051. .br
  1052. RENAME    - one argument, the new-file name
  1053. .b.lm -8
  1054. In some commands, the order must be specified more precisely
  1055. (e.g., COPY, APPEND).
  1056. FLIST uses the "/O" and "/" tokens to accomplish this.
  1057. .x Command substitution>"/",##substitute after name
  1058. .x "/", substitute after name
  1059. The first occurrence of the "/" token in the argument list
  1060. causes the current filename
  1061. to be implicitly placed at that point, and all succeeding text after it.
  1062. The filename is normally placed at the end of the command.
  1063. .x Command substitution>"/O", omit substitution
  1064. .x "/O", omit substitution
  1065. The "/O" prefix,  on the other hand,  causes the  current  filename
  1066. to be omitted from the command
  1067. string expansion (unless a "/" token is used).
  1068. .b
  1069. Components of the current filename may be copied by the user in  substitution
  1070. performed by FLIST when executing a command.  For example, if the file  entry
  1071. is DBC4:[DICKEY]FLIST.EXE;34,
  1072. .b.lm +8
  1073. .x Command substitution>"/P", substitute PATH
  1074. .x "/P", substitute PATH
  1075. .br;/P##substitutes the path, "DBC4:[DICKEY]"
  1076. .x Command substitution>"/N", substitute NAME
  1077. .x "/N", substitute NAME
  1078. .br;/N##substitutes the name, "FLIST"
  1079. .x Command substitution>"/T", substitute TYPE
  1080. .x "/T", substitute TYPE
  1081. .br;/T##substitutes the type, "EXE"
  1082. .x Command substitution>"/V", substitute VERSION
  1083. .x "/V", substitute VERSION
  1084. .br;/V##substitutes the version, "34"
  1085. .b.lm -8
  1086. The "." and ";" punctuation must be supplied by the user if a filename is to
  1087. be constructed by substitution, e.g., "/N./T".
  1088. T