Followup to I76231d6f adding more clarity to the doc blocks that were
changed with respect to when and why they can return different values.
Change-Id: I9afe50c8ee7a74b2c99a89ab19817e466153ba78
Passing around strings that are expected to be safe html and are
known to be based on user input is a fairly unsafe operation. Make
it harder to do the wrong thing by requiring HtmlArmor to be returned
from the ResultSet snippets. This does not address the snippets on
individual result objects as the api surface is larger and requires
more bc handling.
Change-Id: I76231d6fc53c4982eb4cd174d2e6a75eb2740497
