Update documentation for parser tools a bit.

This commit is contained in:
Richard Heck 2013-05-23 15:12:03 -04:00
parent 7e4513b9fe
commit eba17c9763

View File

@ -19,7 +19,7 @@
''' '''
This modules offer several free functions to help parse lines. This module offers several free functions to help parse lines.
More documentaton is below, but here is a quick guide to what More documentaton is below, but here is a quick guide to what
they do. Optional arguments are marked by brackets. they do. Optional arguments are marked by brackets.
@ -32,11 +32,11 @@ find_token(lines, token, start[, end[, ignorews]]):
extra whitespace following token itself. extra whitespace following token itself.
find_token_exact(lines, token, start[, end]): find_token_exact(lines, token, start[, end]):
As find_token, but with ignorews True. As find_token, but with ignorews set to True.
find_tokens(lines, tokens, start[, end[, ignorews]]): find_tokens(lines, tokens, start[, end[, ignorews]]):
Returns the first line i, start <= i < end, on which Returns the first line i, start <= i < end, on which
oen of the tokens in tokens is found at the beginning. one of the tokens in tokens is found at the beginning.
Returns -1 if not found. Returns -1 if not found.
If ignorews is (given and) True, then differences If ignorews is (given and) True, then differences
in whitespace do not count, except that there must be no in whitespace do not count, except that there must be no
@ -137,7 +137,6 @@ get_containing_layout(lines, i):
As get_containing_inset, but for layout. Additionally returns the As get_containing_inset, but for layout. Additionally returns the
position of real paragraph start (after par params) as 4th value. position of real paragraph start (after par params) as 4th value.
find_nonempty_line(lines, start[, end): find_nonempty_line(lines, start[, end):
Finds the next non-empty line. Finds the next non-empty line.