docs: def parse_lit(self, lines):
          '''
          Parse a string line-by-line delineating comments and code
  
          :returns: An tuple of boolean/list-of-string pairs. True designates a
              comment; False designates code.
          '''
          comment_char = '#' # TODO: move this into a directive option
          comment = re.compile(r'^\s*{0}[ \n]'.format(comment_char))
          section_test = lambda val: bool(comment.match(val))
  
          sections = []
          for is_doc, group in itertools.groupby(lines, section_test):
              if is_doc:
                  text = [comment.sub('', i).rstrip('\r\n') for i in group]
              else:
                  text = [i.rstrip('\r\n') for i in group]
  
              sections.append((is_doc, text))
  
          return sections