2006-03-14 Erik Sandberg <mandolaerik@gmail.com>

	* Documentaiton/user/invoking.itely: Add ragged-right to bug report
	guidelines.

diff --git a/ChangeLog b/ChangeLog
index a2e0a39f65f3471e7663ca87aa6047a31b8fd684..a29ecd407f9559e31e4177fe9dbc10ea874aee76 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2006-03-14 Erik Sandberg  <mandolaerik@gmail.com>
+
+       * Documentaiton/user/invoking.itely: Add ragged-right to bug report
+       guidelines.
+
 2006-03-14  Graham Percival  <gpermus@gmail.com>
 
        * Documentaiton/user/global.itely: small fix from mailist.

diff --git a/Documentation/user/invoking.itely b/Documentation/user/invoking.itely
index e4b4c95c056ef3a7f1b6139e0741a47c9973349d..cef12f28cd178d80f487962632ecbf26961f27cb 100644 (file)
--- a/Documentation/user/invoking.itely
+++ b/Documentation/user/invoking.itely
@@ -554,14 +554,25 @@ here for reference.
 If you have input that results in a crash or an erroneous output, then
 that is a bug.  We try to respond to bug-reports promptly, and fix them as
 soon as possible.  Help us by sending a defective input file, so we can
-reproduce the problem.  Make it small, so we can easily debug the
-problem.  Don't forget to tell which version of LilyPond you use!  Send
-the report via
+reproduce the problem. Send the report via:
 
 @example
 @uref{http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.bugs}
 @end example
 
+A few tips:
+@itemize @bullet
+
+@item Try to produce a very small input file which demonstrates the problem;
+one or two bars is often sufficient to reproduce a bug. The smaller the
+input file is, the easier it is for us to debug the problem.
+
+@item Don't forget to tell which version of LilyPond you use!
+
+@item If possible, use @code{ragged-right} in your example. This makes sure
+that the bug can be reproduced in all paper sizes.
+@end itemize
+
 @ignore
 @c the bug database is not up to date enough. 
 
@@ -574,20 +585,22 @@ been reported and a fix or workaround is already known.
 
 Here is an example of a good bug report:
 
-@example
+@verbatim
 It seems that placement of accidentals is broken.  In the
 following example, the accidental touches the note head.
 
 Using Mac OSX 10.3.7, fink package lilypond-devel
 
 \version "2.7.32"
-\relative c''@{
+\layout { ragged-right = ##t }
+\relative c'' {
    a4 b cis d
-@}
-@end example
+}
+@end verbatim
 
 @lilypond[quote]
 \version "2.7.32"
+\layout { ragged-right = ##t }
 \relative c''{
   \override Accidental #'extra-offset = #'(1.0 . 0)
   a4 b cis d

diff --git a/THANKS b/THANKS
index 2e20df43f9000353f17a5ef160e557780160d91d..d123d4f0fe3ae13e9628aa6a73ff34b9414c2916 100644 (file)
--- a/THANKS
+++ b/THANKS
@@ -62,6 +62,7 @@ Christian Ebert
 Christian Hitz
 Darius Blasband
 David Bobroff
+David Raleigh Arnold
 Donald Axel
 Don Blaheta
 Dunstan Vavasour