obey short/long parameter conventions