[svnbook commit] r1331 - in trunk/src/en: . book

[C. Michael Pilato]

sussman wrote:

>Author: sussman
>Date: Tue May 24 20:54:14 2005
>New Revision: 1331
>
>Modified:
>   trunk/src/en/TODO
>   trunk/src/en/book/ch08.xml
>Log:
>Tweak beginning of chapter 8 to mention FSFS.  Very small change.
>
>* src/en/book/ch08.xml 
>  (Repository Layer):  mention BDB and FSFS both. 
>  (A Brief Inventory of the Subversion Libraries): 
>           list libsvn_fs_base and libsvn_fs_fs in table of libraries.
>
>* src/en/book/TODO:  remove item.
>
>
>Modified: trunk/src/en/TODO
>==============================================================================
>--- trunk/src/en/TODO	(original)
>+++ trunk/src/en/TODO	Tue May 24 20:54:14 2005
>@@ -5,9 +5,6 @@
> NEEDED FOR 1.1 COMPLETION
> ============================================================================
> 
>-  * Chapter 8 Section 1.1 "Repository Layer" documents the pre-FSFS state
>-    of affairs.  [MIKE]
>-
>   * Chapter 2's "Repository URLs" sidebar should shrink back to
>     nothing but the schema-table, with a xref to a new Chapter 7
>     section.  The new chapter 7 section is all about repository URL
>
>Modified: trunk/src/en/book/ch08.xml
>==============================================================================
>--- trunk/src/en/book/ch08.xml	(original)
>+++ trunk/src/en/book/ch08.xml	Tue May 24 20:54:14 2005
>@@ -65,6 +65,14 @@
>             <entry>The Subversion filesystem library</entry>
>           </row>
>           <row>
>+            <entry>libsvn_fs_base</entry>
>+            <entry>The Berkeley DB filesystem back-end</entry>
>+          </row>
>+          <row>
>+            <entry>libsvn_fs_fs</entry>
>+            <entry>The native filesystem (FSFS) back-end</entry>
>+          </row>
>+          <row>
>             <entry>libsvn_ra</entry>
>             <entry>Repository Access commons and module loader</entry>
>           </row>
>@@ -155,18 +163,14 @@
>         <quote>files</quote> and <quote>directories</quote> as real
>         files and directories (as in, the kind you can navigate
>         through using your favorite shell program), it uses a database
>-        system for its back-end storage mechanism.  Currently, the
>-        database system in use is Berkeley DB.
>-        <footnote>
>-          <para>The choice of Berkeley DB brought several automatic
>-            features that Subversion needed, such as data integrity,
>-            atomic writes, recoverability, and hot backups.</para>
>-        </footnote>
>-        However, there has been considerable interest by the
>-        development community in giving future releases of Subversion
>-        the ability to use other back-end database systems, perhaps
>-        through a mechanism such as Open Database Connectivity
>-        (ODBC).</para>
>+        system for its back-end storage mechanism, either Berkeley DB
>+        or a flat-file (FSFS) representation.  (To learn more about
>+        the two repository back-ends, see
>+        <xref linkend="svn-ch-5-sect-1.3"/>.)  However, there has been
>+        considerable interest by the development community in giving
>+        future releases of Subversion the ability to use other
>+        back-end database systems, perhaps through a mechanism such as
>+        Open Database Connectivity (ODBC).</para>
>  
>
I'm not sure that FSFS qualifies as a database in any meaningful sense 
of the word.  (That is, to say so likely leads to assumptions that are 
untrue, such as that it is build atop some generically useful database 
system, etc.)  So I think this paragraph (and perhaps other sections of 
the book) needs a touch more work to tie the word "database" only to the 
Berkeley DB back-end.