소스 검색

updated readme and added upgrade guide

gedi 13 년 전
부모
커밋
ab2fe669ee
2개의 변경된 파일26개의 추가작업 그리고 2개의 파일을 삭제
  1. 18 2
      README.md
  2. 8 0
      upgrade/2-3-0.md

+ 18 - 2
README.md

@@ -4,11 +4,27 @@
 
 [![Build Status](https://secure.travis-ci.org/l3pp4rd/DoctrineExtensions.png?branch=master)](http://travis-ci.org/l3pp4rd/DoctrineExtensions)
 
-### Latest updates
-
 **Note:** Use 2.1.x or 2.2.x tag in order to use extensions based on Doctrine2.x.x component versions. Currently
 master branch is based on 2.3.x versions and may not work with older components.
 
+### Latest updates
+
+**2012-01-29**
+
+- Translatable finally has **Personal Translations** which can relate through a real **foreign key**
+constraint and be used as a standard doctrine collection. This allows to configure domain
+objects anyway you prefere and still enjoy all features **Translatable** provides.
+- There were **BC** breaks introduced in **master** branch of extensions which is
+based on **doctrine2.3.x** version. If you are not interested in upgrading you can
+safely checkout at **2.2.x** or **2.1.x** [tag](http://github.com/l3pp4rd/DoctrineExtensions/tags).
+To upgrade your source code follow the [upgrade guide](upgrade/2-3-0.md)
+- Library now can map only **MappedSuperclass**es which would avoid generation of **ext_**
+tables which might not be used. Also it provides [convinient methods](lib/Gedmo/DoctrineExtensions.php#L66)
+to hook extension metadata drivers into metadata driver chain.
+- [Example demo application](example/em.php) has a detailed configuration provided, which
+explains and shows how extensions can or should be used with **Doctrine2** ORM. To install
+it follow the [steps](#example-demo).
+
 **2012-01-23**
 
 - Fixed an issue with inheritance mapping in case of multiple class extension.

+ 8 - 0
upgrade/2-3-0.md

@@ -0,0 +1,8 @@
+# Upgrade from 2.1.x or 2.2.x to 2.3.0
+
+## Changes introduced
+
+- **TranslationListener** classname has changed into **TranslatableListener**
+- Abstract classes (mapped superclasses) were moved into MappedSuperclass subdirectory. Etc.:
+**Gedmo\Translatable\Entity\AbstractTranslation** now is **Gedmo\Translatable\Entity\MappedSuperclass\AbstractTranslation**
+same for abstract log entries and closure.