gimp-web r1849 - in branches/v2.6: . release-notes

[martinn svn gnome org]

Author: martinn
Date: Tue Sep 23 20:07:58 2008
New Revision: 1849
URL: http://svn.gnome.org/viewvc/gimp-web?rev=1849&view=rev

Log:
* release-notes/gimp-2.6.htrw
(Miscellaneous/Backwards Compatibility): Replaced with a much
better text by Kevin Cozens containing for example sample code.


Modified:
   branches/v2.6/ChangeLog
   branches/v2.6/release-notes/gimp-2.6.htrw

Modified: branches/v2.6/release-notes/gimp-2.6.htrw
==============================================================================
--- branches/v2.6/release-notes/gimp-2.6.htrw	(original)
+++ branches/v2.6/release-notes/gimp-2.6.htrw	Tue Sep 23 20:07:58 2008
@@ -179,12 +179,40 @@
 
 <h3>Backwards Compatibility</h3>
 <p>
-  There have been changes to Script-Fu that breaks scripts using
-  invalid let-syntax. The reason for the change is to prevent a crash
-  of Script-Fu. Please refer
-  to <a href="http://bugzilla.gnome.org/show_bug.cgi?id=512105";>Bug
-  512105 â recent Script-Fu changes break lots of scripts</a>.
+  Script-Fu has undergone some clean up and includes several bug
+  fixes. One important bug fix,
+  for <a href="http://bugzilla.gnome.org/show_bug.cgi?id=512105";>bug&nbsp;#508020</a>,
+  prevents a possible crash of Script-Fu. A side effect of the fix
+  will break any script which does not provide an initial value for a
+  variable in the binding portion of a <i>let</i>, <i>let*</i>,
+  or <i>letrec</i> block.
 </p>
+<p>
+  An initial value for a variable is required as stated in
+  the <a href="http://www.schemers.org/Documents/Standards/R5RS/r5rs.pdf";>R5RS&nbsp;Scheme&nbsp;standard&nbsp;document</a>. The
+  initial value can be provided as a simple constant, or as the result
+  of a function call. The following examples will illustrate the
+  problem and show a simple change that will fix a broken script.
+</p>
+<p>
+  This example shows a <i>let*</i> block with incorrect syntax that
+  will no longer work in Script-Fu.
+</p>
+<pre class="code">
+(let* (
+      (four (+ 2 2))
+      (this-is-wrong)
+      )
+</pre>
+<p>
+  This example shows a <i>let*</i> block with the correct syntax.
+</P>
+<pre class="code">
+(let* (
+      (four (+ 2 2))
+      (this-is-correct 0)
+      )
+</pre>
 
 <h3>Building</h3>
 <p>