symfony · webmozart · Oct 2, 2013 · Oct 2, 2013 · Oct 2, 2013 · Oct 2, 2013
diff --git a/UPGRADE-2.4.md b/UPGRADE-2.4.md
@@ -7,3 +7,128 @@ Form
  * The constructor parameter `$precision` in `IntegerToLocalizedStringTransformer`
    is now ignored completely, because a precision does not make sense for
    integers.
+
+Intl
+----
+
+ * A new method `getLocaleAliases()` was added to `LocaleBundleInterface`. If
+   any of your classes implements this interface, you should add an implementation
+   of this method.
+
+ * The methods in the various resource bundles of the `Intl` class used to
+   return `null` when invalid arguments were given. These methods throw a
+   `MissingResourceException` now.
+
+   Before:
+
+   ```
+   use Symfony\Component\Intl\Intl;
+
+   // invalid language code
+   $language = Intl::getLanguageBundle()->getLanguageName('foo', null, 'en');
+
+   // invalid locale
+   $language = Intl::getLanguageBundle()->getLanguageName('de', null, 'foo');
+
+   if (null === $language) {
+       // error handling...
+   }
+   ```
+
+   After:
+
+   ```
+   use Symfony\Component\Intl\Intl;
+   use Symfony\Component\Intl\Exception\MissingResourceException;
+   use Symfony\Component\Intl\Exception\NoSuchLocaleException;
+
+   try {
+       // invalid language code
+       $language = Intl::getLanguageBundle()->getLanguageName('foo', null, 'en');
+
+       // invalid locale
+       $language = Intl::getLanguageBundle()->getLanguageName('de', null, 'foo');
+   } catch (MissingResourceException $e) {
+       if ($e->getPrevious() instanceof NoSuchLocaleException) {
+           // locale was invalid...
+       } else {
+           // locale was valid, but entry not found...
+       }
+   }
+   ```
+
+ * The `$fallback` argument of the protected method `AbstractBundle::readEntry()`
+   was changed to be `true` by default. This way the signature is consistent
+   with the proxied `BundleEntryReaderInterface::readEntry()` method.
+   Consequently, if an entry cannot be found for the accessed locale (e.g. "en_GB"),
+   it is looked for in the fallback locale (if any, e.g. "en").
+
+   If you extend this class and explicitly want to disable locale fallback, you
+   should pass `false` as last argument.
+
+   Before:
+
+   ```
+   use Symfony\Component\Intl\ResourceBundle\AbstractBundle;
+
+   class MyBundle extends AbstractBundle
+   {
+       public function getEntry($key, $locale)
+       {
+           return $this->readEntry($locale, array('Entries', $key));
+       }
+   }
+   ```
+
+   After:
+
+   ```
+   use Symfony\Component\Intl\ResourceBundle\AbstractBundle;
+
+   class MyBundle extends AbstractBundle
+   {
+       public function getEntry($key, $locale)
+       {
+           // disable locale fallback!
+           return $this->readEntry($locale, array('Entries', $key), false);
+       }
+   }
+   ```
+
+ * The interfaces `CompilationContextInterface` and `StubbingContextInterface`
+   were removed. Code against their implementations `CompilationContext` and
+   `StubbingContext` in the same namespace instead.
+
+   Before:
+
+   ```
+   use Symfony\Component\Intl\ResourceBundle\Transformation\CompilationContextInterface;
+   use Symfony\Component\Intl\ResourceBundle\Transformation\StubbingContextInterface;
+
+   public function beforeCompile(CompilationContextInterface $context)
+   {
+       // ...
+   }
+
+   public function beforeCreateStub(StubbingContextInterface $context)
+   {
+       // ...
+   }
+   ```
+
+   After:
+
+   ```
+   use Symfony\Component\Intl\ResourceBundle\Transformation\CompilationContext;
+   use Symfony\Component\Intl\ResourceBundle\Transformation\StubbingContext;
+
+   public function beforeCompile(CompilationContext $context)
+   {
+       // ...
+   }
+
+   public function beforeCreateStub(StubbingContext $context)
+   {
+       // ...
+   }
+   ```
diff --git a/UPGRADE-3.0.md b/UPGRADE-3.0.md
@@ -257,6 +257,70 @@ UPGRADE FROM 2.x to 3.0
  * The `Symfony\Component\HttpKernel\EventListener\ExceptionListener` now
    passes the Request format as the `_format` argument instead of `format`.
 
+### Intl
+
+ * The class `BundleCompiler` was renamed to `GenrbBundleCompiler`.
+
+   Before:
+
+   ```
+   use Symfony\Component\Intl\ResourceBundle\Compiler\BundleCompiler;
+
+   $genrb = '/path/to/icu/build/bin/genrb';
+   $genrbEnv = 'LD_LIBRARY_PATH=/path/to/icu/build/lib'
+   $compiler = new BundleCompiler($genrb, $genrbEnv);
+   ```
+
+   After:
+
+   ```
+   use Symfony\Component\Intl\ResourceBundle\Compiler\GenrbBundleCompiler;
+
+   $genrb = '/path/to/icu/build/bin/genrb';
+   $genrbEnv = 'LD_LIBRARY_PATH=/path/to/icu/build/lib'
+   $compiler = new GenrbBundleCompiler($genrb, $genrbEnv);
+   ```
+
+ * The class `StructuredBundleReader` was renamed to `BundleEntryReader`. The
+   corresponding interface `StructuredBundleReaderInterface` was renamed to
+   `BundleEntryReaderInterface`.
+
+   Before:
+
+   ```
+   class MyEntryReader extends StructuredBundleReader
+   {
+       // ...
+   }
+   ```
+
+   After:
+
+   ```
+   class MyEntryReader extends BundleEntryReader
+   {
+       // ...
+   }
+   ```
+
+   Before:
+
+   ```
+   public function __construct(StructuredBundleReaderInterface $entryReader)
+   {
+       // ...
+   }
+   ```
+
+   After:
+
+   ```
+   public function __construct(BundleEntryReaderInterface $entryReader)
+   {
+       // ...
+   }
+   ```
+
 ### Locale
 
  * The Locale component was removed and replaced by the Intl component.

diff --git a/src/Symfony/Component/Intl/CHANGELOG.md b/src/Symfony/Component/Intl/CHANGELOG.md
@@ -0,0 +1,26 @@
+CHANGELOG
+=========
+
+2.4.0
+-----
+
+ * [BC BREAK] the various Intl methods now throw a `MissingResourceException`
+   whenever a non-existing locale, language, currency, etc. is accessed
+ * the available locales of each resource bundle are now stored in a generic
+   "misc.res" file in order to improve reading performance
+ * improved `LocaleBundleTransformationRule` to not generate duplicate locale
+   names when fallback (e.g. "en_GB"->"en") is possible anyway. This reduced
+   the Resources/ directory file size of the Icu 1.2.x branch from 14M to 12M at
+   the time of this writing
+ * [BC BREAK] a new method `getLocaleAliases()` was added to `LocaleBundleInterface`
+ * deprecated `StructuredBundleReader` and `StructuredBundleReaderInterface` in
+   favor of `BundleEntryReader` and `BundleEntryReaderInterface`
+ * `BundleEntryReader` now follows aliases when looking for fallback locales
+ * [BC BREAK] changed default value of the argument `$fallback` in the protected
+   method `AbstractBundle::readEntry()` to `true` in order to be consistent with
+   the proxied `BundleEntryReaderInterface::readEntry()` method
+ * deprecated `BundleCompiler` in favor of `GenrbBundleCompiler`
+ * fixed `TextBundleWriter` to correctly escape keys that contain colons (":")
+ * fixed `TextBundleWriter` to correctly escape keys that contain spaces (" ")
+ * [BC BREAK] removed the pointless interfaces `CompilationContextInterface`
+   and `StubbingContextInterface`. You can depend on their implementation instead