New option -errfile_log

libisoburn/trunk/xorriso/xorriso.1

@@ -1374,6 +1374,26 @@ Show text at beginning of output line and
 wait for the user to hit the Enter key
 resp. to send a line via stdin.
 .TP
+\fB\-errfile_log\fR mode path|channel
+.br
+If problem events are related to input files from the filesystem, then their
+disk_paths can be logged to a file or to output channels R or I.
+.br
+Mode can either be "plain" or "marked". The latter causes marker lines which
+give the time of log start, burn session start, burn session end, log end
+or program end. In mode "plain", only the file paths are logged.
+.br
+If path is "-" or "-R" then the log is directed to the result channel.
+Path "-I" directs it to the info message channel. Any text that does not
+begin with "-" is used as path for a file to append the log lines.
+.br
+Problematic files can be recorded multiple times during one program run.
+If the program run aborts then the list might not be complete because
+some input file arguments might not have been processed at all.
+.br
+The errfile paths are transported as messages of very low priority "ERRFILE".
+This transport becomes visible with -report_about "ALL".
+.TP
 \fB\-end\fR
 .br
 End program immediately