Chris@0: This document details all the possible changes that you should investigate when 
Chris@0: updating your project from Doctrine Common 2.1 to 2.2:
Chris@0: 
Chris@0: ## Annotation Changes
Chris@0: 
Chris@0: - AnnotationReader::setIgnoreNotImportedAnnotations has been removed, you need to 
Chris@0:   add ignore annotation names which are supposed to be ignored via
Chris@0:   AnnotationReader::addGlobalIgnoredName
Chris@0:   
Chris@0: - AnnotationReader::setAutoloadAnnotations was deprecated by the AnnotationRegistry
Chris@0:   in 2.1 and has been removed in 2.2
Chris@0: 
Chris@0: - AnnotationReader::setEnableParsePhpImports was added to ease transition to the new
Chris@0:   annotation mechanism in 2.1 and is removed in 2.2
Chris@0: 
Chris@0: - AnnotationReader::isParsePhpImportsEnabled is removed (see above)
Chris@0: 
Chris@0: - AnnotationReader::setDefaultAnnotationNamespace was deprecated in favor of explicit
Chris@0:   configuration in 2.1 and will be removed in 2.2 (for isolated projects where you
Chris@0:   have full-control over _all_ available annotations, we offer a dedicated reader
Chris@0:   class ``SimpleAnnotationReader``)
Chris@0: 
Chris@0: - AnnotationReader::setAnnotationCreationFunction was deprecated in 2.1 and will be
Chris@0:   removed in 2.2. We only offer two creation mechanisms which cannot be changed
Chris@0:   anymore to allow the same reader instance to work with all annotations regardless
Chris@0:   of which library they are coming from.
Chris@0:   
Chris@0: - AnnotationReader::setAnnotationNamespaceAlias was deprecated in 2.1 and will be
Chris@0:   removed in 2.2 (see setDefaultAnnotationNamespace)
Chris@0: 
Chris@0: - If you use a class as annotation which has not the @Annotation marker in it's 
Chris@0:   class block, we will now throw an exception instead of silently ignoring it. You
Chris@0:   can however still achieve the previous behavior using the @IgnoreAnnotation, or
Chris@0:   AnnotationReader::addGlobalIgnoredName (the exception message will contain detailed
Chris@0:   instructions when you run into this problem).
Chris@0: 
Chris@0: ## Cache Changes
Chris@0:   
Chris@0: - Renamed old AbstractCache to CacheProvider
Chris@0: 
Chris@0: - Dropped the support to the following functions of all cache providers:
Chris@0: 
Chris@0:  - CacheProvider::deleteByWildcard
Chris@0: 
Chris@0:  - CacheProvider::deleteByRegEx
Chris@0: 
Chris@0:  - CacheProvider::deleteByPrefix
Chris@0: 
Chris@0:  - CacheProvider::deleteBySuffix
Chris@0: 
Chris@0: - CacheProvider::deleteAll will not remove ALL entries, it will only mark them as invalid
Chris@0: 
Chris@0: - CacheProvider::flushAll will remove ALL entries, namespaced or not
Chris@0: 
Chris@0: - Added support to MemcachedCache
Chris@0: 
Chris@0: - Added support to WincacheCache
Chris@0: 
Chris@0: ## ClassLoader Changes
Chris@0: 
Chris@0: - ClassLoader::fileExistsInIncludePath() no longer exists. Use the native stream_resolve_include_path() PHP function