hbase-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From st...@apache.org
Subject hbase-thirdparty git commit: Add notes on philosophy to README
Date Thu, 29 Jun 2017 19:15:08 GMT
Repository: hbase-thirdparty
Updated Branches:
  refs/heads/master e7f8d0d05 -> 199a65093


Add notes on philosophy to README


Project: http://git-wip-us.apache.org/repos/asf/hbase-thirdparty/repo
Commit: http://git-wip-us.apache.org/repos/asf/hbase-thirdparty/commit/199a6509
Tree: http://git-wip-us.apache.org/repos/asf/hbase-thirdparty/tree/199a6509
Diff: http://git-wip-us.apache.org/repos/asf/hbase-thirdparty/diff/199a6509

Branch: refs/heads/master
Commit: 199a650931ebc44a7d3d9d1f0f00dd51a6e07c88
Parents: e7f8d0d
Author: Michael Stack <stack@apache.org>
Authored: Thu Jun 29 12:15:00 2017 -0700
Committer: Michael Stack <stack@apache.org>
Committed: Thu Jun 29 12:15:00 2017 -0700

----------------------------------------------------------------------
 README.txt | 33 +++++++++++++++++++--------------
 1 file changed, 19 insertions(+), 14 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/hbase-thirdparty/blob/199a6509/README.txt
----------------------------------------------------------------------
diff --git a/README.txt b/README.txt
index 28b554a..8e15f0b 100644
--- a/README.txt
+++ b/README.txt
@@ -4,6 +4,25 @@ DISCLAIMER: This project is for Apache HBase internal use.  Included libs
 and/or their versions are subject to change at the dictate of hbase without
 regard to the concern of others!
 
+We have a number of submodules, one per ornery lib -- protobuf and netty --
+where we need special-handling and then a bucket for all the rest,
+hbase-shaded-miscellaneous. This latter includes protobuf-util, gson, and guava.
+
+General philosophy is many modules rather than a few fat ones so we can keep
+dependency narrow; a fat jar would put a load of unnecessaries on the
+CLASSPATH. The hbase-shaded-miscellaneous is a sort of all-the-rest but it
+is also libs that depend on each other and are awkward to disentangle.
+
+All shading is done using the same relocation offset of
+org.apache.hadoop.hbase.shaded; we add this prefix to the relocated thirdparty
+library class names.
+
+See the pom.xml for the explicit version of each third-party lib included.
+
+Note that in hbase-shaded-protobuf, we unzip the protobuf jar to src/main/java
+rather than to a dir under target because the jar plugin wants src here (its
+hard to convince it otherwise).
+
 To build, just run:
 
  $ mvn install
@@ -18,17 +37,3 @@ To build a src tarball:
 
 (Make sure you have your credentials set over in ~/.m2/settings.xml, etc. -- see
 hbase refguide for publishing SNAPSHOTS/Release Candidates)
-
-We have a number of submodules, one per ornery lib -- protobuf and netty --
-where we need special-handling and then a bucket for all the rest,
-hbase-shaded-miscellaneous. This latter includes protobuf-util, gson, and guava.
-
-All shading is done using the same relocation offset of
-org.apache.hadoop.hbase.shaded; we add this prefix to the relocated thirdparty
-library class names.
-
-See the pom.xml for the explicit version of each third-party lib included.
-
-Note that in hbase-shaded-protobuf, we unzip the protobuf jar to src/main/java
-rather than to a dir under target because the jar plugin wants src here (its
-hard to convince it otherwise).


Mime
View raw message