const file_info *find(const filename &to_check) const;
//!< locates the record of information for the filename "to_check".
/*!< do not modify the returned object. it contains the current state
- of the file in question. if the file wasn't in the list, then NIL is
+ of the file in question. if the file wasn't in the list, then NULL_POINTER is
returned. */
int locate(const filename &to_find) const;
true if the size is different (when EQUAL_FILESIZE is true), when the timestamp is different
(when EQUAL_TIMESTAMP is true), and when the checksum is different (you get the idea). */
- basis::astring text_form() const;
+ //! max_lines is the maximum number of lines to print into the string.
+ basis::astring text_form(int max_lines = MAXINT32) const;
virtual int packed_size() const;