New command and -as mkisofs option -genisoimage_completion

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.5.7, Aug 28, 2024"
+.TH XORRISO 1 "Version 1.5.7, Aug 31, 2024"
 .\" Please adjust this date whenever revising the manpage.
 .\"
 .\" Some roff macros, for reference:
@@ -5936,6 +5936,26 @@ VOLI (\-volid) , VOLS (\-volset_id)
 .br
 Any other lines will be silently ignored.
 .TP
+\fB\-genisoimage_completion\fR "on"|"off"
+Enable or disable the completion of genisoimage options during \-as mkisofs
+emulation.
+.br
+If enabled by "on", then unrecognized option arguments which begin by
+a dash '\-' get compared against the known genisoimage options, like program
+genisoimage does unconditionally (and undocumentedly). If the given argument
+matches the beginning of exactly one genisoimage option, then it gets replaced
+by that option.
+Option arguments which consist entirely of a leading dash and letters out of
+"dDfJlNRrTUvz" are not matched but rather interpreted as usual, i.e. as
+multiple options with leading dash and each single letter.
+If no genisoimage option is found or more than one are found, then a SORRY 
+message is issued and the argument stays as is. 
+.br
+If disabled by "off", no completion of options happens. Like with enabled
+completion, option arguments which consist entirely of letters out of
+"dDfJlNRrTUvz" are not matched but rather interpreted as multiple
+arguments with leading dash and each single letter.
+.TP
 \fB\-pacifier\fR behavior_code
 Control behavior of UPDATE pacifiers during write operations.
 The following behavior codes are defined: