plugins/include/files.inc
changeset 2445 b0cefeafe09a
parent 2307 cc1c784f8754
child 4199 6e0c63e83c8a
     1.1 --- a/plugins/include/files.inc	Sat Nov 29 20:07:43 2008 -0600
     1.2 +++ b/plugins/include/files.inc	Sat Nov 29 22:43:30 2008 -0600
     1.3 @@ -176,11 +176,11 @@
     1.4   * @param hndl			Handle to the file.
     1.5   * @param buffer		Buffer to store the string.
     1.6   * @param max_size		Maximum size of the string buffer.
     1.7 - * @param stop			If true, reading will stop once max_size-1 bytes have 
     1.8 - *						been read.  If false, reading will stop once a NUL 
     1.9 - *						terminator is reached.  The buffer will simply be 
    1.10 - *						terminated in either case, the difference is in how 
    1.11 - *						the far the file position is changed.
    1.12 + * @param read_count	If -1, reads until a null terminator is encountered in 
    1.13 + *						the file.  Otherwise, read_count bytes are read 
    1.14 + *						into the buffer provided.  In this case the buffer 
    1.15 + *						is not explicitly null terminated, and the buffer 
    1.16 + *						will contain any null terminators read from the file.
    1.17   * @return				Number of characters written to the buffer, or -1 
    1.18   *						if an error was encountered.
    1.19   * @error				Invalid Handle, or read_count > max_size.