17 // and continues with lines beginning by ``//`` followed by either a space,
28 // 	// <tab>which needs multiple lines>
36 // the function it documents. This function can span multiple lines and
53 class Lines:  class
54 	def __init__(self, lines):  argument
57 		self.lines = lines
62 		# type: () -> Lines
72 			self.last = next(self.lines).rstrip()
84 def readline_multi(lines, line):  argument
85 	# type: (Lines, str) -> str
88 			(n, l) = next(lines)
93 		lines.undo()
96 def readline_delim(lines, delim):  argument
97 	# type: (Lines, Tuple[str, str]) -> Tuple[int, str]
99 		(lineno, line) = next(lines)
103 			(n, l) = next(lines)
110 def process_block(lines):  argument
111 	# type: (Lines) -> Dict[str, Any]
117 	(n, l) = lines.memo()
128 	for (n, l) in lines:
135 			lines.undo()				## end of doc-block
143 				lines.undo()
152 				l = readline_multi(lines, l)
155 				lines.undo()
157 		elif state == 'PRE-DESC':		## ignore the first empty lines
161 		elif state == 'DESC':			## remaining lines -> description
173 	(n, line) = readline_delim(lines, (')', ';'))
187 	lines = Lines(f)
188 	for (n, l) in lines:
191 			info = process_block(lines)
261 	for (n, lines) in lst:
262 		for l in lines.split('\n'):
291 		for (lineno, lines) in extract(f, filename):
292 			for l in lines.split('\n'):