there's no doc string for this, because it isn't intended to be part of the public api.  I should make it private and fix the macros that call it.