| class methods | 
| [ ] | Dir[ aString ]
      -> anArray | 
 | Returns anArray of filenames found by 
      expanding the pattern given in aString.
      Note that this pattern is not a regexp (it's closer to a shell glob)
      and may contain the following metacharacters: 
        |  |  
  | ** | Matches subdirectories recursively |  
  | * | Matches zero or more characters |  
  | ? | Matches any single character |  
  | [ charSet ] | Matches any character from the given 
           set of characters. A range of characters is written as 
           charFrom -charTo. The set may be negated
           with an initial uparrow (^). |  
  | { opt, opt, ... } | Matches any one of the
        optional strings |  |  |  
  | Dir["config.?"] | » | ["config.h"] |  
  | Dir["*.[a-z][a-z]"] | » | ["main.rb"] |  
  | Dir["*.[^r]*"] | » | ["config.h"] |  
  | Dir["*.{rb,h}"] | » | ["main.rb", "config.h"] |  
  | Dir["*"] | » | ["config.h", "main.rb"] |  | | chdir | Dir.chdir( [ aString] )
        -> 0 | 
 | Changes the current working directory of the process to the given
      string.
      When called without an argument, changes the directory to the value
      of the environment variable HOME, orLOGDIR.      
      Raises aSystemCallError(probablyErrno::ENOENT)
      if the target directory does not exist.
  | Dir.chdir("/var/spool/mail") | » | 0 |  
  | Dir.pwd | » | "/var/spool/mail" |  | | chroot | Dir.chroot( aString )
        -> 0 | 
 | Changes this process's idea of the file system root.  
       Only a privileged process may make this call.
       Not available on all platforms.  On Unix systems, see chroot(2)for more information.
  | Dir.chdir("/production/secure/root") |  |  
  | Dir.chroot("/production/secure/root") | » 0 |  
  | Dir.pwd | » "/" |  | | delete | Dir.delete( aString )
        -> 0 | 
 | Deletes the named directory. Raises a subclass of SystemCallErrorif the directory isn't empty. | | entries | Dir.entries( aString )
        -> anArray | 
 | Returns an array containing all of the filenames in the given
      directory. Will raise a SystemCallErrorif the named directory
      doesn't exist.
  | Dir.entries("testdir") | » | [".", "..", "config.h", "main.rb"] |  | | foreach | Dir.foreach( aString )
        {| filename | block }
        -> nil | 
 | Calls the block once for each entry in the named directory,
      passing the filename of each entry as a parameter to the block. produces:| 
Dir.foreach("testdir") {|x| puts("Got " + x) }
 | 
 | 
Got .
Got ..
Got config.h
Got main.rb
 | 
 | | getwd | Dir.getwd
        -> aString | 
 | Returns the path to the current working directory of this
      process as a string. 
  | Dir.chdir("/tmp") | » | 0 |  
  | Dir.getwd | » | "/tmp" |  | | glob | Dir.glob( aString )
      -> anArray | 
 | Synonym for Dir::[]. | | mkdir | Dir.mkdir( aString [, anInteger] )
        -> 0 | 
 | Makes a new directory named by aString, with
      permissions specified by the optional parameter
      anInteger. The
      permissions may be modified by the value of File::umask,
      and are ignored on NT.
      Raises aSystemCallErrorif the directory cannot be created.
      See also the discussion of permissions on page 305. | | new | Dir.new( aString ) -> aDir | 
 | Returns a new directory object for the named directory. | | open | Dir.open( aString ) -> aDir Dir.open( aString ) {| aDir | block }
 ->
 nil | 
 | With no block, openis a synonym  forDir::new.
      If a block is present, it is passed aDir as a parameter. The
      directory is closed at the end of the block, andDir::openreturnsnil. | | pwd | Dir.pwd -> aString | 
 | Synonym for Dir::getwd. | | rmdir | Dir.rmdir( aString )
        -> true | 
 | Synonym for Dir::delete. | | unlink | Dir.unlink( aString )
        -> true | 
 | Synonym for Dir::delete. | 
| instance methods | 
| close | dir.close
        -> nil | 
 | Closes the directory stream. 
      Any further attempts to access dir will raise an IOError.
| d = Dir.new("testdir") |  
  | d.close | » | nil |  | | each | dir.each {|  | block }
        -> dir | 
 | Calls the block once for each entry in this directory,
      passing the filename of each entry as a parameter to the block. produces:| 
d = Dir.new("testdir")
d.each  {|x| puts ("Got " + x) }
 | 
 | 
Got .
Got ..
Got config.h
Got main.rb
 | 
 | | read | dir.read
        -> aString or nil | 
 | Reads the next entry from dir and returns it as a 
      string.  Returns nilat the end of the stream.
| d = Dir.new("testdir") |  
  | d.read | » | "." |  
  | d.read | » | ".." |  
  | d.read | » | "config.h" |  | | rewind | dir.rewind
        -> dir | 
 | Repositions dir to the first entry. 
| d = Dir.new("testdir") |  
  | d.read | » | "." |  
  | d.rewind | » | #<Dir:0x4018d784> |  
  | d.read | » | "." |  | | seek | dir.seek( anInteger )
        -> dir | 
 | Seeks to a particular location in dir.
      anInteger must be a value returned by Dir#tell.
| d = Dir.new("testdir") |  
  | d.read | » | "." |  
| i = d.tell |  
  | d.read | » | ".." |  
  | d.seek(i) | » | #<Dir:0x4018d5b8> |  
  | d.read | » | ".." |  | | tell | dir.tell
        -> anInteger | 
 | Returns the current position in dir. See also Dir#seek.
| d = Dir.new("testdir") |  
  | d.tell | » | 0 |  
  | d.read | » | "." |  
  | d.tell | » | 12 |  |