diff --git a/BUILDING.txt b/BUILDING.txt
index 40ad2564cd..7e3d450953 100644
--- a/BUILDING.txt
+++ b/BUILDING.txt
@@ -139,6 +139,15 @@ Create a local staging version of the website (in /tmp/hadoop-site)
 
 ----------------------------------------------------------------------------------
 
+Building on OS/X
+
+----------------------------------------------------------------------------------
+
+Hadoop does not build on OS/X with Java 7.
+see: https://issues.apache.org/jira/browse/HADOOP-9350
+
+----------------------------------------------------------------------------------
+
 Building on Windows
 
 ----------------------------------------------------------------------------------