Ensure html_escape docs are picked up by Yard

Move documentation blocks for html_escape and escape_once next to the
respective method definitions for Ruby 1.9+ so that Yard correctly
includes them.