documentation/ion: Add description for secure carveout heap

Add documentation for the secure carveout heap which helps
manage secure memory that is not accessible by the HLOS.

Change-Id: I549d4a434f839f5005750cc2fcd435f00f8eb370
Signed-off-by: Swathi Sridhar <swatsrid@codeaurora.org>