parameters: (comment)
return_statement: return comment
docstring: Intended to process the text *between* (and not including) the @system and
      @endsystem tags.
      This normalizes against C++ comments as they are seen by `mkdoc`
      (`clang.cindex`).
      - /// and leading * comments markings are simply removed, as we expect the
      tag to reside in a comment block.
      - // comments imply that the remainder of the line should be removed.
docstring_summary: Intended to process the text *between* (and not including) the
docstring_tokens: Intended to process the text * between * ( and not including ) the
function: def strip_cpp_comment_cruft(comment):
      """
      Intended to process the text *between* (and not including) the @system and
      @endsystem tags.
      This normalizes against C++ comments as they are seen by `mkdoc`
      (`clang.cindex`).
      - /// and leading * comments markings are simply removed, as we expect the
      tag to reside in a comment block.
      - // comments imply that the remainder of the line should be removed.
      """
      comment = re.sub(r'///', '', comment)
      comment = re.sub(r'\s*//.*', '', comment)
      comment = re.sub(r'^\s*\*', '', comment, flags=re.MULTILINE)
      return comment
function_tokens: def strip_cpp_comment_cruft ( comment ) : comment = re . sub ( r'///' , '' , comment ) comment = re . sub ( r'\s*//.*' , '' , comment ) comment = re . sub ( r'^\s*\*' , '' , comment , flags = re . MULTILINE ) return comment