Clarification about -as mkisofs pathspecs

This commit is contained in:
2011-04-07 17:59:31 +00:00
parent c569b4d4ce
commit 2fdc41a357
3 changed files with 59 additions and 42 deletions

View File

@ -44,7 +44,7 @@
@c man .\" First parameter, NAME, should be all caps
@c man .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
@c man .\" other parameters are allowed: see man(7), man(1)
@c man .TH XORRISOFS 1 "Mar 26, 2011"
@c man .TH XORRISOFS 1 "Apr 07, 2011"
@c man .\" Please adjust this date whenever revising the manpage.
@c man .\"
@c man .\" Some roff macros, for reference:
@ -182,14 +182,15 @@ confuse with the lowlevel ISO 9660 names visible if Rock Ridge gets ignored.)
A program argument is handled as a @strong{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.
If option -graft-points 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 @strong{target}, the iso_rr_path for
The part before the = is taken as @strong{target}, i.e. the iso_rr_path for
the file object in the ISO image. The part after the first = is taken
as @strong{source}, the disk_path of the input object.
as @strong{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
@ -201,6 +202,11 @@ 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.
@c man .SS
@node Xorriso, Options, Insert, Top
@chapter Relation to program xorriso