updated API doc to match new generate_entrances()