add compatibility with C++ applications

use the normal form of preprocessor define for already-included

add rough documentation


git-svn-id: https://svn.apache.org/repos/asf/apr/apr/trunk@1542779 13f79535-47bb-0310-9956-ffa450edef68