New option -calm_drive

libisoburn/trunk/xorriso/xorriso.1

@@ -2,7 +2,7 @@
 .\" First parameter, NAME, should be all caps
 .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
 .\" other parameters are allowed: see man(7), man(1)
-.TH XORRISO 1 "Aug 22, 2009"
+.TH XORRISO 1 "Aug 24, 2009"
 .\" Please adjust this date whenever revising the manpage.
 .\"
 .\" Some roff macros, for reference:
@@ -800,6 +800,16 @@ the elsewise trustworthy table-of-content scan for those media.
 To be in effect, the -rom_toc_scan setting has to be made before the -*dev
 command which aquires drive and media.
 .TP
+\fB\-calm_drive\fR "in"|"out"|"all"|"on"|"off"
+Reduce drive noise until it is actually used again. Some drives stay alert
+for substantial time after they have been used for reading. This reduces
+the startup time for the next drive operation but can be loud and waste
+energy if no i/o with the drive is expected to happen soon.
+.br
+Modes "in", "out", "all" immediately calm down -indev, -outdev, resp. both.
+Mode "on" causes -calm_drive to be performed automatically after each -dev,
+-indev, and -outdev. Mode "off" disables this.
+.TP
 \fB\-ban_stdio_write\fR
 Allow for writing only the usage of MMC optical drives. Disallow
 to write the result into files of nearly arbitrary type.
@@ -1498,7 +1508,7 @@ Discard the manipulated ISO image and reload it from -indev.
 \fB\-rollback_end\fR
 Discard the manipulated ISO image. End program without loading a new image.
 .TP
-.B Writing the result:
+.B Writing the result, drive control:
 (see also paragraph about settings below)
 .TP
 \fB\-commit\fR