Enhanced option -extract_cut for handling filtered files

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 "May 09, 2009"
+.TH XORRISO 1 "May 14, 2009"
 .\" Please adjust this date whenever revising the manpage.
 .\"
 .\" Some roff macros, for reference:
@@ -1138,7 +1138,7 @@ Examples:
 .br
                   /usr/bin/bzip2 --
 .br
- -external_filter bunzip2 suffix=.bz2:remove_suffix:if_nonempty \\
+ -external_filter bunzip2 suffix=.bz2:remove_suffix \\
 .br
                   /usr/bin/bunzip2 --
 .TP
@@ -2131,7 +2131,8 @@ With occasion "file_extraction" there are three behaviors:
 .br
 "delete" removes files which encountered errors during content extraction.
 .br
-"best_effort" starts a revovery attempt by means of -extract_cut.
+"best_effort" starts a revovery attempt by means of -extract_cut if the
+file content stems from the loaded ISO image and is not filtered.
 .TP
 .B Dialog mode control:
 .TP
@@ -2633,17 +2634,15 @@ composed from iso_rr_path by replacing iso_rr_prefix by disk_prefix.
 \fB\-extract_cut\fR iso_rr_path byte_offset byte_count disk_path
 Copy a byte interval from a data file out of an ISO image into a newly created
 disk file.
-Two restrictions apply:
+The main purpose for this is to allow handling of large files if they
+are not supported by mount -t iso9660 and if the reading system is unable
+to buffer them as a whole.
 .br
-The data bytes of iso_rr_path need to be already stored in the loaded ISO image
-and byte_offset must be a multiple of 2048, e.g. an integer with suffix
-s, m, or g.
-.br
-This option is implemented by a special run of -check_media and governed by
-most of the options which can be set by -check_media_defaults.
-Its main purpose is to allow handling of large files if they are not supported
-by mount -t iso9660 and if the reading system is unable to buffer them as
-a whole.
+If the data bytes of iso_rr_path are stored in the loaded ISO image,
+and no filter is applied,
+and byte_offset is a multiple of 2048, then a special run of -check_media
+is performed. It may be quicker and more rugged than the general reading
+method.
 .TP
 \fB\-cpx\fR iso_rr_path [***] disk_path
 Extract single leaf file objects from the ISO image and store them under