build: allow relwithdebinfo build profile, document build profiles
The main goal here was to add documentation to the build profiles to show which ones enable asserts and logging.
I know I don't understand the scripts well enough, but the treatment of relwithdebinfo seemed inconsistent with other profiles in that it wasn't an acceptable value for the ns3 script.
It also appeared that some of the compiler flags and additional CMAKE flag were not listed correctly.