Added some more documentation
Fixed issues when forcing the current date for testing

 - A lot of checks were still using 'today', so changed them to use the
   configured date. Also fixed a bug creating the day cells - it was
   using today's day of the week rather than the day of the week of the
   first day of the month (this became apparent when converting to use
   the configured date rather than today)
Configurably group recurring events in event list

 - Will now optionally display a recurring event only once in the event
   list (defaults to once per instance)
Changed date period checks

 - Need to ensure either the event start or end date is within the
   allowable period and display it if it is
 - Added the flag 'allowPartialEvents' to determine if a partial or
   entire event is show if it falls across a period boundary