Bug fix: -backslash_codes "with_program_arguments" was interpreted too late

libisoburn/trunk/xorriso/xorriso.h

@@ -241,7 +241,7 @@ int Xorriso_destroy(struct XorrisO **xorriso, int flag);
 /* This special interpreter may be called between Xorriso_new() and
    Xorriso_startup_libraries(). It interprets certain commands which shall
    get into effect before the libraries get initialized:
-     -abort_on , -report_about , -return_with , -list_delimiter ,
+     -abort_on , -report_about , -return_with ,
      -scsi_log , -signal_handling
    This is the only occasion where command -x has an effect:
      -x
@@ -251,9 +251,10 @@ int Xorriso_destroy(struct XorrisO **xorriso, int flag);
      -no_rc
    Some get examined for the need to redirect stdout messages:
      -dev , -outdev , -indev , -as 
-   Commands -list_delimiter and -add_plainly get into effect during this
-   call. But their setting at begin of the call gets restored before the
-   call returns.
+   Commands
+     -backslash_codes , -list_delimiter , -add_plainly
+   get into effect during this call. But their setting at begin of the call
+   gets restored before the call returns.
    @param xorriso The context object in which to perform the commands.
    @param argc    Number of arguments.
    @param argv    The arguments. argv[0] contains the program name.
@@ -288,6 +289,17 @@ int Xorriso_read_rc(struct XorrisO *xorriso, int flag);
    replace *argv by a new argument vector. The old one will not be freed
    by this call. If it is dynamic memory then you need to keep a copy of
    the pointer and free it yourself after this call.
+
+   @since 1.3.2:
+   This call internally interprets the commands -backslash_codes and
+   -list_delimiter if it encounters them among the arguments. The
+   decoding of backslashes can thus be enabled and disabled by the
+   arguments themselves. The state of the xorriso object in respect
+   to these commands gets preserved at the start of the call and restored
+   when the call ends.
+   (*argv)[0] never gets decoded.
+   The old *argv will always be replaced by a new one.
+
    @param xorriso The context object
    @param argc    Number of arguments.
    @param argv    The arguments. (*argv)[0] contains the program name.