RubyGems - fsdb - Versions diffs - 0.5 → 0.6.0 - Mend

fsdb 0.5 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (176) hide show

data/{RELEASE-NOTES → History.txt} +6 -0
data/{README → README.txt} +26 -17
data/examples/flat.rb +146 -0
data/examples/fsdb-example.rb +28 -0
data/examples/rbformat.rb +17 -0
data/examples/yaml2.rb +29 -0
data/junk/OLDRakefile +98 -0
data/junk/OLDRakefile2 +55 -0
data/junk/check-cache.rb +18 -0
data/junk/create-lock.rb +25 -0
data/junk/doc/old-api/classes/FSDB.html +139 -0
data/junk/doc/old-api/classes/FSDB/Database.html +953 -0
data/junk/doc/old-api/classes/FSDB/Database.src/M000029.html +16 -0
data/junk/doc/old-api/classes/FSDB/Database.src/M000030.html +16 -0
data/junk/doc/old-api/classes/FSDB/Database.src/M000031.html +16 -0
data/junk/doc/old-api/classes/FSDB/Database.src/M000032.html +16 -0
data/junk/doc/old-api/classes/FSDB/Database.src/M000033.html +33 -0
data/junk/doc/old-api/classes/FSDB/Database.src/M000034.html +18 -0
data/junk/doc/old-api/classes/FSDB/Database.src/M000035.html +22 -0
data/junk/doc/old-api/classes/FSDB/Database.src/M000036.html +16 -0
data/junk/doc/old-api/classes/FSDB/Database.src/M000037.html +22 -0
data/junk/doc/old-api/classes/FSDB/Database.src/M000038.html +43 -0
data/junk/doc/old-api/classes/FSDB/Database.src/M000039.html +25 -0
data/junk/doc/old-api/classes/FSDB/Database.src/M000040.html +43 -0
data/junk/doc/old-api/classes/FSDB/Database.src/M000041.html +23 -0
data/junk/doc/old-api/classes/FSDB/Database.src/M000042.html +22 -0
data/junk/doc/old-api/classes/FSDB/Database.src/M000043.html +16 -0
data/junk/doc/old-api/classes/FSDB/Database.src/M000044.html +16 -0
data/junk/doc/old-api/classes/FSDB/Database.src/M000045.html +18 -0
data/junk/doc/old-api/classes/FSDB/Database.src/M000046.html +18 -0
data/junk/doc/old-api/classes/FSDB/Database.src/M000047.html +18 -0
data/junk/doc/old-api/classes/FSDB/Database.src/M000048.html +16 -0
data/junk/doc/old-api/classes/FSDB/Database.src/M000049.html +71 -0
data/junk/doc/old-api/classes/FSDB/Database.src/M000050.html +43 -0
data/junk/doc/old-api/classes/FSDB/Database.src/M000051.html +53 -0
data/junk/doc/old-api/classes/FSDB/Database.src/M000052.html +44 -0
data/junk/doc/old-api/classes/FSDB/Database.src/M000053.html +39 -0
data/junk/doc/old-api/classes/FSDB/Database.src/M000054.html +72 -0
data/junk/doc/old-api/classes/FSDB/Database.src/M000055.html +39 -0
data/junk/doc/old-api/classes/FSDB/Database.src/M000056.html +18 -0
data/junk/doc/old-api/classes/FSDB/Database.src/M000057.html +18 -0
data/junk/doc/old-api/classes/FSDB/Database.src/M000058.html +18 -0
data/junk/doc/old-api/classes/FSDB/Database.src/M000059.html +18 -0
data/junk/doc/old-api/classes/FSDB/Database.src/M000060.html +18 -0
data/junk/doc/old-api/classes/FSDB/Database.src/M000061.html +23 -0
data/junk/doc/old-api/classes/FSDB/Database.src/M000062.html +23 -0
data/junk/doc/old-api/classes/FSDB/Database.src/M000063.html +18 -0
data/junk/doc/old-api/classes/FSDB/Database.src/M000064.html +18 -0
data/junk/doc/old-api/classes/FSDB/Database/AbortedTransaction.html +118 -0
data/junk/doc/old-api/classes/FSDB/Database/CreateFileError.html +120 -0
data/junk/doc/old-api/classes/FSDB/Database/DirIsImmutableError.html +117 -0
data/junk/doc/old-api/classes/FSDB/Database/DirNotEmptyError.html +117 -0
data/junk/doc/old-api/classes/FSDB/Database/FormatError.html +117 -0
data/junk/doc/old-api/classes/FSDB/Database/MissingFileError.html +117 -0
data/junk/doc/old-api/classes/FSDB/Database/MissingObjectError.html +117 -0
data/junk/doc/old-api/classes/FSDB/Database/NotDirError.html +118 -0
data/junk/doc/old-api/classes/FSDB/Database/PathComponentError.html +120 -0
data/junk/doc/old-api/classes/FSDB/DatabaseDebuggable.html +148 -0
data/junk/doc/old-api/classes/FSDB/DatabaseDebuggable.src/M000005.html +21 -0
data/junk/doc/old-api/classes/FSDB/DatabaseDebuggable.src/M000007.html +21 -0
data/junk/doc/old-api/classes/FSDB/DirectoryIterators.html +210 -0
data/junk/doc/old-api/classes/FSDB/DirectoryIterators.src/M000006.html +22 -0
data/junk/doc/old-api/classes/FSDB/DirectoryIterators.src/M000007.html +22 -0
data/junk/doc/old-api/classes/FSDB/DirectoryIterators.src/M000008.html +22 -0
data/junk/doc/old-api/classes/FSDB/DirectoryIterators.src/M000009.html +22 -0
data/junk/doc/old-api/classes/FSDB/DirectoryIterators.src/M000010.html +22 -0
data/junk/doc/old-api/classes/FSDB/DirectoryIterators.src/M000011.html +22 -0
data/junk/doc/old-api/classes/FSDB/DirectoryIterators.src/M000012.html +22 -0
data/junk/doc/old-api/classes/FSDB/DirectoryIterators.src/M000013.html +22 -0
data/junk/doc/old-api/classes/FSDB/ForkSafely.html +126 -0
data/junk/doc/old-api/classes/FSDB/Modex.html +237 -0
data/junk/doc/old-api/classes/FSDB/Modex.src/M000024.html +21 -0
data/junk/doc/old-api/classes/FSDB/Modex.src/M000025.html +30 -0
data/junk/doc/old-api/classes/FSDB/Modex.src/M000026.html +21 -0
data/junk/doc/old-api/classes/FSDB/Modex.src/M000027.html +30 -0
data/junk/doc/old-api/classes/FSDB/Modex.src/M000028.html +44 -0
data/junk/doc/old-api/classes/FSDB/Modex.src/M000029.html +26 -0
data/junk/doc/old-api/classes/FSDB/Modex.src/M000030.html +48 -0
data/junk/doc/old-api/classes/FSDB/Modex/ForkSafely.html +105 -0
data/junk/doc/old-api/classes/FSDB/Mutex.html +244 -0
data/junk/doc/old-api/classes/FSDB/Mutex.src/M000018.html +19 -0
data/junk/doc/old-api/classes/FSDB/Mutex.src/M000019.html +18 -0
data/junk/doc/old-api/classes/FSDB/Mutex.src/M000020.html +19 -0
data/junk/doc/old-api/classes/FSDB/Mutex.src/M000021.html +18 -0
data/junk/doc/old-api/classes/FSDB/Mutex.src/M000022.html +23 -0
data/junk/doc/old-api/classes/FSDB/Mutex.src/M000023.html +30 -0
data/junk/doc/old-api/classes/FSDB/Mutex.src/M000024.html +26 -0
data/junk/doc/old-api/classes/FSDB/Mutex.src/M000025.html +21 -0
data/junk/doc/old-api/classes/FSDB/Mutex/ForkSafely.html +105 -0
data/junk/doc/old-api/classes/FSDB/PathUtilities.html +257 -0
data/junk/doc/old-api/classes/FSDB/PathUtilities.src/M000012.html +23 -0
data/junk/doc/old-api/classes/FSDB/PathUtilities.src/M000013.html +18 -0
data/junk/doc/old-api/classes/FSDB/PathUtilities.src/M000014.html +23 -0
data/junk/doc/old-api/classes/FSDB/PathUtilities.src/M000015.html +18 -0
data/junk/doc/old-api/classes/FSDB/PathUtilities.src/M000016.html +18 -0
data/junk/doc/old-api/classes/FSDB/PathUtilities.src/M000017.html +22 -0
data/junk/doc/old-api/classes/FSDB/PathUtilities.src/M000018.html +23 -0
data/junk/doc/old-api/classes/FSDB/PathUtilities.src/M000019.html +18 -0
data/junk/doc/old-api/classes/FSDB/PathUtilities/InvalidPathError.html +111 -0
data/junk/doc/old-api/classes/File.html +272 -0
data/junk/doc/old-api/classes/File.src/M000001.html +17 -0
data/junk/doc/old-api/classes/File.src/M000002.html +17 -0
data/junk/doc/old-api/classes/File.src/M000003.html +20 -0
data/junk/doc/old-api/classes/File.src/M000004.html +20 -0
data/junk/doc/old-api/classes/File.src/M000005.html +32 -0
data/junk/doc/old-api/classes/File.src/M000006.html +32 -0
data/junk/doc/old-api/created.rid +1 -0
data/junk/doc/old-api/files/README.html +112 -0
data/junk/doc/old-api/files/RELEASE-NOTES.html +233 -0
data/junk/doc/old-api/files/fsdb_txt.html +888 -0
data/junk/doc/old-api/files/lib/fsdb/database_rb.html +115 -0
data/junk/doc/old-api/files/lib/fsdb/file-lock_rb.html +109 -0
data/junk/doc/old-api/files/lib/fsdb/modex_rb.html +121 -0
data/junk/doc/old-api/files/lib/fsdb/mutex_rb.html +108 -0
data/junk/doc/old-api/files/lib/fsdb/util_rb.html +108 -0
data/junk/doc/old-api/fr_class_index.html +47 -0
data/junk/doc/old-api/fr_file_index.html +34 -0
data/junk/doc/old-api/fr_method_index.html +90 -0
data/junk/doc/old-api/index.html +24 -0
data/junk/doc/old-api/rdoc-style.css +208 -0
data/junk/file-lock-nb.rb +15 -0
data/junk/fl.rb +144 -0
data/junk/flock-test.rb +39 -0
data/junk/fsdb.kateproject +47 -0
data/junk/fsdb.prj +196 -0
data/junk/fsdb.sf +46 -0
data/junk/insert-dir.rb +48 -0
data/junk/lock-test-bug.rb +150 -0
data/junk/lock-test-too-simple.rb +136 -0
data/junk/lock-test.rb +151 -0
data/{script → junk}/mkrdoc +0 -0
data/junk/restore-fsdb.rb +37 -0
data/junk/rf.txt +5 -0
data/junk/solaris-bug-fixed.rb +184 -0
data/junk/solaris-bug.rb +182 -0
data/junk/solaris-bug.txt +43 -0
data/junk/sync.rb +327 -0
data/junk/test-file-lock.html +86 -0
data/junk/test-file-lock.rb +84 -0
data/junk/test-processes.rb +131 -0
data/junk/test-threads.rb +113 -0
data/junk/wiki-mutex.rb +108 -0
data/lib/fsdb/database.rb +5 -3
data/lib/fsdb/delegatable.rb +21 -0
data/lib/fsdb/faster-modex.rb +223 -0
data/lib/fsdb/faster-mutex.rb +138 -0
data/lib/fsdb/mutex.rb +4 -1
data/lib/fsdb/persistent.rb +91 -0
data/lib/fsdb/read-write-object.rb +36 -0
data/lib/fsdb/server.rb +44 -0
data/misc/fsdb-blorubu.txt +47 -0
data/misc/mtime-and-file-id.txt +23 -0
data/misc/posixlock.txt +148 -0
data/rakefile +39 -0
data/tasks/ann.rake +80 -0
data/tasks/bones.rake +20 -0
data/tasks/gem.rake +201 -0
data/tasks/git.rake +40 -0
data/tasks/notes.rake +27 -0
data/tasks/post_load.rake +34 -0
data/tasks/rdoc.rake +51 -0
data/tasks/rubyforge.rake +55 -0
data/tasks/setup.rb +292 -0
data/tasks/spec.rake +54 -0
data/tasks/svn.rake +47 -0
data/tasks/test.rake +40 -0
data/tasks/zentest.rake +36 -0
data/test/err.txt +31 -0
data/test/runs.rb +8 -0
data/test/test-file-lock.rb +78 -0
data/test/test-util.rb +1 -0
data/test/trap.rb +31 -0
metadata +198 -35
data/Manifest +0 -36
data/Rakefile +0 -10
data/fsdb.gemspec +0 -113

data/junk/OLDRakefile2 ADDED Viewed

@@ -0,0 +1,55 @@
+@project             = 'fsdb'
+#==== Tasks
+desc "make Ruby api docs"
+task :rdoc
+#==== Utility methods
+def version
+  @version ||= `prcs info | tail -n1`[/^(.*) by \w+/, 1]
+end
+def ver
+  @ver ||= version[/^#{@project} (\S+)/, 1]
+end
+#==== Definitions
+ruby_api_doc_dir    = "doc/api"
+ruby_doc_index      = File.join(ruby_api_doc_dir, "index.html")
+ruby_doc_files      = FileList[%w{
+  fsdb.txt RELEASE-NOTES README
+  lib/fsdb/database.rb lib/fsdb/file-lock.rb lib/fsdb/util.rb
+  lib/fsdb/modex.rb lib/fsdb/mutex.rb lib/fsdb/util.rb
+  lib/fsdb/formats.rb
+}]
+project_web         = "vjoel@rubyforge.org:/var/www/gforge-projects/#{@project}"
+#==== Actions
+file ruby_doc_index => ruby_doc_files do
+  sh %{
+    rdoc --template=jamis --inline-source -m fsdb.txt \
+      -o #{ruby_api_doc_dir} \
+      -t 'FSDB' -f html \
+      #{ruby_doc_files}
+  }
+end
+task :rdoc => ruby_doc_index
+task :rubyforge => [:rdoc] do
+  ## rdoc still doesn't work on rubyforge?
+  sh "scp -r doc/api/* #{project_web}"
+end
+task :version do
+  puts version
+end
+task :ver do
+  puts ver
+end

data/junk/check-cache.rb ADDED Viewed

@@ -0,0 +1,18 @@
+  def self.check_cache tester, db, path, thread, who
+    unless $solaris # the File.read gives up the flock?
+      __x__ = tester.x
+      data = File.read(File.join(db.dir, path))
+      uncached_x = Marshal.load(data).x rescue nil
+      if uncached_x
+        unless uncached_x == __x__
+          fail "#{who} test, process #{Process.pid}," +
+               " thread #{thread[:number]}:" +
+               " cache is stale:\n" +
+               "  #{uncached_x} on disk, #{__x__} in cache" +
+               "  #{tester}"
+        end
+      end
+    end
+  end

data/junk/create-lock.rb ADDED Viewed

@@ -0,0 +1,25 @@
+      # <b>Windows:</b>
+      # Opens path for writing and reading ("w+") with an exclusive lock for the
+      # duration of the block.
+#      def open_create_lock(path)
+#        is_dir = path =~ /\/$/
+#        File.open(path, is_dir ? "r" : "w+") do |f|
+#          set_binmode(f, path)
+#          f.lock_exclusive(is_dir) do
+#            yield f
+#          end
+#        end
+#      end
+      # <b>Non-Windows:</b>
+      # Opens path for writing and reading ("w+") with an exclusive lock for the
+      # duration of the block.
+#      def open_create_lock(path)
+#        is_dir = path =~ /\/$/
+#        File.open(path, is_dir ? "r" : "w+") do |f|
+#          f.lock_exclusive(is_dir) do
+#            yield f
+#          end
+#        end
+#      end

data/junk/doc/old-api/classes/FSDB.html ADDED Viewed

@@ -0,0 +1,139 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <title>Module: FSDB</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <meta http-equiv="Content-Script-Type" content="text/javascript" />
+  <link rel="stylesheet" href=".././rdoc-style.css" type="text/css" media="screen" />
+  <script type="text/javascript">
+  // <![CDATA[
+  function popupCode( url ) {
+    window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
+  }
+  function toggleCode( id ) {
+    if ( document.getElementById )
+      elem = document.getElementById( id );
+    else if ( document.all )
+      elem = eval( "document.all." + id );
+    else
+      return false;
+    elemStyle = elem.style;
+    if ( elemStyle.display != "block" ) {
+      elemStyle.display = "block"
+    } else {
+      elemStyle.display = "none"
+    }
+    return true;
+  }
+  // Make codeblocks hidden by default
+  document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
+  // ]]>
+  </script>
+</head>
+<body>
+    <div id="classHeader">
+        <table class="header-table">
+        <tr class="top-aligned-row">
+          <td><strong>Module</strong></td>
+          <td class="class-name-in-header">FSDB</td>
+        </tr>
+        <tr class="top-aligned-row">
+            <td><strong>In:</strong></td>
+            <td>
+                <a href="../files/lib/fsdb/database_rb.html">
+                lib/fsdb/database.rb
+                </a>
+        <br />
+                <a href="../files/lib/fsdb/util_rb.html">
+                lib/fsdb/util.rb
+                </a>
+        <br />
+                <a href="../files/lib/fsdb/modex_rb.html">
+                lib/fsdb/modex.rb
+                </a>
+        <br />
+                <a href="../files/lib/fsdb/mutex_rb.html">
+                lib/fsdb/mutex.rb
+                </a>
+        <br />
+            </td>
+        </tr>
+        </table>
+    </div>
+  <!-- banner header -->
+  <div id="bodyContent">
+  <div id="contextContent">
+   </div>
+  </div>
+    <!-- if includes -->
+    <div id="includes">
+      <h3 class="section-bar">Included Modules</h3>
+      <div id="includes-list">
+        <span class="include-name">Formats</span>
+        <span class="include-name"><a href="FSDB/PathUtilities.html">PathUtilities</a></span>
+        <span class="include-name"><a href="FSDB/ForkSafely.html">ForkSafely</a></span>
+        <span class="include-name"><a href="FSDB/ForkSafely.html">ForkSafely</a></span>
+      </div>
+    </div>
+    <div id="section">
+    <div id="class-list">
+      <h3 class="section-bar">Classes and Modules</h3>
+      Module <a href="FSDB/DatabaseDebuggable.html" class="link">FSDB::DatabaseDebuggable</a><br />
+Module <a href="FSDB/DirectoryIterators.html" class="link">FSDB::DirectoryIterators</a><br />
+Module <a href="FSDB/ForkSafely.html" class="link">FSDB::ForkSafely</a><br />
+Module <a href="FSDB/PathUtilities.html" class="link">FSDB::PathUtilities</a><br />
+Class <a href="FSDB/Database.html" class="link">FSDB::Database</a><br />
+Class <a href="FSDB/Modex.html" class="link">FSDB::Modex</a><br />
+Class <a href="FSDB/Mutex.html" class="link">FSDB::Mutex</a><br />
+    </div>
+    <!-- if method_list -->
+  </div>
+<div id="validator-badges">
+  <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
+</div>
+</body>
+</html>

data/junk/doc/old-api/classes/FSDB/Database.html ADDED Viewed

@@ -0,0 +1,953 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <title>Class: FSDB::Database</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <meta http-equiv="Content-Script-Type" content="text/javascript" />
+  <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
+  <script type="text/javascript">
+  // <![CDATA[
+  function popupCode( url ) {
+    window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
+  }
+  function toggleCode( id ) {
+    if ( document.getElementById )
+      elem = document.getElementById( id );
+    else if ( document.all )
+      elem = eval( "document.all." + id );
+    else
+      return false;
+    elemStyle = elem.style;
+    if ( elemStyle.display != "block" ) {
+      elemStyle.display = "block"
+    } else {
+      elemStyle.display = "none"
+    }
+    return true;
+  }
+  // Make codeblocks hidden by default
+  document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
+  // ]]>
+  </script>
+</head>
+<body>
+    <div id="classHeader">
+        <table class="header-table">
+        <tr class="top-aligned-row">
+          <td><strong>Class</strong></td>
+          <td class="class-name-in-header">FSDB::Database</td>
+        </tr>
+        <tr class="top-aligned-row">
+            <td><strong>In:</strong></td>
+            <td>
+                <a href="../../files/lib/fsdb/database_rb.html">
+                lib/fsdb/database.rb
+                </a>
+        <br />
+                <a href="../../files/lib/fsdb/util_rb.html">
+                lib/fsdb/util.rb
+                </a>
+        <br />
+            </td>
+        </tr>
+        <tr class="top-aligned-row">
+            <td><strong>Parent:</strong></td>
+            <td>
+                Object
+            </td>
+        </tr>
+        </table>
+    </div>
+  <!-- banner header -->
+  <div id="bodyContent">
+  <div id="contextContent">
+    <div id="description">
+      <p>
+A thread-safe, process-safe object database class which uses the native
+file system as its back end and allows multiple file formats.
+</p>
+    </div>
+   </div>
+    <div id="method-list">
+      <h3 class="section-bar">Methods</h3>
+      <div class="name-list">
+      <a href="#M000034">[]</a>&nbsp;&nbsp;
+      <a href="#M000056">[]</a>&nbsp;&nbsp;
+      <a href="#M000053">[]=</a>&nbsp;&nbsp;
+      <a href="#M000044">abort</a>&nbsp;&nbsp;
+      <a href="#M000043">abort</a>&nbsp;&nbsp;
+      <a href="#M000037">absolute</a>&nbsp;&nbsp;
+      <a href="#M000038">absolute_path_to</a>&nbsp;&nbsp;
+      <a href="#M000049">browse</a>&nbsp;&nbsp;
+      <a href="#M000031">cache</a>&nbsp;&nbsp;
+      <a href="#M000032">cache_mutex</a>&nbsp;&nbsp;
+      <a href="#M000042">clear_cache</a>&nbsp;&nbsp;
+      <a href="#M000041">clear_entry</a>&nbsp;&nbsp;
+      <a href="#M000045">default_browse</a>&nbsp;&nbsp;
+      <a href="#M000046">default_edit</a>&nbsp;&nbsp;
+      <a href="#M000048">default_fetch</a>&nbsp;&nbsp;
+      <a href="#M000054">delete</a>&nbsp;&nbsp;
+      <a href="#M000058">dump</a>&nbsp;&nbsp;
+      <a href="#M000050">edit</a>&nbsp;&nbsp;
+      <a href="#M000055">fetch</a>&nbsp;&nbsp;
+      <a href="#M000062">find_format</a>&nbsp;&nbsp;
+      <a href="#M000059">formats</a>&nbsp;&nbsp;
+      <a href="#M000060">formats=</a>&nbsp;&nbsp;
+      <a href="#M000039">get_file_id</a>&nbsp;&nbsp;
+      <a href="#M000061">identify_file_type</a>&nbsp;&nbsp;
+      <a href="#M000052">insert</a>&nbsp;&nbsp;
+      <a href="#M000036">inspect</a>&nbsp;&nbsp;
+      <a href="#M000063">link</a>&nbsp;&nbsp;
+      <a href="#M000057">load</a>&nbsp;&nbsp;
+      <a href="#M000040">make_file_id</a>&nbsp;&nbsp;
+      <a href="#M000033">new</a>&nbsp;&nbsp;
+      <a href="#M000047">object_missing</a>&nbsp;&nbsp;
+      <a href="#M000051">replace</a>&nbsp;&nbsp;
+      <a href="#M000035">subdb</a>&nbsp;&nbsp;
+      <a href="#M000064">symlink</a>&nbsp;&nbsp;
+      </div>
+    </div>
+  </div>
+    <!-- if includes -->
+    <div id="includes">
+      <h3 class="section-bar">Included Modules</h3>
+      <div id="includes-list">
+        <span class="include-name">Formats</span>
+        <span class="include-name"><a href="PathUtilities.html">PathUtilities</a></span>
+        <span class="include-name"><a href="DirectoryIterators.html">DirectoryIterators</a></span>
+      </div>
+    </div>
+    <div id="section">
+    <div id="class-list">
+      <h3 class="section-bar">Classes and Modules</h3>
+      Class <a href="Database/AbortedTransaction.html" class="link">FSDB::Database::AbortedTransaction</a><br />
+Class <a href="Database/CreateFileError.html" class="link">FSDB::Database::CreateFileError</a><br />
+Class <a href="Database/DirIsImmutableError.html" class="link">FSDB::Database::DirIsImmutableError</a><br />
+Class <a href="Database/DirNotEmptyError.html" class="link">FSDB::Database::DirNotEmptyError</a><br />
+Class <a href="Database/FormatError.html" class="link">FSDB::Database::FormatError</a><br />
+Class <a href="Database/MissingFileError.html" class="link">FSDB::Database::MissingFileError</a><br />
+Class <a href="Database/MissingObjectError.html" class="link">FSDB::Database::MissingObjectError</a><br />
+Class <a href="Database/NotDirError.html" class="link">FSDB::Database::NotDirError</a><br />
+Class <a href="Database/PathComponentError.html" class="link">FSDB::Database::PathComponentError</a><br />
+    </div>
+    <div id="constants-list">
+      <h3 class="section-bar">Constants</h3>
+      <div class="name-list">
+        <table summary="Constants">
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">MTIME_RESOLUTION</td>
+          <td>=</td>
+          <td class="context-item-value">2.1</td>
+          <td width="3em">&nbsp;</td>
+          <td class="context-item-desc">
+On windows, FAT mtime granularity is 2 sec, NTFS is 1 sec.
+</td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">MTIME_RESOLUTION</td>
+          <td>=</td>
+          <td class="context-item-value">1.1</td>
+          <td width="3em">&nbsp;</td>
+          <td class="context-item-desc">
+Even when linux mounts FAT, the mtime granularity is 1 sec.
+</td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">CLOCK_SKEW</td>
+          <td>=</td>
+          <td class="context-item-value">0.0</td>
+          <td width="3em">&nbsp;</td>
+          <td class="context-item-desc">
+in seconds, adjust as needed for stability on NFS
+</td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">DEFAULT_META_PREFIX</td>
+          <td>=</td>
+          <td class="context-item-value">'..fsdb.meta.'</td>
+          <td width="3em">&nbsp;</td>
+          <td class="context-item-desc">
+Subclasses can change the defaults.
+</td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">DEFAULT_LOCK_TYPE</td>
+          <td>=</td>
+          <td class="context-item-value">:flock</td>
+          <td width="3em">&nbsp;</td>
+          <td class="context-item-desc">
+if RUBY_PLATFORM =~ /darwin/
+<pre>
+  DEFAULT_LOCK_TYPE       = :fcntl_lock
+</pre>
+<p>
+else
+</p>
+</td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">LOCK_TYPES</td>
+          <td>=</td>
+          <td class="context-item-value">[:flock, :fcntl_lock]</td>
+          <td width="3em">&nbsp;</td>
+          <td class="context-item-desc">
+These must be methods of <a href="../File.html">File</a>.
+</td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">FORMATS</td>
+          <td>=</td>
+          <td class="context-item-value">[TEXT_FORMAT, MARSHAL_FORMAT].freeze</td>
+          <td width="3em">&nbsp;</td>
+          <td class="context-item-desc">
+Subclasses can define their own list of formats, with specified search
+order
+</td>
+        </tr>
+        </table>
+      </div>
+    </div>
+    <div id="attribute-list">
+      <h3 class="section-bar">Attributes</h3>
+      <div class="name-list">
+        <table>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">dir</td>
+          <td class="context-item-value">&nbsp;[R]&nbsp;</td>
+          <td class="context-item-desc">
+The root directory of the db, to which paths are relative.
+</td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">lock_type</td>
+          <td class="context-item-value">&nbsp;[R]&nbsp;</td>
+          <td class="context-item-desc">
+The lock type of the db, by default <tt>:flock</tt>, optionally
+<tt>:fcntl_lock</tt>.
+</td>
+        </tr>
+        </table>
+      </div>
+    </div>
+    <!-- if method_list -->
+    <div id="methods">
+      <h3 class="section-bar">Public Class methods</h3>
+      <div id="method-M000034" class="method-detail">
+        <a name="M000034"></a>
+        <div class="method-heading">
+          <a href="Database.src/M000034.html" target="Code" class="method-signature"
+            onclick="popupCode('Database.src/M000034.html');return false;">
+          <span class="method-name">[]</span><span class="method-args">(path)</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Shortcut to create a new database at <tt>path</tt>.
+</p>
+        </div>
+      </div>
+      <div id="method-M000044" class="method-detail">
+        <a name="M000044"></a>
+        <div class="method-heading">
+          <a href="Database.src/M000044.html" target="Code" class="method-signature"
+            onclick="popupCode('Database.src/M000044.html');return false;">
+          <span class="method-name">abort</span><span class="method-args">()</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Same as <a href="Database.html#M000043">abort</a>.
+</p>
+        </div>
+      </div>
+      <div id="method-M000033" class="method-detail">
+        <a name="M000033"></a>
+        <div class="method-heading">
+          <a href="Database.src/M000033.html" target="Code" class="method-signature"
+            onclick="popupCode('Database.src/M000033.html');return false;">
+          <span class="method-name">new</span><span class="method-args">(dir, opts = {})</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Create a new database object that accesses <tt>dir</tt>. Makes sure that
+the directory exists on disk, but doesn&#8217;t create or open any other
+files. The <tt>opts</tt> hash can include:
+</p>
+<table>
+<tr><td valign="top"><tt>:lock_type</tt>:</td><td><tt>:flock</tt> by default, or <tt>:fcntl_lock</tt>
+</td></tr>
+<tr><td valign="top"><tt>:meta_prefix</tt>:</td><td><tt>&#8217;..fsdb.meta.&#8217;</tt> by default
+</td></tr>
+<tr><td valign="top"><tt>:formats</tt>:</td><td>nil by default, so the class&#8217;s FORMATS is used
+</td></tr>
+</table>
+        </div>
+      </div>
+      <h3 class="section-bar">Public Instance methods</h3>
+      <div id="method-M000056" class="method-detail">
+        <a name="M000056"></a>
+        <div class="method-heading">
+          <span class="method-name">[]</span><span class="method-args">(path = &quot;/&quot;)</span>
+        </div>
+        <div class="method-description">
+          <p>
+Alias for <a href="Database.html#M000055">fetch</a>
+</p>
+        </div>
+      </div>
+      <div id="method-M000053" class="method-detail">
+        <a name="M000053"></a>
+        <div class="method-heading">
+          <span class="method-name">[]=</span><span class="method-args">(path, object)</span>
+        </div>
+        <div class="method-description">
+          <p>
+Alias for <a href="Database.html#M000052">insert</a>
+</p>
+        </div>
+      </div>
+      <div id="method-M000043" class="method-detail">
+        <a name="M000043"></a>
+        <div class="method-heading">
+          <a href="Database.src/M000043.html" target="Code" class="method-signature"
+            onclick="popupCode('Database.src/M000043.html');return false;">
+          <span class="method-name">abort</span><span class="method-args">()</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Abort the current transaction (<a href="Database.html#M000049">browse</a>,
+<a href="Database.html#M000050">edit</a>, <a
+href="Database.html#M000051">replace</a>, or <a
+href="Database.html#M000054">delete</a>, roll back the state of the object,
+and return nil from the transaction.
+</p>
+<p>
+In the <a href="Database.html#M000049">browse</a> case, the only effect is
+to end the transaction.
+</p>
+<p>
+Note that any exception that breaks out of the transaction will also abort
+the transaction, and be re-raised.
+</p>
+        </div>
+      </div>
+      <div id="method-M000037" class="method-detail">
+        <a name="M000037"></a>
+        <div class="method-heading">
+          <a href="Database.src/M000037.html" target="Code" class="method-signature"
+            onclick="popupCode('Database.src/M000037.html');return false;">
+          <span class="method-name">absolute</span><span class="method-args">(path)</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Convert a relative path (relative to the db dir) to an absolute path.
+</p>
+        </div>
+      </div>
+      <div id="method-M000038" class="method-detail">
+        <a name="M000038"></a>
+        <div class="method-heading">
+          <span class="method-name">absolute_path_to</span><span class="method-args">(path)</span>
+        </div>
+        <div class="method-description">
+          <p>
+Alias for <a href="Database.html#M000037">absolute</a>
+</p>
+        </div>
+      </div>
+      <div id="method-M000049" class="method-detail">
+        <a name="M000049"></a>
+        <div class="method-heading">
+          <a href="Database.src/M000049.html" target="Code" class="method-signature"
+            onclick="popupCode('Database.src/M000049.html');return false;">
+          <span class="method-name">browse</span><span class="method-args">(path = &quot;/&quot;) {|object| ...}</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Browse the object. Yields the object to the caller&#8217;s block, and
+returns the value of the block.
+</p>
+<p>
+Changes to the object are not persistent, but should be avoided (they
+<b>will</b> be seen by other threads, but only in the current process, and
+only until the cache is cleared). If you return the object from the block,
+or keep a reference to it in some other way, the object will no longer be
+protected from concurrent writers.
+</p>
+        </div>
+      </div>
+      <div id="method-M000031" class="method-detail">
+        <a name="M000031"></a>
+        <div class="method-heading">
+          <a href="Database.src/M000031.html" target="Code" class="method-signature"
+            onclick="popupCode('Database.src/M000031.html');return false;">
+          <span class="method-name">cache</span><span class="method-args">()</span>
+          </a>
+        </div>
+        <div class="method-description">
+        </div>
+      </div>
+      <div id="method-M000032" class="method-detail">
+        <a name="M000032"></a>
+        <div class="method-heading">
+          <a href="Database.src/M000032.html" target="Code" class="method-signature"
+            onclick="popupCode('Database.src/M000032.html');return false;">
+          <span class="method-name">cache_mutex</span><span class="method-args">()</span>
+          </a>
+        </div>
+        <div class="method-description">
+        </div>
+      </div>
+      <div id="method-M000042" class="method-detail">
+        <a name="M000042"></a>
+        <div class="method-heading">
+          <a href="Database.src/M000042.html" target="Code" class="method-signature"
+            onclick="popupCode('Database.src/M000042.html');return false;">
+          <span class="method-name">clear_cache</span><span class="method-args">()</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Can be called occasionally to reduce memory footprint, esp. if cached
+objects are large and infrequently used.
+</p>
+        </div>
+      </div>
+      <div id="method-M000041" class="method-detail">
+        <a name="M000041"></a>
+        <div class="method-heading">
+          <a href="Database.src/M000041.html" target="Code" class="method-signature"
+            onclick="popupCode('Database.src/M000041.html');return false;">
+          <span class="method-name">clear_entry</span><span class="method-args">(file_id)</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+For housekeeping, so that stale entries don&#8217;t result in unused, but
+uncollectable, CacheEntry objects.
+</p>
+        </div>
+      </div>
+      <div id="method-M000045" class="method-detail">
+        <a name="M000045"></a>
+        <div class="method-heading">
+          <a href="Database.src/M000045.html" target="Code" class="method-signature"
+            onclick="popupCode('Database.src/M000045.html');return false;">
+          <span class="method-name">default_browse</span><span class="method-args">(path) {|x| ...}</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Called when <a href="Database.html#M000049">browse</a> doesn&#8217;t find
+anything at the path. The original caller&#8217;s block is available to be
+yielded to.
+</p>
+        </div>
+      </div>
+      <div id="method-M000046" class="method-detail">
+        <a name="M000046"></a>
+        <div class="method-heading">
+          <a href="Database.src/M000046.html" target="Code" class="method-signature"
+            onclick="popupCode('Database.src/M000046.html');return false;">
+          <span class="method-name">default_edit</span><span class="method-args">(path) {|x| ...}</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Called when <a href="Database.html#M000050">edit</a> doesn&#8217;t find
+anything at the path. The original caller&#8217;s block is available to be
+yielded to.
+</p>
+        </div>
+      </div>
+      <div id="method-M000048" class="method-detail">
+        <a name="M000048"></a>
+        <div class="method-heading">
+          <a href="Database.src/M000048.html" target="Code" class="method-signature"
+            onclick="popupCode('Database.src/M000048.html');return false;">
+          <span class="method-name">default_fetch</span><span class="method-args">(path)</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Called when <a href="Database.html#M000055">fetch</a> doesn&#8217;t find
+anything at the path. Default definition just returns nil.
+</p>
+        </div>
+      </div>
+      <div id="method-M000054" class="method-detail">
+        <a name="M000054"></a>
+        <div class="method-heading">
+          <a href="Database.src/M000054.html" target="Code" class="method-signature"
+            onclick="popupCode('Database.src/M000054.html');return false;">
+          <span class="method-name">delete</span><span class="method-args">(path, load=true) {|object| ...}</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Delete the object from the db. If a block is given, yields the object (or
+nil if none) before deleting it from the db (but before releasing the lock
+on the path), and returns the value of the block. Otherwise, just returns
+the object (or nil, if none). Raises <a
+href="Database/DirNotEmptyError.html">DirNotEmptyError</a> if path refers
+to a non-empty dir. If the dir is empty, it is deleted, and the returned
+value is <tt>true</tt>. The block is not yielded to. If the <em>load</em>
+argument is <tt>false</tt>, delete the object from the db without loading
+it or yielding, returning <tt>true</tt>.
+</p>
+        </div>
+      </div>
+      <div id="method-M000058" class="method-detail">
+        <a name="M000058"></a>
+        <div class="method-heading">
+          <a href="Database.src/M000058.html" target="Code" class="method-signature"
+            onclick="popupCode('Database.src/M000058.html');return false;">
+          <span class="method-name">dump</span><span class="method-args">(object, f)</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Writes object to f (must be open for writing).
+</p>
+        </div>
+      </div>
+      <div id="method-M000050" class="method-detail">
+        <a name="M000050"></a>
+        <div class="method-heading">
+          <a href="Database.src/M000050.html" target="Code" class="method-signature"
+            onclick="popupCode('Database.src/M000050.html');return false;">
+          <span class="method-name">edit</span><span class="method-args">(path = &quot;/&quot;) {|object if block_given?| ...}</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Edit the object in place. Changes to the yielded object made within the
+caller&#8217;s block become persistent. Returns the value of the block.
+Note that assigning to the block argument variable does not change the
+state of the object. Use destructive methods on the object.
+</p>
+        </div>
+      </div>
+      <div id="method-M000055" class="method-detail">
+        <a name="M000055"></a>
+        <div class="method-heading">
+          <a href="Database.src/M000055.html" target="Code" class="method-signature"
+            onclick="popupCode('Database.src/M000055.html');return false;">
+          <span class="method-name">fetch</span><span class="method-args">(path = &quot;/&quot;)</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Fetch a <b>copy</b> of the object at the path for private use by the
+current thread/process. (The copy is a <b>deep</b> copy.)
+</p>
+<p>
+Note that this is inherently less efficient than <a
+href="Database.html#M000049">browse</a>, because <a
+href="Database.html#M000049">browse</a> leaves the object in the cache,
+but, for safety, <a href="Database.html#M000055">fetch</a> can only return
+a copy and wipe the cache, since the copy is going to be used outside of
+any transaction. Subsequent transactions will have to read the object
+again.
+</p>
+        </div>
+      </div>
+      <div id="method-M000062" class="method-detail">
+        <a name="M000062"></a>
+        <div class="method-heading">
+          <a href="Database.src/M000062.html" target="Code" class="method-signature"
+            onclick="popupCode('Database.src/M000062.html');return false;">
+          <span class="method-name">find_format</span><span class="method-args">(path, abs_path = absolute(path))</span>
+          </a>
+        </div>
+        <div class="method-description">
+        </div>
+      </div>
+      <div id="method-M000059" class="method-detail">
+        <a name="M000059"></a>
+        <div class="method-heading">
+          <a href="Database.src/M000059.html" target="Code" class="method-signature"
+            onclick="popupCode('Database.src/M000059.html');return false;">
+          <span class="method-name">formats</span><span class="method-args">()</span>
+          </a>
+        </div>
+        <div class="method-description">
+        </div>
+      </div>
+      <div id="method-M000060" class="method-detail">
+        <a name="M000060"></a>
+        <div class="method-heading">
+          <a href="Database.src/M000060.html" target="Code" class="method-signature"
+            onclick="popupCode('Database.src/M000060.html');return false;">
+          <span class="method-name">formats=</span><span class="method-args">(fmts)</span>
+          </a>
+        </div>
+        <div class="method-description">
+        </div>
+      </div>
+      <div id="method-M000039" class="method-detail">
+        <a name="M000039"></a>
+        <div class="method-heading">
+          <a href="Database.src/M000039.html" target="Code" class="method-signature"
+            onclick="popupCode('Database.src/M000039.html');return false;">
+          <span class="method-name">get_file_id</span><span class="method-args">(abs_path)</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Convert an absolute path to a unique key for the cache, raising <a
+href="Database/MissingFileError.html">MissingFileError</a> if the file does
+not exist.
+</p>
+        </div>
+      </div>
+      <div id="method-M000061" class="method-detail">
+        <a name="M000061"></a>
+        <div class="method-heading">
+          <a href="Database.src/M000061.html" target="Code" class="method-signature"
+            onclick="popupCode('Database.src/M000061.html');return false;">
+          <span class="method-name">identify_file_type</span><span class="method-args">(f, path, abs_path = absolute(path))</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+<tt>path</tt> is relative to the database, and initial &#8217;/&#8217; is
+ignored
+</p>
+        </div>
+      </div>
+      <div id="method-M000052" class="method-detail">
+        <a name="M000052"></a>
+        <div class="method-heading">
+          <a href="Database.src/M000052.html" target="Code" class="method-signature"
+            onclick="popupCode('Database.src/M000052.html');return false;">
+          <span class="method-name">insert</span><span class="method-args">(path, object)</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Insert the object, replacing anything at the path. Returns the object. (The
+object remains a <em>local copy</em>, distinct from the one which will be
+returned when accessing the path through database transactions.)
+</p>
+<p>
+If <tt>path</tt> ends in &quot;/&quot;, then object is treated as a
+collection of key-value pairs, and each value is inserted at the
+corresponding key under <tt>path</tt>. (You can omit the &quot;/&quot; if
+the dir already exists.)
+</p>
+<pre>
+  is this still true?
+</pre>
+        </div>
+      </div>
+      <div id="method-M000036" class="method-detail">
+        <a name="M000036"></a>
+        <div class="method-heading">
+          <a href="Database.src/M000036.html" target="Code" class="method-signature"
+            onclick="popupCode('Database.src/M000036.html');return false;">
+          <span class="method-name">inspect</span><span class="method-args">()</span>
+          </a>
+        </div>
+        <div class="method-description">
+        </div>
+      </div>
+      <div id="method-M000063" class="method-detail">
+        <a name="M000063"></a>
+        <div class="method-heading">
+          <a href="Database.src/M000063.html" target="Code" class="method-signature"
+            onclick="popupCode('Database.src/M000063.html');return false;">
+          <span class="method-name">link</span><span class="method-args">(old_name, new_name)</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Create a hard link, using File.link. The names are relative to the
+database&#8217;s path.
+</p>
+        </div>
+      </div>
+      <div id="method-M000057" class="method-detail">
+        <a name="M000057"></a>
+        <div class="method-heading">
+          <a href="Database.src/M000057.html" target="Code" class="method-signature"
+            onclick="popupCode('Database.src/M000057.html');return false;">
+          <span class="method-name">load</span><span class="method-args">(f)</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Returns object read from f (must be open for reading).
+</p>
+        </div>
+      </div>
+      <div id="method-M000040" class="method-detail">
+        <a name="M000040"></a>
+        <div class="method-heading">
+          <a href="Database.src/M000040.html" target="Code" class="method-signature"
+            onclick="popupCode('Database.src/M000040.html');return false;">
+          <span class="method-name">make_file_id</span><span class="method-args">(abs_path)</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Convert an absolute path to a unique key for the cache, creating the file
+if it does not exist. Raises <a
+href="Database/CreateFileError.html">CreateFileError</a> if it can&#8217;t
+be created.
+</p>
+        </div>
+      </div>
+      <div id="method-M000047" class="method-detail">
+        <a name="M000047"></a>
+        <div class="method-heading">
+          <a href="Database.src/M000047.html" target="Code" class="method-signature"
+            onclick="popupCode('Database.src/M000047.html');return false;">
+          <span class="method-name">object_missing</span><span class="method-args">(path)</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+The default behavior of both <a
+href="Database.html#M000046">default_edit</a> and <a
+href="Database.html#M000045">default_browse</a>. Raises <a
+href="Database/MissingObjectError.html">MissingObjectError</a> by default,
+but it can yield to the original block.
+</p>
+        </div>
+      </div>
+      <div id="method-M000051" class="method-detail">
+        <a name="M000051"></a>
+        <div class="method-heading">
+          <a href="Database.src/M000051.html" target="Code" class="method-signature"
+            onclick="popupCode('Database.src/M000051.html');return false;">
+          <span class="method-name">replace</span><span class="method-args">(path) {|old_object if block_given?| ...}</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Replace the yielded object (or nil) with the return value of the block.
+Returns the object that was replaced. No object need exist at
+<tt>path</tt>.
+</p>
+<p>
+Use replace instead of edit when accessing db over a drb connection. Use
+replace instead of insert if the path needs to be protected while the
+object is prepared for insertion.
+</p>
+<p>
+Note that (unlike <a href="Database.html#M000050">edit</a>) destructive
+methods on the object do not persistently change the state of the object,
+unless the object is the return value of the block.
+</p>
+        </div>
+      </div>
+      <div id="method-M000035" class="method-detail">
+        <a name="M000035"></a>
+        <div class="method-heading">
+          <a href="Database.src/M000035.html" target="Code" class="method-signature"
+            onclick="popupCode('Database.src/M000035.html');return false;">
+          <span class="method-name">subdb</span><span class="method-args">(path)</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Create a new database object that accesses <tt>path</tt> relative to the
+database directory. A process can have any number of dbs accessing
+overlapping dirs. The cost of creating an additional db is very low; its
+state is just the dir and some options. Caching is done in structures owned
+by the <a href="Database.html">Database</a> class itself.
+</p>
+        </div>
+      </div>
+      <div id="method-M000064" class="method-detail">
+        <a name="M000064"></a>
+        <div class="method-heading">
+          <a href="Database.src/M000064.html" target="Code" class="method-signature"
+            onclick="popupCode('Database.src/M000064.html');return false;">
+          <span class="method-name">symlink</span><span class="method-args">(old_name, new_name)</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Create a symbolic link, using File.symlink. The names are relative to the
+database&#8217;s path.
+</p>
+        </div>
+      </div>
+    </div>
+  </div>
+<div id="validator-badges">
+  <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
+</div>
+</body>
+</html>