Clarified meaning of "After commit" prediction of -tell_media_space

libisoburn/trunk/xorriso/xorriso.1

@@ -9,7 +9,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 "Version 1.2.7, Jan 08, 2013"
+.TH XORRISO 1 "Version 1.2.7, Jan 15, 2013"
 .\" Please adjust this date whenever revising the manpage.
 .\"
 .\" Some roff macros, for reference:
@@ -3493,6 +3493,13 @@ then \-padding (300 kB by default) is not counted as part of the image size.
 \fB\-tell_media_space\fR
 Print available space on the output medium and the free space after
 subtracting already foreseeable consumption by next \-commit.
+.br
+Note that the title of the prediction "After commit :" is misleading.
+It is rather the space that may still be filled in this session without
+making the next \-commit fail from medium overflow.
+.br
+The free space after the next \-commit might be smaller by several MB.
+This depends on medium type, number of recorded sessions, and drive habits.
 .TP
 \fB\-pvd_info\fR 
 Print various ID strings which can be found in loaded ISO images. Some of

libisoburn/trunk/xorriso/xorriso.info

@@ -3060,6 +3060,13 @@ File: xorriso.info,  Node: Inquiry,  Next: Navigate,  Prev: DialogCtl,  Up: Comm
 -tell_media_space
      Print available space on the output medium and the free space after
      subtracting already foreseeable consumption by next -commit.
+     Note that the title of the prediction "After commit :" is
+     misleading.  It is rather the space that may still be filled in
+     this session without making the next -commit fail from medium
+     overflow.
+     The free space after the next -commit might be smaller by several
+     MB.  This depends on medium type, number of recorded sessions, and
+     drive habits.
 
 -pvd_info
      Print various ID strings which can be found in loaded ISO images.
@@ -4823,7 +4830,7 @@ File: xorriso.info,  Node: CommandIdx,  Next: ConceptIdx,  Prev: Legal,  Up: Top
 * -prog_help   prints help text:         Frontend.            (line 154)
 * -prompt   prompts for enter key:       Scripting.           (line 110)
 * -publisher   sets publisher id:        SetWrite.            (line 186)
-* -pvd_info   shows image id strings:    Inquiry.             (line 104)
+* -pvd_info   shows image id strings:    Inquiry.             (line 111)
 * -pwd   tells working directory in ISO: Navigate.            (line  20)
 * -pwdx   tells working directory on disk: Navigate.          (line  23)
 * -quoted_not_list   sets exclusions:    SetInsert.           (line  72)
@@ -5003,7 +5010,7 @@ File: xorriso.info,  Node: ConceptIdx,  Prev: CommandIdx,  Up: Top
 * Image, set volume id, -volid:          SetWrite.            (line 160)
 * Image, set volume set id, -volset_id:  SetWrite.            (line 181)
 * Image, set volume timestamp, -volume_date: SetWrite.        (line 208)
-* Image, show id strings, -pvd_info:     Inquiry.             (line 104)
+* Image, show id strings, -pvd_info:     Inquiry.             (line 111)
 * Insert, enable overwriting, -overwrite: SetInsert.          (line 127)
 * Insert, file exclusion absolute, -not_paths: SetInsert.     (line  55)
 * Insert, file exclusion from file, -not_list: SetInsert.     (line  67)
@@ -5200,34 +5207,34 @@ Node: Charset140512
 Node: Exception143274
 Node: DialogCtl149394
 Node: Inquiry151992
-Node: Navigate157452
-Node: Verify165750
-Node: Restore174782
-Node: Emulation181869
-Node: Scripting191681
-Node: Frontend198842
-Node: Examples206917
-Node: ExDevices208095
-Node: ExCreate208754
-Node: ExDialog210039
-Node: ExGrowing211304
-Node: ExModifying212109
-Node: ExBootable212613
-Node: ExCharset213165
-Node: ExPseudo213986
-Node: ExCdrecord214884
-Node: ExMkisofs215201
-Node: ExGrowisofs216541
-Node: ExException217676
-Node: ExTime218130
-Node: ExIncBackup218589
-Node: ExRestore222581
-Node: ExRecovery223541
-Node: Files224111
-Node: Seealso225410
-Node: Bugreport226133
-Node: Legal226714
-Node: CommandIdx227725
-Node: ConceptIdx243954
+Node: Navigate157828
+Node: Verify166126
+Node: Restore175158
+Node: Emulation182245
+Node: Scripting192057
+Node: Frontend199218
+Node: Examples207293
+Node: ExDevices208471
+Node: ExCreate209130
+Node: ExDialog210415
+Node: ExGrowing211680
+Node: ExModifying212485
+Node: ExBootable212989
+Node: ExCharset213541
+Node: ExPseudo214362
+Node: ExCdrecord215260
+Node: ExMkisofs215577
+Node: ExGrowisofs216917
+Node: ExException218052
+Node: ExTime218506
+Node: ExIncBackup218965
+Node: ExRestore222957
+Node: ExRecovery223917
+Node: Files224487
+Node: Seealso225786
+Node: Bugreport226509
+Node: Legal227090
+Node: CommandIdx228101
+Node: ConceptIdx244330
 
 End Tag Table

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.2.7, Jan 08, 2013"
+@c man .TH XORRISO 1 "Version 1.2.7, Jan 15, 2013"
 @c man .\" Please adjust this date whenever revising the manpage.
 @c man .\"
 @c man .\" Some roff macros, for reference:
@@ -4091,6 +4091,13 @@ then -padding (300 kB by default) is not counted as part of the image size.
 @cindex Write, free space, -tell_media_space
 Print available space on the output medium and the free space after
 subtracting already foreseeable consumption by next -commit.
+@*
+Note that the title of the prediction "After commit :" is misleading.
+It is rather the space that may still be filled in this session without
+making the next -commit fail from medium overflow.
+@*
+The free space after the next -commit might be smaller by several MB.
+This depends on medium type, number of recorded sessions, and drive habits.
 @c man .TP
 @item -pvd_info 
 @kindex -pvd_info   shows image id strings