99% of these two implementations are the same, so abstract it out into a
seperate function.  Also add another bunch of comments.
Signed-off-by: Dave Jones <davej@redhat.com>