From 5a5764fa74f01479238dae16a30ac31cf4a90f63 Mon Sep 17 00:00:00 2001 From: Thomas Schmitt Date: Tue, 17 May 2011 09:42:51 +0000 Subject: [PATCH] Updated generated manuals --- libisoburn/trunk/xorriso/xorriso.1 | 12 ++ libisoburn/trunk/xorriso/xorriso.info | 141 +++++++++++-------- libisoburn/trunk/xorriso/xorrisofs.1 | 52 ++++--- libisoburn/trunk/xorriso/xorrisofs.info | 177 +++++++++++++----------- 4 files changed, 225 insertions(+), 157 deletions(-) diff --git a/libisoburn/trunk/xorriso/xorriso.1 b/libisoburn/trunk/xorriso/xorriso.1 index 9f36e333..3ec9f47c 100644 --- a/libisoburn/trunk/xorriso/xorriso.1 +++ b/libisoburn/trunk/xorriso/xorriso.1 @@ -4625,6 +4625,18 @@ ACL and xattr .TP MD5 checksums .BR md5sum(1) +.SH BUGS +To report bugs or to suggest enhancements for \fBxorriso\fR, please +send electronic mail to the public lists +or . If more privacy is desired, mail +to . +.br +Please describe what you expect \fBxorriso\fR to do, +the program arguments resp. commands by which you tried to achieve it, +the messages of \fBxorriso\fR, and the undesirable outcome of your +program run. +.br +Expect to get asked more questions before solutions can be proposed. .SH AUTHOR Thomas Schmitt .br diff --git a/libisoburn/trunk/xorriso/xorriso.info b/libisoburn/trunk/xorriso/xorriso.info index e3dc8352..9e4406d9 100644 --- a/libisoburn/trunk/xorriso/xorriso.info +++ b/libisoburn/trunk/xorriso/xorriso.info @@ -35,6 +35,7 @@ images with Rock Ridge extensions. * Examples:: Examples * Files:: Files * Seealso:: See also +* Bugreport:: Reporting bugs * Legal:: Author, Copyright, Credits * CommandIdx:: Alphabetic Command List * ConceptIdx:: Alphabetic List of Concepts and Objects @@ -4072,7 +4073,7 @@ The default setting of -check_media abort_file= is: /var/opt/xorriso/do_abort_check_media  -File: xorriso.info, Node: Seealso, Next: Legal, Prev: Files, Up: Top +File: xorriso.info, Node: Seealso, Next: Bugreport, Prev: Files, Up: Top 12 See also *********** @@ -4099,18 +4100,35 @@ MD5 checksums md5sum(1)  -File: xorriso.info, Node: Legal, Next: CommandIdx, Prev: Seealso, Up: Top +File: xorriso.info, Node: Bugreport, Next: Legal, Prev: Seealso, Up: Top -13 Author, Copyright, Credits +13 Reporting bugs +***************** + +To report bugs or to suggest enhancements for `xorriso', please send +electronic mail to the public lists or +. If more privacy is desired, mail to +. + +Please describe what you expect `xorriso' to do, the program arguments +resp. commands by which you tried to achieve it, the messages of +`xorriso', and the undesirable outcome of your program run. + +Expect to get asked more questions before solutions can be proposed. + + +File: xorriso.info, Node: Legal, Next: CommandIdx, Prev: Bugreport, Up: Top + +14 Author, Copyright, Credits ***************************** -13.1 Author +14.1 Author =========== Thomas Schmitt for libburnia-project.org -13.2 Copyright +14.2 Copyright ============== Copyright (c) 2007 - 2011 Thomas Schmitt @@ -4119,7 +4137,7 @@ modified in sync with the technical properties of `xorriso'. If you make use of the license to derive modified versions of `xorriso' then you are entitled to modify this text under that same license. -13.3 Credits +14.3 Credits ============ `xorriso' is in part based on work by Vreixo Formoso who provides @@ -4132,7 +4150,7 @@ years.  File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top -14 Alphabetic Command List +15 Alphabetic Command List ************************** [index] @@ -4341,7 +4359,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top  File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top -15 Alphabetic List of Concepts and Objects +16 Alphabetic List of Concepts and Objects ****************************************** [index] @@ -4363,6 +4381,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top * Blank media, _definition: Media. (line 29) * Blind growing, _definition: Methods. (line 40) * Bootability, control, -boot_image: Bootable. (line 26) +* Bugs, reporting: Bugreport. (line 6) * cdrecord, Emulation: Emulation. (line 111) * Character Set, _definition: Charset. (line 6) * Character Set, for input, -in_charset: Loading. (line 92) @@ -4504,6 +4523,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top * Pattern expansion, for ISO paths, -iso_rr_pattern: Manip. (line 10) * Permissions, in ISO image, -chmod: Manip. (line 58) * Permissions, in ISO image, -chmod_r: Manip. (line 70) +* Problems, reporting: Bugreport. (line 6) * Process, consolidate text output, -pkt_output: Frontend. (line 7) * Process, control abort on error, -abort_on: Exception. (line 27) * Process, control exit value, -return_with: Exception. (line 39) @@ -4596,57 +4616,58 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top  Tag Table: Node: Top420 -Node: Overview1336 -Node: Model3225 -Node: Media6111 -Node: Methods8773 -Node: Drives11331 -Node: Extras14639 -Node: Processing18128 -Node: Dialog21628 -Node: Options23291 -Node: AqDrive24899 -Node: Loading27807 -Node: Insert42143 -Node: SetInsert51762 -Node: Manip60336 -Node: CmdFind69021 -Node: Filter80324 -Node: Writing84681 -Node: SetWrite90979 -Node: Bootable105025 -Node: Jigdo118345 -Node: Charset122609 -Node: Exception125368 -Node: DialogCtl131508 -Node: Inquiry134095 -Node: Navigate138478 -Node: Verify146418 -Node: Restore155013 -Node: Emulation161673 -Node: Scripting171546 -Node: Frontend177696 -Node: Examples178995 -Node: ExDevices180166 -Node: ExCreate180804 -Node: ExDialog182078 -Node: ExGrowing183340 -Node: ExModifying184142 -Node: ExBootable184643 -Node: ExCharset185192 -Node: ExPseudo186020 -Node: ExCdrecord186918 -Node: ExMkisofs187233 -Node: ExGrowisofs188571 -Node: ExException189706 -Node: ExTime190160 -Node: ExIncBackup190619 -Node: ExRestore194543 -Node: ExRecovery195512 -Node: Files196078 -Node: Seealso197376 -Node: Legal197960 -Node: CommandIdx198888 -Node: ConceptIdx213556 +Node: Overview1375 +Node: Model3264 +Node: Media6150 +Node: Methods8812 +Node: Drives11370 +Node: Extras14678 +Node: Processing18167 +Node: Dialog21667 +Node: Options23330 +Node: AqDrive24938 +Node: Loading27846 +Node: Insert42182 +Node: SetInsert51801 +Node: Manip60375 +Node: CmdFind69060 +Node: Filter80363 +Node: Writing84720 +Node: SetWrite91018 +Node: Bootable105064 +Node: Jigdo118384 +Node: Charset122648 +Node: Exception125407 +Node: DialogCtl131547 +Node: Inquiry134134 +Node: Navigate138517 +Node: Verify146457 +Node: Restore155052 +Node: Emulation161712 +Node: Scripting171585 +Node: Frontend177735 +Node: Examples179034 +Node: ExDevices180205 +Node: ExCreate180843 +Node: ExDialog182117 +Node: ExGrowing183379 +Node: ExModifying184181 +Node: ExBootable184682 +Node: ExCharset185231 +Node: ExPseudo186059 +Node: ExCdrecord186957 +Node: ExMkisofs187272 +Node: ExGrowisofs188610 +Node: ExException189745 +Node: ExTime190199 +Node: ExIncBackup190658 +Node: ExRestore194582 +Node: ExRecovery195551 +Node: Files196117 +Node: Seealso197415 +Node: Bugreport198003 +Node: Legal198604 +Node: CommandIdx199534 +Node: ConceptIdx214202  End Tag Table diff --git a/libisoburn/trunk/xorriso/xorrisofs.1 b/libisoburn/trunk/xorriso/xorrisofs.1 index 69614d28..ffa2deb2 100644 --- a/libisoburn/trunk/xorriso/xorrisofs.1 +++ b/libisoburn/trunk/xorriso/xorrisofs.1 @@ -36,7 +36,7 @@ produces Rock Ridge enhanced ISO 9660 filesystems and add\-on sessions to such filesystems. Optionally it can produce Joliet directory trees too. .br .PP -xorrisofs understands options of program mkisofs from cdrtools by +\fBxorrisofs\fR understands options of program mkisofs from cdrtools by Joerg Schilling. Its implementation is part of program xorriso which shares no source code with cdrtools. @@ -60,7 +60,8 @@ with ownership, access permissions, symbolic links, and other attributes. Rock Ridge allows filenames of up to 255 bytes and paths of up to 1024 bytes. .br -Rock Ridge information is produced unconditionally with any xorrisofs image. +Rock Ridge information is produced unconditionally with any \fBxorrisofs\fR +image. .br \fBJoliet\fR is the name of an additional directory tree which provides @@ -79,7 +80,7 @@ Production of this directory tree may be enabled by option \-iso\-level 4. .SS .B Inserting files into the ISO image: .PP -xorrisofs deals with two kinds of file addresses: +\fBxorrisofs\fR deals with two kinds of file addresses: .br \fBdisk_path\fR is a path to an object in the local filesystem tree. @@ -90,7 +91,7 @@ confuse with the lowlevel ISO 9660 names visible if Rock Ridge gets ignored.) .br .PP A program argument is handled as a \fBpathspec\fR, if it is not -recognized as original mkisofs option or additional xorrisofs option. +recognized as original mkisofs option or additional \fBxorrisofs\fR option. A pathspec depicts an input file object by a disk_path. 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 @@ -119,7 +120,7 @@ Non\-directories may not overwrite existing directories. .SS \fBRelation to program xorriso:\fR .br -xorrisofs is actually a command mode of program \fBxorriso\fR, +\fBxorrisofs\fR is actually a command mode of program \fBxorriso\fR, which gets entered either by xorriso command "\-as mkisofs" or by starting the program by one of the names "xorrisofs", "mkisofs", "genisoimage", or "genisofs". @@ -136,7 +137,7 @@ The program messages call any image file a "drive". File types which are not supported for reading are reported as "blank". The reported free media space may be quite fictional. .br -Nevertheless xorrisofs does not operate directly on optical drives, +Nevertheless \fBxorrisofs\fR does not operate directly on optical drives, but rather forces libburn to regard them as general device files. So for writing of sequential optical media (CD, DVD\-R, DVD+R, BD\-R) one will have to use a burn program. E.g the cdrecord emulation of xorriso. @@ -472,8 +473,8 @@ Alias of \-N. .TP \fB\-R\fR .br -With mkisofs this option enables Rock Ridge extensions. xorrisofs produces -them unconditionally. +With mkisofs this option enables Rock Ridge extensions. \fBxorrisofs\fR +produces them unconditionally. .TP \fB\-rock\fR .br @@ -676,7 +677,7 @@ The precondition for a bootable ISO image is to have in the ISO image the files of a boot loader. The boot facilities of computers get directed to such files, which usually execute further program files from the ISO image. -xorrisofs can produce several kinds of boot block or boot record, +\fBxorrisofs\fR can produce several kinds of boot block or boot record, which become part of the ISO image, and get interpreted by the according boot facility. .br @@ -695,7 +696,7 @@ El Torito gets interpreted by boot facilities PC\-BIOS and EFI. Most bootable GNU/Linux CDs are equipped with ISOLINUX or GRUB boot images for PC\-BIOS. .br -xorrisofs supports the example options out of the ISOLINUX wiki, +\fBxorrisofs\fR supports the example options out of the ISOLINUX wiki, the options used in GRUB script grub\-mkrescue, and the example in the FreeBSD AvgLiveCD wiki. .br @@ -781,7 +782,7 @@ a MBR for booting via PC\-BIOS from USB stick or hard disk. A \fBMBR\fR (Master Boot Record) contains boot code and a partition table. It does not hamper El Torito booting from CDROM. .br -xorrisofs supports boot facilities other than PC\-BIOS: +\fBxorrisofs\fR supports boot facilities other than PC\-BIOS: MIPS Big Endian (SGI), MIPS Little Endian (DEC), SUN SPARC. Those are mutually not combinable and also not combinable with MBR. .br @@ -942,7 +943,7 @@ and DVD ISO images are published on the web in jigdo format to allow end users to download them more efficiently." .br If the use of libjte was enabled at compile time of xorriso, then -xorrisofs can produce a .jigdo and a .template file together with a +\fBxorrisofs\fR can produce a .jigdo and a .template file together with a single\-session ISO image. If not, then Jigdo options will cause a FAILURE event, which normally leads to program abort. .br @@ -955,7 +956,8 @@ The .jigdo file contains checksums and symbolic file addresses. The .template file contains the compressed ISO image with reference tags instead of the content bytes of the listed files. .br -Input for this process are the normal arguments for a xorrisofs session +Input for this process are the normal arguments for a \fBxorrisofs\fR +session with no image loaded, and a .md5 file which lists those data files which may be listed in the .jigdo file and externally referenced in the .template file. Each designated file is represented in the .md5 file by a single text line: @@ -1362,7 +1364,7 @@ to copy all desired files underneath that directory. Especially file isolinux.bin shall be copied to ./CD_root/isolinux/isolinux.bin . This is the boot image file. .br -The prescribed mkisofs options can be used unchanged with xorrisofs: +The prescribed mkisofs options can be used unchanged with \fBxorrisofs\fR: .br $ xorrisofs \-o output.iso \\ .br @@ -1422,7 +1424,7 @@ Now copy the image onto it .SS .B Startup files: .br -If not \-\-no_rc is given as the first argument then xorrisofs +If not \-\-no_rc is given as the first argument then \fBxorrisofs\fR attempts on startup to read and execute lines from the following files: .br /etc/default/xorriso @@ -1434,8 +1436,8 @@ attempts on startup to read and execute lines from the following files: $HOME/.xorrisorc .br The files are read in the sequence given here, but none of them is required -to exist. The lines are not interpreted as xorrisofs options but as generic -xorriso commands. See man xorriso. +to exist. The lines are not interpreted as \fBxorrisofs\fR options but +as generic xorriso commands. See man xorriso. .PP After the xorriso startup files, the program tries one by one to open for reading: @@ -1492,6 +1494,18 @@ ACL and xattr .TP MD5 checksums .BR md5sum(1) +.SH BUGS +To report bugs or to suggest enhancements for \fBxorriso\fR, please +send electronic mail to the public lists +or . If more privacy is desired, mail +to . +.br +Please describe what you expect \fBxorriso\fR to do, +the program arguments resp. commands by which you tried to achieve it, +the messages of \fBxorriso\fR, and the undesirable outcome of your +program run. +.br +Expect to get asked more questions before solutions can be proposed. .SH AUTHOR Thomas Schmitt .br @@ -1504,7 +1518,7 @@ modified in sync with the technical properties of xorriso. If you make use of the license to derive modified versions of xorriso then you are entitled to modify this text under that same license. .SH CREDITS -xorrisofs is in part based on work by Vreixo Formoso who provides libisofs -together with Mario Danic who also leads the libburnia team. +\fBxorrisofs\fR is in part based on work by Vreixo Formoso who provides +libisofs together with Mario Danic who also leads the libburnia team. .br Compliments towards Joerg Schilling whose cdrtools served me for ten years. diff --git a/libisoburn/trunk/xorriso/xorrisofs.info b/libisoburn/trunk/xorriso/xorrisofs.info index f6bcb4f8..73ea1b1e 100644 --- a/libisoburn/trunk/xorriso/xorrisofs.info +++ b/libisoburn/trunk/xorriso/xorrisofs.info @@ -29,6 +29,7 @@ xorrisofs - Emulation of ISO 9660 program mkisofs by program xorriso * Examples:: Examples * Files:: Files * Seealso:: See also +* Bugreport:: Reporting bugs * Legal:: Author, Copyright, Credits * CommandIdx:: Alphabetic Command List * ConceptIdx:: Alphabetic List of Concepts and Objects @@ -39,13 +40,13 @@ File: xorrisofs.info, Node: Overview, Next: Standards, Prev: Top, Up: Top 1 Overview ********** -*xorrisofs* produces Rock Ridge enhanced ISO 9660 filesystems and +`xorrisofs' produces Rock Ridge enhanced ISO 9660 filesystems and add-on sessions to such filesystems. Optionally it can produce Joliet directory trees too. -xorrisofs understands options of program mkisofs from cdrtools by Joerg -Schilling. Its implementation is part of program xorriso which shares -no source code with cdrtools. +`xorrisofs' understands options of program mkisofs from cdrtools by +Joerg Schilling. Its implementation is part of program xorriso which +shares no source code with cdrtools.  File: xorrisofs.info, Node: Standards, Next: Insert, Prev: Overview, Up: Top @@ -66,7 +67,7 @@ enhance an ISO 9660 filesystem so that it can represent a POSIX compliant filesystem with ownership, access permissions, symbolic links, and other attributes. Rock Ridge allows filenames of up to 255 bytes and paths of up to 1024 bytes. -Rock Ridge information is produced unconditionally with any xorrisofs +Rock Ridge information is produced unconditionally with any `xorrisofs' image. *Joliet* is the name of an additional directory tree which provides filenames up to 64 characters encoded as UTF-16. A Joliet tree is @@ -86,18 +87,18 @@ File: xorrisofs.info, Node: Insert, Next: Xorriso, Prev: Standards, Up: Top 3 Inserting files into the ISO image ************************************ -xorrisofs deals with two kinds of file addresses: +`xorrisofs' deals with two kinds of file addresses: *disk_path* is a path to an object in the local filesystem tree. *iso_rr_path* is the Rock Ridge address of a file object in the ISO image. (Do not confuse with the lowlevel ISO 9660 names visible if Rock 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 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. +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 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*, i.e. the iso_rr_path for the file object in the ISO image. @@ -122,7 +123,7 @@ File: xorrisofs.info, Node: Xorriso, Next: Options, Prev: Insert, Up: Top 4 Relation to program xorriso ***************************** -xorrisofs is actually a command mode of program *xorriso*, which gets +`xorrisofs' is actually a command mode of program *xorriso*, which gets entered either by xorriso command "-as mkisofs" or by starting the program by one of the names "xorrisofs", "mkisofs", "genisoimage", or "genisofs". @@ -135,11 +136,11 @@ types except directories. The program messages call any image file a "drive". File types which are not supported for reading are reported as "blank". The reported free media space may be quite fictional. -Nevertheless xorrisofs does not operate directly on optical drives, but -rather forces libburn to regard them as general device files. So for -writing of sequential optical media (CD, DVD-R, DVD+R, BD-R) one will -have to use a burn program. E.g the cdrecord emulation of xorriso. See -EXAMPLES. +Nevertheless `xorrisofs' does not operate directly on optical drives, +but rather forces libburn to regard them as general device files. So +for writing of sequential optical media (CD, DVD-R, DVD+R, BD-R) one +will have to use a burn program. E.g the cdrecord emulation of xorriso. +See EXAMPLES.  File: xorrisofs.info, Node: Options, Next: Examples, Prev: Xorriso, Up: Top @@ -490,7 +491,7 @@ File: xorrisofs.info, Node: SetExtras, Next: SetHide, Prev: SetCompl, Up: Op -R - With mkisofs this option enables Rock Ridge extensions. xorrisofs + With mkisofs this option enables Rock Ridge extensions. `xorrisofs' produces them unconditionally. -rock @@ -686,9 +687,9 @@ File: xorrisofs.info, Node: Bootable, Next: SystemArea, Prev: ImageId, Up: O The precondition for a bootable ISO image is to have in the ISO image the files of a boot loader. The boot facilities of computers get directed to such files, which usually execute further program files -from the ISO image. xorrisofs can produce several kinds of boot block -or boot record, which become part of the ISO image, and get interpreted -by the according boot facility. +from the ISO image. `xorrisofs' can produce several kinds of boot +block or boot record, which become part of the ISO image, and get +interpreted by the according boot facility. An *El Torito* boot record points the bootstrapping facility to a boot catalog with one or more boot images, which are binary program files @@ -700,7 +701,7 @@ given and structured by options -b, -e, -el-torito-alt-boot, and El Torito gets interpreted by boot facilities PC-BIOS and EFI. Most bootable GNU/Linux CDs are equipped with ISOLINUX or GRUB boot images for PC-BIOS. -xorrisofs supports the example options out of the ISOLINUX wiki, the +`xorrisofs' supports the example options out of the ISOLINUX wiki, the options used in GRUB script grub-mkrescue, and the example in the FreeBSD AvgLiveCD wiki. @@ -787,9 +788,9 @@ facilities of exotic hardware architectures or it may be a MBR for booting via PC-BIOS from USB stick or hard disk. A *MBR* (Master Boot Record) contains boot code and a partition table. It does not hamper El Torito booting from CDROM. -xorrisofs supports boot facilities other than PC-BIOS: MIPS Big Endian -(SGI), MIPS Little Endian (DEC), SUN SPARC. Those are mutually not -combinable and also not combinable with MBR. +`xorrisofs' supports boot facilities other than PC-BIOS: MIPS Big +Endian (SGI), MIPS Little Endian (DEC), SUN SPARC. Those are mutually +not combinable and also not combinable with MBR. -G disk_path Copy at most 32768 bytes from the given disk file to the very @@ -944,7 +945,7 @@ large files like CD and DVD images; see http://atterer.net/jigdo/ for more details. Debian CDs and DVD ISO images are published on the web in jigdo format to allow end users to download them more efficiently." If the use of libjte was enabled at compile time of xorriso, then -xorrisofs can produce a .jigdo and a .template file together with a +`xorrisofs' can produce a .jigdo and a .template file together with a single-session ISO image. If not, then Jigdo options will cause a FAILURE event, which normally leads to program abort. One may determine the ability for Jigdo by: @@ -954,11 +955,11 @@ $ xorrisofs -version 2>&1 | grep '^libjte' && echo YES The .jigdo file contains checksums and symbolic file addresses. The .template file contains the compressed ISO image with reference tags instead of the content bytes of the listed files. -Input for this process are the normal arguments for a xorrisofs session -with no image loaded, and a .md5 file which lists those data files -which may be listed in the .jigdo file and externally referenced in the -.template file. Each designated file is represented in the .md5 file -by a single text line: +Input for this process are the normal arguments for a `xorrisofs' +session with no image loaded, and a .md5 file which lists those data +files which may be listed in the .jigdo file and externally referenced +in the .template file. Each designated file is represented in the .md5 +file by a single text line: MD5 as 32 hex digits, 2 blanks, size as 12 decimal digits or blanks, 2 blanks, symbolic file address The file address in an .md5 line has to bear the same basename as the @@ -1329,7 +1330,7 @@ The ISOLINUX wiki prescribes to create on disk a directory ./CD_root and to copy all desired files underneath that directory. Especially file isolinux.bin shall be copied to ./CD_root/isolinux/isolinux.bin . This is the boot image file. -The prescribed mkisofs options can be used unchanged with xorrisofs: +The prescribed mkisofs options can be used unchanged with `xorrisofs': $ xorrisofs -o output.iso \ -b isolinux/isolinux.bin -c isolinux/boot.cat \ @@ -1382,8 +1383,8 @@ File: xorrisofs.info, Node: Files, Next: Seealso, Prev: Examples, Up: Top 7.1 Startup Files ================= -If not -no_rc is given as the first argument then xorrisofs attempts on -startup to read and execute lines from the following files: +If not -no_rc is given as the first argument then `xorrisofs' attempts +on startup to read and execute lines from the following files: /etc/default/xorriso /etc/opt/xorriso/rc @@ -1391,7 +1392,7 @@ startup to read and execute lines from the following files: $HOME/.xorrisorc The files are read in the sequence given here, but none of them is -required to exist. The lines are not interpreted as xorrisofs options +required to exist. The lines are not interpreted as `xorrisofs' options but as generic xorriso commands. See man xorriso. After the xorriso startup files, the program tries one by one to open for reading: @@ -1413,7 +1414,7 @@ VOLS default for -volset Any other lines will be silently ignored.  -File: xorrisofs.info, Node: Seealso, Next: Legal, Prev: Files, Up: Top +File: xorrisofs.info, Node: Seealso, Next: Bugreport, Prev: Files, Up: Top 8 See also ********** @@ -1437,19 +1438,36 @@ MD5 checksums md5sum(1)  -File: xorrisofs.info, Node: Legal, Next: CommandIdx, Prev: Seealso, Up: Top +File: xorrisofs.info, Node: Bugreport, Next: Legal, Prev: Seealso, Up: Top -9 Author, Copyright, Credits -**************************** +9 Reporting bugs +**************** -9.1 Author -========== +To report bugs or to suggest enhancements for `xorriso', please send +electronic mail to the public lists or +. If more privacy is desired, mail to +. + +Please describe what you expect `xorriso' to do, the program arguments +resp. commands by which you tried to achieve it, the messages of +`xorriso', and the undesirable outcome of your program run. + +Expect to get asked more questions before solutions can be proposed. + + +File: xorrisofs.info, Node: Legal, Next: CommandIdx, Prev: Bugreport, Up: Top + +10 Author, Copyright, Credits +***************************** + +10.1 Author +=========== Thomas Schmitt for libburnia-project.org -9.2 Copyright -============= +10.2 Copyright +============== Copyright (c) 2011 Thomas Schmitt Permission is granted to distribute this text freely. It shall only be @@ -1457,10 +1475,10 @@ modified in sync with the technical properties of xorriso. If you make use of the license to derive modified versions of xorriso then you are entitled to modify this text under that same license. -9.3 Credits -=========== +10.3 Credits +============ -xorrisofs is in part based on work by Vreixo Formoso who provides +`xorrisofs' is in part based on work by Vreixo Formoso who provides libisofs together with Mario Danic who also leads the libburnia team. Compliments towards Joerg Schilling whose cdrtools served me for ten years. @@ -1468,7 +1486,7 @@ years.  File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top -10 Alphabetic Command List +11 Alphabetic Command List ************************** [index] @@ -1633,7 +1651,7 @@ File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T  File: xorrisofs.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top -11 Alphabetic List of Concepts and Objects +12 Alphabetic List of Concepts and Objects ****************************************** [index] @@ -1671,6 +1689,7 @@ File: xorrisofs.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top * Bootability, patch System Area partition table, --protective-msdos-label: SystemArea. (line 41) * Bootability, SUN Disk Label text, -sparc-label: SystemArea. (line 132) +* Bugs, reporting: Bugreport. (line 6) * Character Set, for disk file names, -input-charset: Charset. (line 17) * Character Set, for ISO file names, -output-charset: Charset. @@ -1754,6 +1773,7 @@ File: xorrisofs.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top * Permissions, for all data files, -file-mode: SetProduct. (line 66) * Permissions, for all directories, -dir-mode: SetProduct. (line 60) * Preparer Id, set, -p: ImageId. (line 54) +* Problems, reporting: Bugreport. (line 6) * Program version, report, -version: Miscellaneous. (line 34) * Publisher Id, set, -p, -publisher: ImageId. (line 30) * Rock Ridge, (always enabled), -R, -rock: SetExtras. (line 8) @@ -1782,35 +1802,36 @@ File: xorrisofs.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top  Tag Table: Node: Top397 -Node: Overview1064 -Node: Standards1500 -Node: Insert3175 -Node: Xorriso4943 -Node: Options6079 -Node: Loading6796 -Node: SetInsert9090 -Node: SetProduct13492 -Node: SetCompl17199 -Node: SetExtras19518 -Node: SetHide22390 -Node: ImageId23398 -Node: Bootable26902 -Node: SystemArea30982 -Node: Charset37342 -Node: Jigdo38367 -Node: Miscellaneous42648 -Node: Examples43821 -Node: ExSimple44307 -Node: ExGraft44786 -Node: ExMkisofs46033 -Node: ExGrowisofs47284 -Node: ExIncBackup48456 -Node: ExIncBckAcc51505 -Node: ExBootable53180 -Node: Files55279 -Node: Seealso56349 -Node: Legal56864 -Node: CommandIdx57660 -Node: ConceptIdx68993 +Node: Overview1103 +Node: Standards1541 +Node: Insert3218 +Node: Xorriso4990 +Node: Options6129 +Node: Loading6846 +Node: SetInsert9140 +Node: SetProduct13542 +Node: SetCompl17249 +Node: SetExtras19568 +Node: SetHide22442 +Node: ImageId23450 +Node: Bootable26954 +Node: SystemArea31038 +Node: Charset37400 +Node: Jigdo38425 +Node: Miscellaneous42710 +Node: Examples43883 +Node: ExSimple44369 +Node: ExGraft44848 +Node: ExMkisofs46095 +Node: ExGrowisofs47346 +Node: ExIncBackup48518 +Node: ExIncBckAcc51567 +Node: ExBootable53242 +Node: Files55343 +Node: Seealso56417 +Node: Bugreport56936 +Node: Legal57537 +Node: CommandIdx58345 +Node: ConceptIdx69678  End Tag Table