DIR

directory utilities

main verbs:
  dir          directory
  dircompare   compare directories
  dirpath      directory paths
  dirfind      find name in directory
  dirs         directory browse
  dirss        directory string search
  dirssrplc    search and replace in directory
  dirtree      files in directory tree

Defined items
NameClassDescription
dirVerbdirectory listings
dircompareVerbcompare files in directories
dirfindVerbfind name in directory
dirpathVerbdirectory paths
dirsVerbbrowse files in directory
dirssVerbdirectory string search
dirssrplcVerbdirectory string search and replace
dirtreeVerbget filenames in directory tree

dir................. (v) directory listings

y. = dos file specification:
     if empty, defaults to *.*

x. is optional:
   - if not given, defaults to 'n'
   - if character, returns a formatted directory,
       where x. is the sort option:
         d=by date
         n=by name
         s=by size
   - if numeric, there are 1 or 2 elements:
         0{  0= list short names
             1= boxed list of full pathnames
             2= full directory list
         1{  0= filenames only (default)
             1= include subdirectories

subdirectories are shown first
filenames are returned in lower case

e.g.  dir ''
      1 dir 'system\main\d*.ijs'

dircompare.......... (v) compare files in directories

form: [opt] dircompare dirs

  dirs = directory names
  opt is optional, with up to three elements:
    0{  =0 short file comparison (default)
        =1 long file comparison
    1{  =0 given directory only (default)
        =1 recurse through subdirectories
    2{  =0 file contents only (default)
        =1 also compare timestamps

e.g.  dircompare 'main \jbak\main'

dirfind............. (v) find name in directory

find name in directory

form: string dirfind directory

returns filenames in directory tree containing string

e.g. 'jfile' dirfind 'packages'

dirpath............. (v) directory paths

return directory paths starting from y.
optional x.=0  all paths (default)
            1  non-empty paths (i.e. having files)
e.g. dirpath 'examples'

dirs................ (v) browse files in directory

e.g.  dirs 'system\main\*.ijs'

dirss............... (v) directory string search

form: string dirss directory

searches for files in directory tree containing string,
returning formatted display where found.

e.g. 'create' dirss 'main'

If x. is a 2-element boxed list, calls dirssrplc

dirssrplc........... (v) directory string search and replace

form: (old;new) dirssrplc files
example:
   ('old';'new') dirssrplc 'system\main\*.ijs'

dirtree............. (v) get filenames in directory tree

return filenames in directory tree as boxed matrix
optional x. is a timestamp to exclude earlier files
each row contains:  filename;timestamp;size
e.g.  dirtree ''
      dirtree 'main'
      dirtree 'system\packages\*.ijs'
1997 5 23 dirtree ''   - files dated on or after date.
directory search is recursive through subdirectories
filenames are returned in lower case

system\main\dir.ijsRelease: 4.02/1998-11-13/12:26