consolidate changelog for 2.1.0

changelog.md

@@ -1,104 +1,72 @@
 
-v2.1.0-beta3 (2014-08-19)
--------------------------
-
-- If agenda event is too short, don't overwrite .fc-event-time ([1700])
-- drop callback date doesn't have calendar's timezone ([2225])
-- event resize when timezone set to 'local' not working ([2226])
-- scrolling while selecting in Agenda view ([2228])
-- box-sizing: border-box (eg from bootstrap) causes incorrect positioning ([2234])
-- today button has fc-state-hover class when mouse is not over it ([2235])
-- Dates for previous and coming month is not greyed out ([2238])
-- External drag/drop events not working after the view is changed ([2240])
-- hide popover with print stylesheet ([2242])
-
-[1700]: https://code.google.com/p/fullcalendar/issues/detail?id=1700
-[2225]: https://code.google.com/p/fullcalendar/issues/detail?id=2225
-[2226]: https://code.google.com/p/fullcalendar/issues/detail?id=2226
-[2228]: https://code.google.com/p/fullcalendar/issues/detail?id=2228
-[2234]: https://code.google.com/p/fullcalendar/issues/detail?id=2234
-[2235]: https://code.google.com/p/fullcalendar/issues/detail?id=2235
-[2238]: https://code.google.com/p/fullcalendar/issues/detail?id=2238
-[2240]: https://code.google.com/p/fullcalendar/issues/detail?id=2240
-[2242]: https://code.google.com/p/fullcalendar/issues/detail?id=2242
-
-
-v2.1.0-beta2 (2014-08-04)
--------------------------
-
-RESOLVED ISSUES:
-- Max events with "more..." link ([304])
-- Don't fire eventMouseover/eventMouseout while dragging/resizing ([1297])
-
-NEW OPTIONS:
-- eventLimit
-- eventLimitClick
-- eventLimitText
-- dayPopoverFormat
-
-[304]: https://code.google.com/p/fullcalendar/issues/detail?id=304
-[1297]: https://code.google.com/p/fullcalendar/issues/detail?id=1297
-
-
-v2.1.0-beta1 (2014-07-23)
--------------------------
-
-No more reliance on jQuery UI for event dragging or resizing.
-Large internal code refactor with better OOP, better code reuse, and more comments.
-
-BACKWARDS INCOMPATIBLE CHANGES:
-- HTML skeleton is very different, lots of CSS and many classNames have changed.
-  Your CSS for customizing the look of the calendar will probably need to be rewritten.
-  IE7 support was officially dropped in v2.0.0, but things still worked ok. Not the case anymore.
-- In month view, when the calendar's height overflows because of too many events, vertical
-  scrollbars will appear. To turn this behavior off, set the height option to 'auto'.
-- The CSS for styling events forces one line of text and cuts off titles when they overflow.
-  It is possible to undo this default behavior through custom CSS, but not recommended, as it might
-  introduce gaps between events [like this][111]. There is no way around this since
-  [moving to tables][809] for event positioning, as required to solve [printing problems][35] and
-  eventually the ["too many events" issue][304].
-
-NEW OPTIONS:
-- 'auto' value for height and contentHeight
-- fixedWeekCount
-
-DEPRECATED OPTIONS:
-- weekMode (use height 'auto' and fixedWeekCount instead)
+v2.1.0 (2014-08-25)
+-------------------
 
-RESOLVED ISSUES:
-- Problems with printing ([35])
+Large code refactor with better OOP, better code reuse, and more comments.
+**No more reliance on jQuery UI** for event dragging, resizing, or anything else.
+
+Significant changes to HTML/CSS skeleton:
+- Leverages tables for liquid rendering of days and events. No costly manual repositioning ([809])
+- **Backwards-incompatibilities**:
+	- **Many classNames have changed. Custom CSS will likely need to be adjusted.**
+	- IE7 definitely not supported anymore
+	- In `eventRender` callback, `element` will not be attached to DOM yet
+	- Events are styled to be one line by default ([1992]). Can be undone through custom CSS,
+	  but not recommended (might get gaps [like this][111] in certain situations).
+
+A "more..." link when there are too many events on a day ([304]). Works with month and basic views
+as well as the all-day section of the agenda views. New options:
+- `eventLimit`. a number or `true`
+- `eventLimitClick`. the `"popover`" value will reveal all events in a raised panel (the default)
+- `eventLimitText`
+- `dayPopoverFormat`
+
+Changes related to height and scrollbars:
+- `aspectRatio`/`height`/`contentHeight` values will be honored *no matter what*
+	- If too many events causing too much vertical space, scrollbars will be used ([728]).
+	  This is default behavior for month view (**backwards-incompatibility**)
+	- If too few slots in agenda view, view will stretch to be the correct height ([2196])
+- `'auto'` value for `height`/`contentHeight` options. If content is too tall, the view will
+  vertically stretch to accomodate and no scrollbars will be used ([521]).
+- Tall weeks in month view will borrow height from other weeks ([243])
+- New `fixedWeekCount` option to determines the number of weeks in month view
+	- Supercedes `weekMode` (**deprecated**). Instead, use a combination of `fixedWeekCount` and
+	  one of the height options, possibly with an `'auto'` value
+
+Much nicer, glitch-free rendering of calendar *for printers* ([35]). Things you might not expect:
+- Buttons will become hidden
+- Agenda views display a flat list of events where the time slots would be
+
+Other issues resolved along the way:
 - Space on right side of agenda events configurable through CSS ([204])
-- Tall weeks in month-view should try to borrow height from other weeks ([243])
 - Problem with window resize ([259])
 - Events sorting stays consistent across weeks ([510])
 - Agenda's columns misaligned on wide screens ([511])
-- Agenda view without scrollbars, natural height ([521])
-- Run selectHelper through eventRender/eventAfterRender callbacks ([629])
+- Run `selectHelper` through `eventRender` callbacks ([629])
 - Keyboard access, tabbing ([637])
-- Run resizing events through eventRender/eventAfterRender ([714])
-- Stationary header, scrolling calendar body ([728])
+- Run resizing events through `eventRender` ([714])
 - Resize an event to a different day in agenda views ([736])
 - Allow selection across days in agenda views ([778])
-- Use tables to position events, no need for repositioning ([809])
 - Mouseenter delegated event not working on event elements ([936])
 - Agenda event dragging, snapping to different columns is erratic ([1101])
 - Android browser cuts off Day view at 8 PM with no scroll bar ([1203])
+- Don't fire `eventMouseover`/`eventMouseout` while dragging/resizing ([1297])
 - Customize the resize handle text ("=") ([1326])
-- If agenda event is too short, don't overwrite .fc-event-time ([1700])
-- Limit height of events to 1-line by default ([1992])
-- Zooming calendar causes events to miss-align ([1996])
+- If agenda event is too short, don't overwrite `.fc-event-time` ([1700])
+- Zooming calendar causes events to misalign ([1996])
 - Event destroy callback on event removal ([2017])
 - Agenda views, when RTL, should have axis on right ([2132])
 - Make header buttons more accessibile ([2151])
 - daySelectionMousedown should interpret OSX ctrl+click as a right mouse click ([2169])
 - Best way to display time text on multi-day events *with times* ([2172])
-- Eliminate table use for layout ([2186])
-- Agenda views should fill total height ([2196])
+- Eliminate table use for header layout ([2186])
+- Event delegation used for event-related callbacks (like `eventClick`). Speedier.
 
 [35]: https://code.google.com/p/fullcalendar/issues/detail?id=35
 [204]: https://code.google.com/p/fullcalendar/issues/detail?id=204
 [243]: https://code.google.com/p/fullcalendar/issues/detail?id=243
 [259]: https://code.google.com/p/fullcalendar/issues/detail?id=259
+[304]: https://code.google.com/p/fullcalendar/issues/detail?id=304
 [510]: https://code.google.com/p/fullcalendar/issues/detail?id=510
 [511]: https://code.google.com/p/fullcalendar/issues/detail?id=511
 [521]: https://code.google.com/p/fullcalendar/issues/detail?id=521
@@ -112,6 +80,7 @@ RESOLVED ISSUES:
 [936]: https://code.google.com/p/fullcalendar/issues/detail?id=936
 [1101]: https://code.google.com/p/fullcalendar/issues/detail?id=1101
 [1203]: https://code.google.com/p/fullcalendar/issues/detail?id=1203
+[1297]: https://code.google.com/p/fullcalendar/issues/detail?id=1297
 [1326]: https://code.google.com/p/fullcalendar/issues/detail?id=1326
 [1700]: https://code.google.com/p/fullcalendar/issues/detail?id=1700
 [1992]: https://code.google.com/p/fullcalendar/issues/detail?id=1992
@@ -124,7 +93,6 @@ RESOLVED ISSUES:
 [2186]: https://code.google.com/p/fullcalendar/issues/detail?id=2186
 [2196]: https://code.google.com/p/fullcalendar/issues/detail?id=2196
 [111]: https://code.google.com/p/fullcalendar/issues/detail?id=111
-[304]: https://code.google.com/p/fullcalendar/issues/detail?id=304
 
 
 v2.0.3 (2014-08-15)