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

fsdb 0.5 → 0.6.0

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>