New -close mode "as_needed"

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.3.3, Oct 08, 2013"
+@c man .TH XORRISO 1 "Version 1.3.3, Oct 14, 2013"
 @c man .\" Please adjust this date whenever revising the manpage.
 @c man .\"
 @c man .\" Some roff macros, for reference:
@@ -3271,14 +3271,23 @@ is 4 MiB, minimum 64 kiB, maximum 1 GiB.
 The number may be followed by letter "k" or "m"
 which means unit is kiB (= 1024) or MiB (= 1024 kiB).
 @c man .TP
-@item -close "on"|"off"
+@item -close "on"|"off"|"as_needed"
 @kindex -close   controls media closing
 @cindex Write, close media, -close
-If "on" then mark the written medium as not appendable
-any more (if possible at all with the given type of target media).
-@*
-This is the contrary of cdrecord, wodim, cdrskin command -multi,
+If -close is set to "on" then mark the written medium as not appendable
+any more. This will have no effect on overwritable media types.
+Setting "on" is the contrary of cdrecord option -multi,
 and is one aspect of growisofs option -dvd-compat.
+@*
+If set to "off" then keep the medium writable for an appended session.
+@*
+If set to "as_needed" then use "on" only if "off" is predicted to
+fail with the given medium and its state. But not all drives correctly
+recognize fast-blanked DVD-RW which need "on".
+@*
+Note that emulation command -as "cdrecord" temporarily overrides
+the current setting of -close by its own default -close "on" if
+its option -multi is missing.
 @c man .TP
 @item -write_type "auto"|"tao"|"sao/dao"
 @kindex -write_type   chooses TAO or SAO/DAO