-/* Appends to ST a newline-terminated line read from STREAM.
- Newline is the last character of ST on return, unless an I/O error
- or end of file is encountered after reading some characters.
- Returns true if a line is successfully read, false if no characters at
- all were read before an I/O error or end of file was
- encountered. */
+/* Appends to ST a newline-terminated line read from STREAM, but
+ no more than MAX_LENGTH characters.
+ Newline is the last character of ST on return, if encountering
+ a newline was the reason for terminating.
+ Returns true if at least one character was read from STREAM
+ and appended to ST, false if no characters at all were read
+ before an I/O error or end of file was encountered (or
+ MAX_LENGTH was 0). */