- be determined. In this case segmenter_push() returns -1. The caller should
- obtain more input and then call segmenter_push() again with a larger N and
- repeat until the input is exhausted (which must be indicated as described
- above) or until a valid segment is returned. segmenter_push() will never
- return -1 when the end of input is visible within INPUT.
+ be determined. In this case segmenter_push() returns -1. If more input is
+ available, the caller should obtain some more, then call again with a larger
+ N. If this is not enough, the process might need to repeat again and agin.
+ If input is exhausted, then the caller may call again setting EOF to true.
+ segmenter_push() will never return -1 when EOF is true.