silverstripe-framework/docs/en/changelogs
Hamish Friedlander 27113f82c3 API Make DataList and ArrayList immutable
In 3.0 there was some confusion about whether DataLists and ArrayLists
were mutable or not. If DataLists were immutable, they'd return the result, and your code
would look like

  $list = $list->filter(....);

If DataLists were mutable, they'd operate on themselves, returning nothing, and your code
would look like

 $list->filter(....);

This makes all DataLists and ArrayList immutable for all _searching_ operations.
Operations on DataList that modify the underlying SQL data store remain mutating.

- These functions no longer mutate the existing object, and if you do not capture the value
returned by them will have no effect:

  ArrayList#reverse
  ArrayList#sort
  ArrayList#filter
  ArrayList#exclude

  DataList#dataQuery (use DataList#alterDataQuery to modify dataQuery in a safe manner)
  DataList#where
  DataList#limit
  DataList#sort
  DataList#addFilter
  DataList#applyFilterContext
  DataList#innerJoin
  DataList#leftJoin
  DataList#find
  DataList#byIDs
  DataList#reverse

- DataList#setDataQueryParam has been added as syntactic sugar around the most common
cause of accessing the dataQuery directly - setting query parameters

- RelationList#setForeignID has been removed. Always use RelationList#forForeignID
when querying, and overload RelationList#foreignIDList when subclassing.

- Relatedly,the protected variable RelationList->foreignID has been removed, as the ID is
now stored on a query parameter. Use RelationList#getForeignID to read it.
2012-12-14 13:30:35 +13:00
..
_images MINOR Upgrading notes around tab rewrites 2012-05-09 17:47:19 +02:00
alpha Moved GridField docs to reference 2012-10-30 18:59:26 +01:00
beta MINOR: Updated beta3 changelog 2012-05-28 13:33:15 +12:00
pr MINOR Created 3.0.0 upgrading guide, 3.0.0-pr1 changelog 2011-05-01 22:30:53 +12:00
rc Add 3.0.3-rc2 changelog 2012-11-16 14:45:20 +13:00
2.0.1.md ENHANCEMENT Added sapphire/docs (migrated from https://github.com/chillu/silverstripe-doc-restructuring) 2011-02-07 19:55:13 +13:00
2.0.2.md ENHANCEMENT Added sapphire/docs (migrated from https://github.com/chillu/silverstripe-doc-restructuring) 2011-02-07 19:55:13 +13:00
2.1.0.md ENHANCEMENT Added sapphire/docs (migrated from https://github.com/chillu/silverstripe-doc-restructuring) 2011-02-07 19:55:13 +13:00
2.1.1.md ENHANCEMENT Added sapphire/docs (migrated from https://github.com/chillu/silverstripe-doc-restructuring) 2011-02-07 19:55:13 +13:00
2.2.0.md Spelling correction 2011-10-18 15:32:52 -07:00
2.2.1.md ENHANCEMENT Added sapphire/docs (migrated from https://github.com/chillu/silverstripe-doc-restructuring) 2011-02-07 19:55:13 +13:00
2.2.2.md ENHANCEMENT Added sapphire/docs (migrated from https://github.com/chillu/silverstripe-doc-restructuring) 2011-02-07 19:55:13 +13:00
2.2.3.md ENHANCEMENT Added sapphire/docs (migrated from https://github.com/chillu/silverstripe-doc-restructuring) 2011-02-07 19:55:13 +13:00
2.2.4.md ENHANCEMENT Added sapphire/docs (migrated from https://github.com/chillu/silverstripe-doc-restructuring) 2011-02-07 19:55:13 +13:00
2.3.0.md Spelling correction 2011-10-18 15:32:52 -07:00
2.3.1.md ENHANCEMENT Added sapphire/docs (migrated from https://github.com/chillu/silverstripe-doc-restructuring) 2011-02-07 19:55:13 +13:00
2.3.2.md ENHANCEMENT Added sapphire/docs (migrated from https://github.com/chillu/silverstripe-doc-restructuring) 2011-02-07 19:55:13 +13:00
2.3.3.md ENHANCEMENT Added sapphire/docs (migrated from https://github.com/chillu/silverstripe-doc-restructuring) 2011-02-07 19:55:13 +13:00
2.3.4.md ENHANCEMENT Added sapphire/docs (migrated from https://github.com/chillu/silverstripe-doc-restructuring) 2011-02-07 19:55:13 +13:00
2.3.5.md ENHANCEMENT Added sapphire/docs (migrated from https://github.com/chillu/silverstripe-doc-restructuring) 2011-02-07 19:55:13 +13:00
2.3.6.md MINOR: formatting changes and fixes to original document formatting 2011-03-21 11:51:50 +13:00
2.3.7.md MINOR: formatting changes and fixes to original document formatting 2011-03-21 11:51:50 +13:00
2.3.8.md MINOR: formatting changes and fixes to original document formatting 2011-03-21 11:51:50 +13:00
2.3.9.md ENHANCEMENT Added sapphire/docs (migrated from https://github.com/chillu/silverstripe-doc-restructuring) 2011-02-07 19:55:13 +13:00
2.3.10.md ENHANCEMENT Added sapphire/docs (migrated from https://github.com/chillu/silverstripe-doc-restructuring) 2011-02-07 19:55:13 +13:00
2.3.11.md ENHANCEMENT Added sapphire/docs (migrated from https://github.com/chillu/silverstripe-doc-restructuring) 2011-02-07 19:55:13 +13:00
2.3.12.md MINOR Updated changelog 2011-10-18 11:54:45 +02:00
2.3.13.md MINOR Updated changelog 2012-01-31 17:04:59 +01:00
2.4.0.md ENHANCEMENT Added sapphire/docs (migrated from https://github.com/chillu/silverstripe-doc-restructuring) 2011-02-07 19:55:13 +13:00
2.4.1.md MINOR: formatting changes and fixes to original document formatting 2011-03-21 11:51:50 +13:00
2.4.2.md MINOR: formatting changes and fixes to original document formatting 2011-03-21 11:51:50 +13:00
2.4.3.md ENHANCEMENT Added sapphire/docs (migrated from https://github.com/chillu/silverstripe-doc-restructuring) 2011-02-07 19:55:13 +13:00
2.4.4.md ENHANCEMENT Added sapphire/docs (migrated from https://github.com/chillu/silverstripe-doc-restructuring) 2011-02-07 19:55:13 +13:00
2.4.5.md ENHANCEMENT Added sapphire/docs (migrated from https://github.com/chillu/silverstripe-doc-restructuring) 2011-02-07 19:55:13 +13:00
2.4.6.md Changelogs 2012-10-30 17:00:41 +01:00
2.4.7.md Changelogs 2012-10-30 17:00:41 +01:00
2.4.8.md Changelogs 2012-10-30 17:00:41 +01:00
3.0.0.md Moved GridField docs to reference 2012-10-30 18:59:26 +01:00
3.0.1.md Add changelog for 3.0.1 2012-07-31 16:42:40 +12:00
3.0.2.md Added 3.0.2 changelog (and added missing 3.0.1 changelog to the list) 2012-09-17 13:25:31 +12:00
3.0.3.md Add 3.0.3 changelog 2012-11-26 11:20:21 +13:00
3.1.0.md API Make DataList and ArrayList immutable 2012-12-14 13:30:35 +13:00
index.md Merge branch '3.0' 2012-11-06 13:04:21 +13:00