I intentionally left the function name vague, because it seems like the implementation details for these functions vary slightly from object to object, and new things tend to pop up during testing.  Leaving the function name vague means I don't have to rename it when we find new things that have to be munged for test comparisons.  I do agree that the docs are too vague, though...

my first instinct would be to solve that problem with slightly better docs and/or comments about what we're doing and why, rather than renaming the function, but I could be persuaded otherwise!  Thoughts?