Clarification about -as mkisofs pathspecs

libisoburn/trunk/xorriso/xorrisofs.info

@@ -95,13 +95,14 @@ Ridge gets ignored.)
 A program argument is handled as a *pathspec*, if it is not recognized
 as original mkisofs option or additional xorrisofs option.  A pathspec
 depicts an input file object by a disk_path.  If option -graft-points
-is not present, then this file object gets copied into the /-directory
-of the ISO image.
+is not present, then the behavior depends on the file type of
+disk_path. Directories get merged with the /-directory of the ISO
+image. Files of other types get copied into the /-directory.
 If -graft-points is present then each pathspec gets split at the first
 occurence of the =-character.  The part before the = is taken as
-*target*, the iso_rr_path for the file object in the ISO image. The
-part after the first = is taken as *source*, the disk_path of the input
-object.
+*target*, i.e. the iso_rr_path for the file object in the ISO image.
+The part after the first = is taken as *source*, i.e. the disk_path of
+the input object.
 It is possible to make =-characters part of the iso_rr_path by
 preceeding them with a \-character. The same must be done for
 \-characters which shall be part of the iso_rr_path.
@@ -110,6 +111,10 @@ If the source part of the pathspec leads to a directory, then all files
 underneath this directory get inserted into the image, too.  It is
 possible to exclude particular files from being inserted by help of
 option -m.
+In case that target already exists, the following rules apply:
+Directories and other files may overwrite existing non-directories.
+Directories get merged with existing directories.  Non-directories may
+not overwrite existing directories.
 
 
 File: xorrisofs.info,  Node: Xorriso,  Next: Options,  Prev: Insert,  Up: Top
@@ -1780,32 +1785,32 @@ Node: Top397
 Node: Overview1052
 Node: Standards1488
 Node: Insert3163
-Node: Xorriso4584
-Node: Options5720
-Node: Loading6437
-Node: SetInsert8731
-Node: SetProduct13133
-Node: SetCompl16840
-Node: SetExtras19159
-Node: SetHide22031
-Node: ImageId23039
-Node: Bootable26543
-Node: SystemArea30623
-Node: Charset36983
-Node: Jigdo38008
-Node: Miscellaneous42289
-Node: Examples43462
-Node: ExSimple43948
-Node: ExGraft44427
-Node: ExMkisofs45674
-Node: ExGrowisofs46925
-Node: ExIncBackup48097
-Node: ExIncBckAcc51146
-Node: ExBootable52821
-Node: Files54920
-Node: Seealso55990
-Node: Legal56505
-Node: CommandIdx57301
-Node: ConceptIdx68634
+Node: Xorriso4932
+Node: Options6068
+Node: Loading6785
+Node: SetInsert9079
+Node: SetProduct13481
+Node: SetCompl17188
+Node: SetExtras19507
+Node: SetHide22379
+Node: ImageId23387
+Node: Bootable26891
+Node: SystemArea30971
+Node: Charset37331
+Node: Jigdo38356
+Node: Miscellaneous42637
+Node: Examples43810
+Node: ExSimple44296
+Node: ExGraft44775
+Node: ExMkisofs46022
+Node: ExGrowisofs47273
+Node: ExIncBackup48445
+Node: ExIncBckAcc51494
+Node: ExBootable53169
+Node: Files55268
+Node: Seealso56338
+Node: Legal56853
+Node: CommandIdx57649
+Node: ConceptIdx68982
 
 End Tag Table