diff --git a/src/main/docbkx/book.xml b/src/main/docbkx/book.xml
index 0a7761e11a9..e8b4fba086f 100644
--- a/src/main/docbkx/book.xml
+++ b/src/main/docbkx/book.xml
@@ -2902,7 +2902,13 @@ This option should not normally be used, and it is not in -fixAll.
Build and install snappy on all nodes
- of your cluster (see below)
+ of your cluster (see below). HBase nor Hadoop cannot include snappy because of licensing issues (The
+ hadoop libhadoop.so under its native dir does not include snappy; of note, the shipped .so
+ may be for 32-bit architectures -- this fact has tripped up folks in the past with them thinking
+ it 64-bit). The notes below are about installing snappy for HBase use. You may want snappy
+ available in your hadoop context also. That is not covered here.
+ HBase and Hadoop find the snappy .so in different locations currently: Hadoop picks those files in
+ ./lib while HBase finds the .so in ./lib/[PLATFORM].
@@ -2927,6 +2933,8 @@ hbase> describe 't1'
Installation
+ Snappy is used by hbase to compress HFiles on flush and when compacting.
+
You will find the snappy library file under the .libs directory from your Snappy build (For example
/home/hbase/snappy-1.0.5/.libs/). The file is called libsnappy.so.1.x.x where 1.x.x is the version of the snappy