- that ends in a non-newline character. Do not null terminate,
- but leave room for an extra byte after the newline.
- Return LINEBUFFER, except at end of file return 0. */
-
+ that ends in a non-newline character. Do not null terminate.
+ Therefore the stream can contain NUL bytes, and the length
+ (including the newline) is returned in linebuffer->length.
+ Return NULL upon error, or when STREAM is empty.
+ Otherwise, return LINEBUFFER. */