/**
  * Description: A "VEVENT" calendar component is a grouping of component
  * properties, and possibly including "VALARM" calendar components, that
  * represents a scheduled amount of time on a calendar. For example, it
  * can be an activity; such as a one-hour long, department meeting from
  * 8:00 AM to 9:00 AM, tomorrow. Generally, an event will take up time
  * on an individual calendar. Hence, the event will appear as an opaque
  * interval in a search for busy time. Alternately, the event can have
  * its Time Transparency set to "TRANSPARENT" in order to prevent
  * blocking of the event in searches for busy time.
  * 
  * Example: The following is an example of the "VEVENT" calendar
  * component used to represent a meeting that will also be opaque to
  * searches for busy time:
  * 
  *   BEGIN:VEVENT
  *   UID:19970901T130000Z-123401@host.com
  *   DTSTAMP:19970901T1300Z
  *   DTSTART:19970903T163000Z
  *   DTEND:19970903T190000Z
  *   SUMMARY:Annual Employee Review
  *   CLASS:PRIVATE
  *   CATEGORIES:BUSINESS,HUMAN RESOURCES
  *   END:VEVENT
  * 
  * The following is an example of the "VEVENT" calendar component used
  * to represent a reminder that will not be opaque, but rather
  * transparent, to searches for busy time:
  * 
  *   BEGIN:VEVENT
  *   UID:19970901T130000Z-123402@host.com
  *   DTSTAMP:19970901T1300Z
  *   DTSTART:19970401T163000Z
  *   DTEND:19970402T010000Z
  *   SUMMARY:Laurel is in sensitivity awareness class.
  *   CLASS:PUBLIC
  *   CATEGORIES:BUSINESS,HUMAN RESOURCES
  *   TRANSP:TRANSPARENT
  *   END:VEVENT
  * 
  * The following is an example of the "VEVENT" calendar component used
  * to represent an anniversary that will occur annually. Since it takes
  * up no time, it will not appear as opaque in a search for busy time;
  * no matter what the value of the "TRANSP" property indicates:
  * 
  *   BEGIN:VEVENT
  *   UID:19970901T130000Z-123403@host.com
  *   DTSTAMP:19970901T1300Z
  *   DTSTART:19971102
  *   SUMMARY:Our Blissful Anniversary
  *   CLASS:CONFIDENTIAL
  *   CATEGORIES:ANNIVERSARY,PERSONAL,SPECIAL OCCASION
  *   RRULE:FREQ=YEARLY
  *   END:VEVENT
  * 
  */
 public function zzztestMeetingThatWillBeOpaqueToSearchesForBusyTime()
 {
     $event = new qCal_Component_Vevent(array('uid' => '*****@*****.**', 'dtstamp' => '19970901T1300Z', 'dtstart' => '19970903T163000Z', 'dtend' => '19970903T190000Z', 'summary' => 'Annual Employee Review', 'class' => 'PRIVATE', 'categories' => array('BUSINESS', 'HUMAN RESOURCES', 'SOMETHING, COOL')));
     $cal = new qCal();
     $cal->attach($event);
     $freebusytime = $cal->getFreeBusyTime();
 }