Mentioned peculiar -changes_pending behavior of filter attaching

libisoburn/trunk/xorriso/xorriso.1

@@ -1968,6 +1968,10 @@ The reserved filter name "\-\-remove\-all\-filters" revokes
 filtering. This will revoke suffix renamings as well.
 Use "\-\-remove\-all\-filters+" to
 prevent any suffix renaming.
+.br
+Attaching or detaching filters will not alter the state of \-changes_pending.
+If the filter manipulations shall be the only changes in a write run, then
+explicitely execute \-changes_pending "yes".
 .TP
 \fB\-set_filter_r\fR name iso_rr_path [***]
 Like \-set_filter but affecting all data files below eventual directories.

libisoburn/trunk/xorriso/xorriso.info

@@ -1757,6 +1757,10 @@ there are many small files.
      The reserved filter name "--remove-all-filters" revokes filtering.
      This will revoke suffix renamings as well.  Use
      "--remove-all-filters+" to prevent any suffix renaming.
+     Attaching or detaching filters will not alter the state of
+     -changes_pending.  If the filter manipulations shall be the only
+     changes in a write run, then explicitely execute -changes_pending
+     "yes".
 
 -set_filter_r name iso_rr_path [***]
      Like -set_filter but affecting all data files below eventual
@@ -4481,7 +4485,7 @@ File: xorriso.info,  Node: CommandIdx,  Next: ConceptIdx,  Prev: Legal,  Up: Top
 * -session_log   logs written sessions:  Scripting.           (line 138)
 * -session_string   composes session info line: Inquiry.      (line  67)
 * -set_filter   applies filter to file:  Filter.              (line  60)
-* -set_filter_r   applies filter to file tree: Filter.        (line  85)
+* -set_filter_r   applies filter to file tree: Filter.        (line  89)
 * -setfacl   sets ACL in ISO image:      Manip.               (line  73)
 * -setfacl_list   sets ACL in ISO image: Manip.               (line 101)
 * -setfacl_r   sets ACL in ISO image:    Manip.               (line  98)
@@ -4594,7 +4598,7 @@ File: xorriso.info,  Node: ConceptIdx,  Prev: CommandIdx,  Up: Top
 * Examples:                              Examples.            (line   6)
 * extattr, _definiton:                   Extras.              (line  54)
 * Filter, _definition:                   Filter.              (line   6)
-* Filter, apply to file tree, -set_filter_r: Filter.          (line  85)
+* Filter, apply to file tree, -set_filter_r: Filter.          (line  89)
 * Filter, apply to file, -set_filter:    Filter.              (line  60)
 * Filter, ban registration, -close_filter_list: Filter.       (line  52)
 * Filter, register, -external_filter:    Filter.              (line  20)
@@ -4803,42 +4807,42 @@ Node: SetInsert53787
 Node: Manip62358
 Node: CmdFind71091
 Node: Filter83198
-Node: Writing87536
+Node: Writing87753
-Node: SetWrite96495
+Node: SetWrite96712
-Node: Bootable110800
+Node: Bootable111017
-Node: Jigdo124021
+Node: Jigdo124238
-Node: Charset128267
+Node: Charset128484
-Node: Exception131026
+Node: Exception131243
-Node: DialogCtl137139
+Node: DialogCtl137356
-Node: Inquiry139734
+Node: Inquiry139951
-Node: Navigate144597
+Node: Navigate144814
-Node: Verify152857
+Node: Verify153074
-Node: Restore161524
+Node: Restore161741
-Node: Emulation168430
+Node: Emulation168647
-Node: Scripting178229
+Node: Scripting178446
-Node: Frontend185381
+Node: Frontend185598
-Node: Examples186681
+Node: Examples186898
-Node: ExDevices187858
+Node: ExDevices188075
-Node: ExCreate188517
+Node: ExCreate188734
-Node: ExDialog189800
+Node: ExDialog190017
-Node: ExGrowing191063
+Node: ExGrowing191280
-Node: ExModifying191868
+Node: ExModifying192085
-Node: ExBootable192371
+Node: ExBootable192588
-Node: ExCharset192923
+Node: ExCharset193140
-Node: ExPseudo193743
+Node: ExPseudo193960
-Node: ExCdrecord194641
+Node: ExCdrecord194858
-Node: ExMkisofs194958
+Node: ExMkisofs195175
-Node: ExGrowisofs196298
+Node: ExGrowisofs196515
-Node: ExException197433
+Node: ExException197650
-Node: ExTime197887
+Node: ExTime198104
-Node: ExIncBackup198346
+Node: ExIncBackup198563
-Node: ExRestore202332
+Node: ExRestore202549
-Node: ExRecovery203292
+Node: ExRecovery203509
-Node: Files203862
+Node: Files204079
-Node: Seealso205160
+Node: Seealso205377
-Node: Bugreport205883
+Node: Bugreport206100
-Node: Legal206464
+Node: Legal206681
-Node: CommandIdx207394
+Node: CommandIdx207611
-Node: ConceptIdx222709
+Node: ConceptIdx222926
 
 End Tag Table

libisoburn/trunk/xorriso/xorriso.texi

@@ -2369,6 +2369,10 @@ The reserved filter name "@minus{}@minus{}remove-all-filters" revokes
 filtering. This will revoke suffix renamings as well.
 Use "@minus{}@minus{}remove-all-filters+" to
 prevent any suffix renaming.
+@*
+Attaching or detaching filters will not alter the state of -changes_pending.
+If the filter manipulations shall be the only changes in a write run, then
+explicitely execute -changes_pending "yes".
 @c man .TP
 @item -set_filter_r name iso_rr_path [***]
 @kindex -set_filter_r   applies filter to file tree