Indenting Messages

You can indent some of the messages you write. The last parameter to the next_paired, paired, and not_paired functions allows passing an indent.

I encourage you to indent a message when it conceptually belongs to another message. For example:

when you parse directories (and log this).
when, within each directory, you parse each file (and log this). You can think of each message related to a file as conceptually belonging to the message related to the directory to which it belongs

This will allow you to view the Isolated Messages Log and All Messages Log files easier.

A trimmed example of an indented file is shown below:

CPairedMessagesLog< ...>::paired_log DirectoryLog = log.next_paired();
DirectoryLog
  << "Start parsing directory" << strCurrentDirectory << std::endl;

  // for each file
  CPairedMessagesLog< ...>::paired_log FileLog = log.next_paired( 1);
  FileLog
    << "Start parsing file" << strCurrentFile << std::endl;
    // ... code
  FileLog
    << "End parsing file" << strCurrentFile  << std::endl;

DirectoryLog
  << "End parsing directory" << strCurrentDirectory  << std::endl;

Note: indenting is done using tabs.