From 2492debddc45c2cf513f5fc0de0a196eec905523 Mon Sep 17 00:00:00 2001 From: Thomas Schmitt Date: Tue, 17 May 2011 09:28:05 +0000 Subject: [PATCH] Added to the manual instructions for bug reporting --- xorriso/xorriso.texi | 26 +++++++++++++++++++++++--- xorriso/xorrisofs.texi | 27 ++++++++++++++++++++++++--- 2 files changed, 47 insertions(+), 6 deletions(-) diff --git a/xorriso/xorriso.texi b/xorriso/xorriso.texi index 1fa9dd68..f14ee109 100644 --- a/xorriso/xorriso.texi +++ b/xorriso/xorriso.texi @@ -23,11 +23,12 @@ @c "@c man-ignore-lines begin" discards all following lines @c up to "@c man-ignore-lines end". @c Line blocks of "@menu" "@end menu" will be discarded. -@c "@item -word words" becomes "\fB\-word\fR words". @c "@item word words" becomes "\fBword\fR words". @c @strong{-...} gets mapped to \fB\-...\fR . @c @strong{...} gets mapped to \fB...\fR . @c @command{...} gets mapped to \fB...\fR . +@c @email{...} gets mapped to <...> . +@c Mapped {...} content is subject to the rules except {...} mapping. @c @minus{} will become "-". @c @@ , @{, @} will get stripped of their first @. @c Other lines which begin by "@" will be discarded. @@ -103,6 +104,7 @@ 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 @@ -5521,7 +5523,7 @@ The default setting of -check_media abort_file= is: @c man MD5 checksums @c man .BR md5sum(1) @c man-ignore-lines begin -@node Seealso, Legal, Files, Top +@node Seealso, Bugreport, Files, Top @chapter See also @table @asis @item For the mkisofs emulation of @command{xorriso} @@ -5547,8 +5549,26 @@ setfattr(1) md5sum(1) @end table @c man-ignore-lines end +@c man .SH BUGS +@node Bugreport, Legal, Seealso, Top +@chapter Reporting bugs +@cindex Bugs, reporting +@cindex Problems, reporting +To report bugs or to suggest enhancements for @command{xorriso}, please +send electronic mail to the public lists @email{bug-xorriso@@gnu.org} +or @email{libburn-hackers@@pykix.org}. If more privacy is desired, mail +to @email{scdbackup@@gmx.net}. +@* +@sp 1 +Please describe what you expect @command{xorriso} to do, +the program arguments resp. commands by which you tried to achieve it, +the messages of @command{xorriso}, and the undesirable outcome of your +program run. +@* +@sp 1 +Expect to get asked more questions before solutions can be proposed. @c man .SH AUTHOR -@node Legal, CommandIdx, Seealso, Top +@node Legal, CommandIdx, Bugreport, Top @chapter Author, Copyright, Credits @section Author Thomas Schmitt diff --git a/xorriso/xorrisofs.texi b/xorriso/xorrisofs.texi index e741fee7..4d48b155 100644 --- a/xorriso/xorrisofs.texi +++ b/xorriso/xorrisofs.texi @@ -25,8 +25,10 @@ @c Line blocks of "@menu" "@end menu" will be discarded. @c "@item -word words" becomes "\fB\-word\fR words". @c "@item word words" becomes "\fBword\fR words". -@c @strong{-...} gets mapped to \fB\-...\fR . @c @strong{...} gets mapped to \fB...\fR . +@c @command{...} gets mapped to \fB...\fR . +@c @email{...} gets mapped to <...> . +@c Mapped {...} content is subject to the rules except {...} mapping. @c @minus{} will become "-". @c @@ , @{, @} will get stripped of their first @. @c Other lines which begin by "@" will be discarded. @@ -96,6 +98,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 @@ -1991,7 +1994,7 @@ Any other lines will be silently ignored. @c man MD5 checksums @c man .BR md5sum(1) @c man-ignore-lines begin -@node Seealso, Legal, Files, Top +@node Seealso, Bugreport, Files, Top @chapter See also @table @asis @item For generic xorriso command mode @@ -2016,8 +2019,26 @@ setfattr(1) md5sum(1) @end table @c man-ignore-lines end +@c man .SH BUGS +@node Bugreport, Legal, Seealso, Top +@chapter Reporting bugs +@cindex Bugs, reporting +@cindex Problems, reporting +To report bugs or to suggest enhancements for @command{xorriso}, please +send electronic mail to the public lists @email{bug-xorriso@@gnu.org} +or @email{libburn-hackers@@pykix.org}. If more privacy is desired, mail +to @email{scdbackup@@gmx.net}. +@* +@sp 1 +Please describe what you expect @command{xorriso} to do, +the program arguments resp. commands by which you tried to achieve it, +the messages of @command{xorriso}, and the undesirable outcome of your +program run. +@* +@sp 1 +Expect to get asked more questions before solutions can be proposed. @c man .SH AUTHOR -@node Legal, CommandIdx, Seealso, Top +@node Legal, CommandIdx, Bugreport, Top @chapter Author, Copyright, Credits @section Author Thomas Schmitt