docs: def translate_comment(self, comment, link_resolver):
          """
          Given a gtk-doc comment string, returns the comment translated
          to the desired format.
          """
          out = u''
  
          self.translate_tags(comment, link_resolver)
          ast = self.comment_to_ast(comment, link_resolver)
          out += self.ast_to_html(ast, link_resolver)
          return out