a lot of documentation and shim can change other options