Clarification about -as mkisofs pathspecs

This commit is contained in:
Thomas Schmitt 2011-04-07 17:59:31 +00:00
parent 77c7de4ce6
commit f0316cebf7
3 changed files with 59 additions and 42 deletions

View File

@ -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 XORRISOFS 1 "Mar 26, 2011"
.TH XORRISOFS 1 "Apr 07, 2011"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
@ -92,14 +92,15 @@ confuse with the lowlevel ISO 9660 names visible if Rock Ridge gets ignored.)
A program argument is handled as a \fBpathspec\fR, 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.
.br
If -graft-points is present then each pathspec gets split at the first
occurence of the =-character.
The part before the = is taken as \fBtarget\fR, the iso_rr_path for
The part before the = is taken as \fBtarget\fR, i.e. the iso_rr_path for
the file object in the ISO image. The part after the first = is taken
as \fBsource\fR, the disk_path of the input object.
as \fBsource\fR, i.e. the disk_path of the input object.
.br
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
@ -110,6 +111,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.
.br
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.
.SS
\fBRelation to program xorriso:\fR
.br

View File

@ -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

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