Add Doxygen documentation for configuration macros and error handling

This pull-request adds two groups of Doxygen documentation, most importantly covering the different preprocessor macros to customize the library use.

The only code change is the addition of a protected `SetParseError` function to hide the name of the `parseResult_` member from the user (through the documentation of `RAPIDJSON_PARSE_ERROR_NORETURN`.