From 927e1eec6dd760af93050f075c0655b224b568ad Mon Sep 17 00:00:00 2001
From: Doug Meil <dmeil@apache.org>
Date: Mon, 23 Jan 2012 03:03:39 +0000
Subject: [PATCH] hbase-5253 book.xml - adding chart of object heirarchy in
 Arch/Regions

git-svn-id: https://svn.apache.org/repos/asf/hbase/trunk@1234677 13f79535-47bb-0310-9956-ffa450edef68
---
 src/docbkx/book.xml | 21 +++++++++++++++++----
 1 file changed, 17 insertions(+), 4 deletions(-)

diff --git a/src/docbkx/book.xml b/src/docbkx/book.xml
index 8dc25f08f04..9b33b05baee 100644
--- a/src/docbkx/book.xml
+++ b/src/docbkx/book.xml
@@ -1790,9 +1790,18 @@ scan.setFilter(filter);
     <section xml:id="regions.arch">
     <title>Regions</title>
     <para>Regions are the basic element of availability and
-     distribution for tables, and are comprised of a Store per Column Family.
-    </para>
-
+     distribution for tables, and are comprised of a Store per Column Family. The heirarchy of objects 
+     is as follows:
+<programlisting>
+<filename>Table</filename>       (HBase table)      
+    <filename>Region</filename>       (Regions for the table)
+         <filename>Store</filename>          (Store per ColumnFamily for each Region for the table)
+              <filename>MemStore</filename>           (MemStore for each Store for each Region for the table)
+              <filename>StoreFile</filename>          (StoreFiles for each Store for each Region for the table)
+                    <filename>Block</filename>             (Blocks within a StoreFile within a Store for each Region for the table)
+ </programlisting>
+            </para>
+    
     <section xml:id="arch.regions.size">
       <title>Region Size</title>
 
@@ -1926,6 +1935,8 @@ scan.setFilter(filter);
       </section>
     <section xml:id="hfile">
       <title>StoreFile (HFile)</title>
+      <para>StoreFiles are where your data lives.
+      </para>
       <section><title>HFile Format</title>
           <para>The <emphasis>hfile</emphasis> file format is based on
               the SSTable file described in the <link xlink:href="http://research.google.com/archive/bigtable.html">BigTable [2006]</link> paper and on
@@ -1962,7 +1973,9 @@ scan.setFilter(filter);
         <title>Blocks</title>
         <para>StoreFiles are composed of blocks.  The blocksize is configured on a per-ColumnFamily basis.
         </para>
-        <para>For more information, see the <link xlink:href="http://hbase.apache.org/xref/org/apache/hadoop/hbase/io/hfile/HFileBlock.html">HFileBlock source code</link>.
+        <para>Compression happens at the block level within StoreFiles.  For more information on compression, see <xref linkend="compression"/>.
+        </para>
+        <para>For more information on blocks, see the <link xlink:href="http://hbase.apache.org/xref/org/apache/hadoop/hbase/io/hfile/HFileBlock.html">HFileBlock source code</link>.
         </para>
       </section>
       <section xml:id="keyvalue">