CC @bagnell.  Do these functions need doc or to be marked as `@private`?