Updated generated manuals

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 <bug\-xorriso@gnu.org>
+or <libburn\-hackers@pykix.org>. If more privacy is desired, mail
+to <scdbackup@gmx.net>.
+.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 <scdbackup@gmx.net>
 .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.