Diagrams/Dev/Migrate1.4

From HaskellWiki
< Diagrams‎ | Dev
Revision as of 19:52, 16 October 2016 by Byorgey (talk | contribs) (1.4 migration: moved Query functions)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

This page describes breaking API changes between diagrams 1.3 and 1.4, along with explanations of how to migrate to the new 1.4 API.

The 1.4 release is actually quite light on breaking API changes; most of the changes were additions and bug fixes. Below are the things we are aware of; feel free to add new things below, or create an issue if you are unsure.

Snugs

The snugBL, snugBR, snugTR and snugBR functions have been deprecated, since they were unintuitive, ad-hoc, and not particularly useful, especially since e.g. snugL and snugB do not commute (so in theory snugBL and snugLB would be different). If you were using these functions, you can switch to using a composition like snugB . snugL directly, or use snug with a direction vector. See the discussion at diagrams-lib issue #250 for more details.

Moved Query functions

Some Query-related functions (sample, value, resetValue, and clearValue) have moved from the diagrams-core package to the diagrams-lib package; they can now be found in the Diagrams.Query module. You may have to change an import if you were importing them directly from Diagrams.Core.Types before. However, most likely you would get them just by importing Diagrams.Prelude, in which case no changes are necessary.