Changed defaults of new command -modesty_on_drive to suit concurrent SG_IO

libisoburn/trunk/xorriso/xorriso.texi

@@ -50,7 +50,7 @@
 @c man .\" First parameter, NAME, should be all caps
 @c man .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
 @c man .\" other parameters are allowed: see man(7), man(1)
-@c man .TH XORRISO 1 "Version 1.4.1, Jul 30, 2015"
+@c man .TH XORRISO 1 "Version 1.4.1, Aug 29, 2015"
 @c man .\" Please adjust this date whenever revising the manpage.
 @c man .\"
 @c man .\" Some roff macros, for reference:
@@ -3384,15 +3384,20 @@ E.g.: -modesty_on_drive 75
 @*
 The optimal values depend on the buffer behavior of the drive.
 @*
-There are also timing parameters "timeout_sec=", "min_usec=", "max_usec=".
-Read the description of burn_drive_set_buffer_waiting() in libburn.h,
-before setting them to non-default values.
+Parameter "timeout_sec=" defines after which time of unsuccessful waiting
+the modesty shall be disabled because it does not work.
+@*
+Parameter "min_usec=" defines the initial sleeping period in microseconds.
+If the drive buffer appears to be too full for sending more data, the
+program will wait the given time and inquire the buffer fill state again.
+If repeated inquiry shows not enough free space, the sleep time will
+slowly be increased to what parameter "max_usec=" defines.
 @*
 Parameters, which are not mentioned with a -modesty_on_drive command,
 stay unchanged. 
 Default is:
 @*
-  -modesty_on_drive off:min_percent=65:max_percent=95
+  -modesty_on_drive off:min_percent=90:max_percent=95:timeout_sec=120:min_usec=5000:max_usec=25000
 @c man .TP
 @item -stdio_sync "on"|"off"|"end"|number
 @kindex -stdio_sync   controls stdio buffer