home *** CD-ROM | disk | FTP | other *** search
/ vsiftp.vmssoftware.com / VSIPUBLIC@vsiftp.vmssoftware.com.tar / FREEWARE / FREEWARE40.ZIP / flistfrontend / doc / d4.rno < prev    next >
Encoding:
Text File  |  1995-10-23  |  4.3 KB  |  128 lines

  1. .; $Id: d4.rno,v 1.2 1995/10/23 20:37:04 tom Exp $
  2. .; invoking FLIST (options)
  3. To run FLIST, you use the command FLIST.
  4. The FLIST command line consists of the FLIST command, file specifications
  5. and optional qualifiers.
  6. Do not confuse the FLIST command-line qualifiers with the display
  7. commands (which also begin with "/").
  8.  
  9. .hl Altering the Initial Display Format
  10. The simplest of FLIST's qualifiers modifies the initial display,
  11. by selecting a "/D" display command:
  12. .lm+8
  13. .b.i-4
  14. .x /DBACKUP qualifier
  15. /DBACKUP
  16. .br;The /DBACKUP qualifier directs FLIST to initially display the file's
  17. .x /DBACKUP, toggle DATE to BACKUP
  18. .x DATE-toggle>/DBACKUP
  19. backup dates (i.e., "/DBACKUP") rather than the creation date.
  20. .b.i-4
  21. .x /DREVISED qualifier
  22. /DREVISED
  23. .br;The /DREVISED qualifier directs FLIST to initially display
  24. the revision (last modification) dates for each file.
  25. .x /DREVISED, toggle DATE to REVISED
  26. .x DATE-toggle>/DREVISED
  27. This is equivalent to a "/DREVISED" display command.
  28. .b.lm-8
  29. The /DBACKUP and /DREVISED qualifiers may be overridden after entry to FLIST.
  30.  
  31. .hl Restricting the Display List
  32. FLIST supports two options which reduce the number of files in the display-list
  33. at any point:
  34. .lm+8
  35. .b.i-4
  36. .x /ALL qualifier
  37. .x /NOALL qualifier
  38. .x Display list>restricting with /NOALL
  39. /NOALL
  40. .br;Normally, FLIST runs with /ALL set.
  41. This directs FLIST to create an entry in the display-list for each
  42. file name which satisfies the file specifications,
  43. even if the user has access only to the file names.
  44. If /NOALL is set, on the other hand, FLIST will display only those
  45. files to which the user has privileged access.
  46. This makes the other files invisible;
  47. FLIST simply never shows them to the user.
  48. .;
  49. .b.i-4
  50. .x /VERSIONS qualifier
  51. .x /NOVERSIONS qualifier
  52. .x Display list>restricting with /NOVERSIONS
  53. /NOVERSIONS
  54. .br;The /VERSIONS qualifier (normally active) causes FLIST
  55. to show all versions of each file.
  56. If /NOVERSIONS is selected, FLIST will display only the highest
  57. version of each file.
  58. There are several implications of this function:
  59. .lm+8
  60. .b.i-4
  61. .x Defaults>file specification
  62. o    The default file specification is restricted from "_*._*;_*"
  63. to "_*._*;", so that file scanning is more rapid.
  64. .b.i-4
  65. o    Whenever FLIST modifies a file, it must determine if the
  66. result supersedes an item in the display-list.
  67. Only the highest version of any file is shown in the display.
  68. .b.i-4
  69. .x Display list>removal via RENAME
  70. o    Renaming a file so that it is superseded by another file in
  71. the display list causes it to vanish from the display.
  72. .b.lm-8
  73. The /VERSIONS mode of operation can be used to advantage when
  74. the user wishes to view a set of files without purging them.
  75. The PURGE operation will function, but explicit access to lower
  76. versions will be denied.
  77. .b.lm-8
  78. The /NOALL and /NOVERSIONS qualifiers may not be overridden.
  79. They are set only on entry to FLIST.
  80. /NOALL and /NOVERSION are used
  81. to reduce the clutter of a large directory display.
  82.  
  83. .hl Reduced-Capability Operation
  84. The remaining qualifiers of FLIST act to reduce its display capabilities.
  85. This can be useful if the user is to run in a restricted mode,
  86. acting only on a subset of the directory attributes.
  87. .lm+8
  88. .b.i-4
  89. .x Display columns>restricting with qualifiers
  90. .x /FAST qualifier
  91. /FAST
  92. .br;The /FAST qualifier causes FLIST to display only the file names
  93. (including their types, versions and path).
  94. Since FLIST need not open the file headers for this mode of operation,
  95. it is much faster.
  96. FLIST verifies protection in this mode only when the user
  97. requires access.
  98. The only useful operations are browsing, editing, and sorting
  99. by the name components (NAME, TYPE, VERSION and PATH).
  100. The /FAST option is equivalent to
  101. .b.c;/NODATE/NOOWNER/NOPROTECTION/NOSIZE
  102. .;
  103. .b.i-4
  104. .x /NODATE qualifier
  105. /NODATE
  106. .br;The /NODATE qualifier causes FLIST to omit the various file
  107. dates (CREATED, BACKUP, REVISED) from the displayable set of directory
  108. attributes.
  109. .b.i-4
  110. .x /NOOWNER qualifier
  111. /NOOWNER
  112. .br;The /NOOWNER qualifier directs FLIST to drop the file owners'
  113. UID from the displayable attributes.
  114. .;
  115. .b.i-4
  116. .x /NOPROTECTION qualifier
  117. /NOPROTECTION
  118. .br;The /NOPROTECTION qualifier directs FLIST to drop the file protection
  119. from the displayable attributes.
  120. .;
  121. .b.i-4
  122. .x /NOSIZE qualifier
  123. /NOSIZE
  124. .br;The /NOSIZE qualifier directs FLIST to drop the file size
  125. (and allocation) from the displayable attributes.
  126. .b.lm-8
  127. None of these restriction-options may be reset after entry to FLIST.
  128.