From df1ee1191583552e89a6939c8738393044937bae Mon Sep 17 00:00:00 2001
From: Brian Smith <brian@briansmith.org>
Date: Mon, 14 May 2018 15:53:38 -1000
Subject: [PATCH] Clarify wording of `__ANDROID_API__` build documentation.

---
 BUILDING.md | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/BUILDING.md b/BUILDING.md
index 7de1294856..38c06ce27a 100644
--- a/BUILDING.md
+++ b/BUILDING.md
@@ -58,9 +58,11 @@ Note in particular that if you are cross-compiling an x86 build on a 64-bit
 version of Linux, then you need to have the proper gcc-multilibs and
 g++-multilibs packages or equivalent installed.
 
-On Android, you will need to define the `__ANDROID_API__` constant to at least
-`21` on 64-bit and `18` on 32-bit.
-
+If you generate a standalone NDK toolchain in order to compile your project,
+the wrapper automatically passes flags to the actual compiler to define the
+`__ANDROID_API__` macro. Otherwise, the macro `__ANDROID_API__` must be
+defined with a value of at least 21 on 64-bit targets or 18 on 32-bit targets;
+e.g. export `CFLAGS=-D__ANDROID_API__=21`.
 
 
 Additional Features that are Useful for Development