(re)enable generation of debug symbols

Debug symbols are disabled in Release builds by default,
but should be enabled for (iOS-)static libraries,
so the symbols end up in the app's dSYMs
cleanup

sort build options alphabetically so it's easier
to spot duplicates.
Also document them individually.
Move to general StaticLibrary config, minor doc rewrite
Merge pull request #12