Merge r1542779 from trunk:

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/branches/1.5.x@1542783 13f79535-47bb-0310-9956-ffa450edef68