Fuller notes on the 'base_name' argument.  Closes #1160.