The logic in our image replacement code needed to take account if the
MIME part was inside a multipart/mixed container or otherwise.  This
patch does that as well as clean up the code path and better document
the API as well as what's going on inside ConversationViewer when the
message is assembled.