From e236d7a7e0734633e767e3a9589fa34b6d471bf3 Mon Sep 17 00:00:00 2001 From: Andrea Mazzoleni Date: Sat, 20 Jun 2015 16:48:07 +0200 Subject: [PATCH] Clarify a bit the message system in the manual --- snapraid.1 | 13 +++++++++---- snapraid.d | 13 +++++++++---- snapraid.txt | 13 +++++++++---- 3 files changed, 27 insertions(+), 12 deletions(-) diff --git a/snapraid.1 b/snapraid.1 index 74d96200..af3bd984 100644 --- a/snapraid.1 +++ b/snapraid.1 @@ -1054,9 +1054,10 @@ This option can be used only with \[dq]sync\[dq]. .TP .B \-l, \-\-log FILE Write a detailed log in the specified file. -If this option is not specified, the warnings and not fatal -errors are printed on the screen, likely resulting in too much -output in case of many errors. +If this option is not specified, unexpected errors are printed +on the screen, likely resulting in too much output in case of +many errors. When \-l, \-\-log is specified, on the screen, go only +fatal errors that makes SnapRAID to stop progress. If the path starts with \'>>\' the file is opened in append mode. Occurrences of \'%D\' and \'%T\' in the name are replaced with the date and time in the format YYYYMMDD and @@ -1097,13 +1098,17 @@ lose the entire system. .TP .B \-v, \-\-verbose Prints more information on the screen. +If specified one time, it prints excluded files +and more stats. +This option has no effect on the log files. .TP .B \-q, \-\-quiet Prints less information on the screen. If specified one time, removes the progress bar, if two times, the running operations, three times, the info messages, four times the status messages. -Fatal errors are always printed. +Fatal errors are always printed on the screen. +This option has no effect on the log files. .TP .B \-H, \-\-help Prints a short help screen. diff --git a/snapraid.d b/snapraid.d index 3508eb17..d600badc 100644 --- a/snapraid.d +++ b/snapraid.d @@ -778,9 +778,10 @@ Options -l, --log FILE Write a detailed log in the specified file. - If this option is not specified, the warnings and not fatal - errors are printed on the screen, likely resulting in too much - output in case of many errors. + If this option is not specified, unexpected errors are printed + on the screen, likely resulting in too much output in case of + many errors. When -l, --log is specified, on the screen, go only + fatal errors that makes SnapRAID to stop progress. If the path starts with '>>' the file is opened in append mode. Occurrences of '%D' and '%T' in the name are replaced with the date and time in the format YYYYMMDD and @@ -821,13 +822,17 @@ Options -v, --verbose Prints more information on the screen. + If specified one time, it prints excluded files + and more stats. + This option has no effect on the log files. -q, --quiet Prints less information on the screen. If specified one time, removes the progress bar, if two times, the running operations, three times, the info messages, four times the status messages. - Fatal errors are always printed. + Fatal errors are always printed on the screen. + This option has no effect on the log files. -H, --help Prints a short help screen. diff --git a/snapraid.txt b/snapraid.txt index 5d32daa4..3185eae9 100644 --- a/snapraid.txt +++ b/snapraid.txt @@ -837,9 +837,10 @@ SnapRAID provides the following options: -l, --log FILE Write a detailed log in the specified file. - If this option is not specified, the warnings and not fatal - errors are printed on the screen, likely resulting in too much - output in case of many errors. + If this option is not specified, unexpected errors are printed + on the screen, likely resulting in too much output in case of + many errors. When -l, --log is specified, on the screen, go only + fatal errors that makes SnapRAID to stop progress. If the path starts with '>>' the file is opened in append mode. Occurrences of '%D' and '%T' in the name are replaced with the date and time in the format YYYYMMDD and @@ -880,13 +881,17 @@ SnapRAID provides the following options: -v, --verbose Prints more information on the screen. + If specified one time, it prints excluded files + and more stats. + This option has no effect on the log files. -q, --quiet Prints less information on the screen. If specified one time, removes the progress bar, if two times, the running operations, three times, the info messages, four times the status messages. - Fatal errors are always printed. + Fatal errors are always printed on the screen. + This option has no effect on the log files. -H, --help Prints a short help screen.