parameters: (comments)
return_statement: return format_block(comments)
docstring: Format a list of comment blocks from SourceCodeInfo.
  
      Prefixes // to each line, separates blocks by spaces.
  
      Args:
          comments: a list of blocks, each block is a list of strings representing
             lines in each block.
  
      Returns:
          A string reprenting the formatted comment blocks.
docstring_summary: Format a list of comment blocks from SourceCodeInfo.
docstring_tokens: Format a list of comment blocks from SourceCodeInfo .
function: def format_comments(comments):
      """Format a list of comment blocks from SourceCodeInfo.
  
      Prefixes // to each line, separates blocks by spaces.
  
      Args:
          comments: a list of blocks, each block is a list of strings representing
             lines in each block.
  
      Returns:
          A string reprenting the formatted comment blocks.
      """
  
      # TODO(htuch): not sure why this is needed, but clang-format does some weird
      # stuff with // comment indents when we have these trailing \
      def fixup_trailing_backslash(s):
          return s[:-1].rstrip() if s.endswith('\\') else s
  
      comments = '\n\n'.join(
          '\n'.join(['//%s' % fixup_trailing_backslash(line)
                     for line in comment.split('\n')[:-1]])
          for comment in comments)
      return format_block(comments)
function_tokens: def format_comments ( comments ) : # TODO(htuch): not sure why this is needed, but clang-format does some weird # stuff with // comment indents when we have these trailing \ def fixup_trailing_backslash ( s ) : return s [ : - 1 ] . rstrip ( ) if s . endswith ( '\\' ) else s comments = '\n\n' . join ( '\n' . join ( [ '//%s' % fixup_trailing_backslash ( line ) for line in comment . split ( '\n' ) [ : - 1 ] ] ) for comment in comments ) return format_block ( comments )