Remove uneeded compiler and doc variables

Remove "build_docs" variable as it is no longer needed.

Do not call clhep_set_compiler_flags as CMake's default flags are
good enough at present. Add a call to clhep_autoconf_variables in its
place to ensure DIFF_Q is set as some tests use this as an expansion
variable.