From 3cbd63c1aa1c743a71d9a34516609d74a8870606 Mon Sep 17 00:00:00 2001
From: Jan Schneider <jan@horde.org>
Date: Tue, 16 Nov 2010 14:59:35 +0100
Subject: [PATCH] phpdoc

---
 framework/Date/lib/Horde/Date.php                     |  2 +-
 framework/Date/lib/Horde/Date/Recurrence.php          |  4 ++--
 framework/Date/lib/Horde/Date/Repeater.php            |  9 +++++++++
 framework/Date/lib/Horde/Date/Repeater/Day.php        | 14 ++++++++++++++
 framework/Date/lib/Horde/Date/Repeater/DayName.php    | 14 ++++++++++++++
 framework/Date/lib/Horde/Date/Repeater/DayPortion.php | 14 ++++++++++++++
 framework/Date/lib/Horde/Date/Repeater/Exception.php  | 14 ++++++++++++++
 framework/Date/lib/Horde/Date/Repeater/Fortnight.php  | 14 ++++++++++++++
 framework/Date/lib/Horde/Date/Repeater/Hour.php       | 14 ++++++++++++++
 framework/Date/lib/Horde/Date/Repeater/Minute.php     | 14 ++++++++++++++
 framework/Date/lib/Horde/Date/Repeater/Month.php      | 14 ++++++++++++++
 framework/Date/lib/Horde/Date/Repeater/MonthName.php  | 14 ++++++++++++++
 framework/Date/lib/Horde/Date/Repeater/Season.php     | 14 ++++++++++++++
 framework/Date/lib/Horde/Date/Repeater/SeasonName.php | 14 ++++++++++++++
 framework/Date/lib/Horde/Date/Repeater/Second.php     | 14 ++++++++++++++
 framework/Date/lib/Horde/Date/Repeater/Time.php       | 14 ++++++++++++++
 framework/Date/lib/Horde/Date/Repeater/Week.php       | 14 ++++++++++++++
 framework/Date/lib/Horde/Date/Repeater/Weekend.php    | 14 ++++++++++++++
 framework/Date/lib/Horde/Date/Repeater/Year.php       | 14 ++++++++++++++
 framework/Date/lib/Horde/Date/Span.php                | 14 +++++++++++---
 framework/Date/lib/Horde/Date/Utils.php               | 10 +++++-----
 21 files changed, 252 insertions(+), 11 deletions(-)

diff --git a/framework/Date/lib/Horde/Date.php b/framework/Date/lib/Horde/Date.php
index fe06b6dae..3f5b3ad15 100644
--- a/framework/Date/lib/Horde/Date.php
+++ b/framework/Date/lib/Horde/Date.php
@@ -4,7 +4,7 @@
  * functions.
  *
  * @category Horde
- * @package  Horde_Date
+ * @package  Date
  *
  * @TODO in format():
  *   http://php.net/intldateformatter
diff --git a/framework/Date/lib/Horde/Date/Recurrence.php b/framework/Date/lib/Horde/Date/Recurrence.php
index 04c9d2b68..318ce4b35 100644
--- a/framework/Date/lib/Horde/Date/Recurrence.php
+++ b/framework/Date/lib/Horde/Date/Recurrence.php
@@ -8,7 +8,7 @@
  * did not receive this file, see http://www.fsf.org/copyleft/lgpl.html.
  *
  * @category Horde
- * @package  Horde_Date
+ * @package  Date
  */
 
 /**
@@ -23,7 +23,7 @@
  *
  * @author   Jan Schneider <jan@horde.org>
  * @category Horde
- * @package  Horde_Date
+ * @package  Date
  */
 class Horde_Date_Recurrence
 {
diff --git a/framework/Date/lib/Horde/Date/Repeater.php b/framework/Date/lib/Horde/Date/Repeater.php
index 4f62c081f..886b24683 100644
--- a/framework/Date/lib/Horde/Date/Repeater.php
+++ b/framework/Date/lib/Horde/Date/Repeater.php
@@ -1,8 +1,17 @@
 <?php
 /**
+ * Copyright 2009-2010 The Horde Project (http://www.horde.org/)
+ *
+ * See the enclosed file COPYING for license information (LGPL). If you
+ * did not receive this file, see http://www.fsf.org/copyleft/lgpl.html.
+ *
+ * @category Horde
+ * @package  Date
  */
 
 /**
+ * @category Horde
+ * @package  Date
  */
 abstract class Horde_Date_Repeater
 {
diff --git a/framework/Date/lib/Horde/Date/Repeater/Day.php b/framework/Date/lib/Horde/Date/Repeater/Day.php
index 1d0f45746..e8d783b88 100644
--- a/framework/Date/lib/Horde/Date/Repeater/Day.php
+++ b/framework/Date/lib/Horde/Date/Repeater/Day.php
@@ -1,4 +1,18 @@
 <?php
+/**
+ * Copyright 2009-2010 The Horde Project (http://www.horde.org/)
+ *
+ * See the enclosed file COPYING for license information (LGPL). If you
+ * did not receive this file, see http://www.fsf.org/copyleft/lgpl.html.
+ *
+ * @category Horde
+ * @package  Date
+ */
+
+/**
+ * @category Horde
+ * @package  Date
+ */
 class Horde_Date_Repeater_Day extends Horde_Date_Repeater
 {
     // (24 * 60 * 60)
diff --git a/framework/Date/lib/Horde/Date/Repeater/DayName.php b/framework/Date/lib/Horde/Date/Repeater/DayName.php
index 4bfdc6990..62d2089a3 100644
--- a/framework/Date/lib/Horde/Date/Repeater/DayName.php
+++ b/framework/Date/lib/Horde/Date/Repeater/DayName.php
@@ -1,4 +1,18 @@
 <?php
+/**
+ * Copyright 2009-2010 The Horde Project (http://www.horde.org/)
+ *
+ * See the enclosed file COPYING for license information (LGPL). If you
+ * did not receive this file, see http://www.fsf.org/copyleft/lgpl.html.
+ *
+ * @category Horde
+ * @package  Date
+ */
+
+/**
+ * @category Horde
+ * @package  Date
+ */
 class Horde_Date_Repeater_DayName extends Horde_Date_Repeater
 {
     // (24 * 60 * 60)
diff --git a/framework/Date/lib/Horde/Date/Repeater/DayPortion.php b/framework/Date/lib/Horde/Date/Repeater/DayPortion.php
index 19b490c87..b35800cf0 100644
--- a/framework/Date/lib/Horde/Date/Repeater/DayPortion.php
+++ b/framework/Date/lib/Horde/Date/Repeater/DayPortion.php
@@ -1,4 +1,18 @@
 <?php
+/**
+ * Copyright 2009-2010 The Horde Project (http://www.horde.org/)
+ *
+ * See the enclosed file COPYING for license information (LGPL). If you
+ * did not receive this file, see http://www.fsf.org/copyleft/lgpl.html.
+ *
+ * @category Horde
+ * @package  Date
+ */
+
+/**
+ * @category Horde
+ * @package  Date
+ */
 class Horde_Date_Repeater_DayPortion extends Horde_Date_Repeater
 {
     /**
diff --git a/framework/Date/lib/Horde/Date/Repeater/Exception.php b/framework/Date/lib/Horde/Date/Repeater/Exception.php
index 0fb573e7a..2e82cdecb 100644
--- a/framework/Date/lib/Horde/Date/Repeater/Exception.php
+++ b/framework/Date/lib/Horde/Date/Repeater/Exception.php
@@ -1,4 +1,18 @@
 <?php
+/**
+ * Copyright 2009-2010 The Horde Project (http://www.horde.org/)
+ *
+ * See the enclosed file COPYING for license information (LGPL). If you
+ * did not receive this file, see http://www.fsf.org/copyleft/lgpl.html.
+ *
+ * @category Horde
+ * @package  Date
+ */
+
+/**
+ * @category Horde
+ * @package  Date
+ */
 class Horde_Date_Repeater_Exception extends Exception
 {
 }
diff --git a/framework/Date/lib/Horde/Date/Repeater/Fortnight.php b/framework/Date/lib/Horde/Date/Repeater/Fortnight.php
index cfb4d56f3..4040ff2c0 100644
--- a/framework/Date/lib/Horde/Date/Repeater/Fortnight.php
+++ b/framework/Date/lib/Horde/Date/Repeater/Fortnight.php
@@ -1,4 +1,18 @@
 <?php
+/**
+ * Copyright 2009-2010 The Horde Project (http://www.horde.org/)
+ *
+ * See the enclosed file COPYING for license information (LGPL). If you
+ * did not receive this file, see http://www.fsf.org/copyleft/lgpl.html.
+ *
+ * @category Horde
+ * @package  Date
+ */
+
+/**
+ * @category Horde
+ * @package  Date
+ */
 class Horde_Date_Repeater_Fortnight extends Horde_Date_Repeater
 {
     // (14 * 24 * 60 * 60)
diff --git a/framework/Date/lib/Horde/Date/Repeater/Hour.php b/framework/Date/lib/Horde/Date/Repeater/Hour.php
index 6c3048252..51f7dd481 100644
--- a/framework/Date/lib/Horde/Date/Repeater/Hour.php
+++ b/framework/Date/lib/Horde/Date/Repeater/Hour.php
@@ -1,4 +1,18 @@
 <?php
+/**
+ * Copyright 2009-2010 The Horde Project (http://www.horde.org/)
+ *
+ * See the enclosed file COPYING for license information (LGPL). If you
+ * did not receive this file, see http://www.fsf.org/copyleft/lgpl.html.
+ *
+ * @category Horde
+ * @package  Date
+ */
+
+/**
+ * @category Horde
+ * @package  Date
+ */
 class Horde_Date_Repeater_Hour extends Horde_Date_Repeater
 {
     public $currentHourStart;
diff --git a/framework/Date/lib/Horde/Date/Repeater/Minute.php b/framework/Date/lib/Horde/Date/Repeater/Minute.php
index 0f5ff0ac5..ac7b3fff4 100644
--- a/framework/Date/lib/Horde/Date/Repeater/Minute.php
+++ b/framework/Date/lib/Horde/Date/Repeater/Minute.php
@@ -1,4 +1,18 @@
 <?php
+/**
+ * Copyright 2009-2010 The Horde Project (http://www.horde.org/)
+ *
+ * See the enclosed file COPYING for license information (LGPL). If you
+ * did not receive this file, see http://www.fsf.org/copyleft/lgpl.html.
+ *
+ * @category Horde
+ * @package  Date
+ */
+
+/**
+ * @category Horde
+ * @package  Date
+ */
 class Horde_Date_Repeater_Minute extends Horde_Date_Repeater
 {
     public $currentMinuteStart;
diff --git a/framework/Date/lib/Horde/Date/Repeater/Month.php b/framework/Date/lib/Horde/Date/Repeater/Month.php
index 5cf2607cf..dcb6d1885 100644
--- a/framework/Date/lib/Horde/Date/Repeater/Month.php
+++ b/framework/Date/lib/Horde/Date/Repeater/Month.php
@@ -1,4 +1,18 @@
 <?php
+/**
+ * Copyright 2009-2010 The Horde Project (http://www.horde.org/)
+ *
+ * See the enclosed file COPYING for license information (LGPL). If you
+ * did not receive this file, see http://www.fsf.org/copyleft/lgpl.html.
+ *
+ * @category Horde
+ * @package  Date
+ */
+
+/**
+ * @category Horde
+ * @package  Date
+ */
 class Horde_Date_Repeater_Month extends Horde_Date_Repeater
 {
     /**
diff --git a/framework/Date/lib/Horde/Date/Repeater/MonthName.php b/framework/Date/lib/Horde/Date/Repeater/MonthName.php
index 32229b6b0..2c386910e 100644
--- a/framework/Date/lib/Horde/Date/Repeater/MonthName.php
+++ b/framework/Date/lib/Horde/Date/Repeater/MonthName.php
@@ -1,4 +1,18 @@
 <?php
+/**
+ * Copyright 2009-2010 The Horde Project (http://www.horde.org/)
+ *
+ * See the enclosed file COPYING for license information (LGPL). If you
+ * did not receive this file, see http://www.fsf.org/copyleft/lgpl.html.
+ *
+ * @category Horde
+ * @package  Date
+ */
+
+/**
+ * @category Horde
+ * @package  Date
+ */
 class Horde_Date_Repeater_MonthName extends Horde_Date_Repeater
 {
     public $currentMonthStart;
diff --git a/framework/Date/lib/Horde/Date/Repeater/Season.php b/framework/Date/lib/Horde/Date/Repeater/Season.php
index 720a677ed..1c586ff1d 100644
--- a/framework/Date/lib/Horde/Date/Repeater/Season.php
+++ b/framework/Date/lib/Horde/Date/Repeater/Season.php
@@ -1,4 +1,18 @@
 <?php
+/**
+ * Copyright 2009-2010 The Horde Project (http://www.horde.org/)
+ *
+ * See the enclosed file COPYING for license information (LGPL). If you
+ * did not receive this file, see http://www.fsf.org/copyleft/lgpl.html.
+ *
+ * @category Horde
+ * @package  Date
+ */
+
+/**
+ * @category Horde
+ * @package  Date
+ */
 class Horde_Date_Repeater_Season extends Horde_Date_Repeater
 {
     /**
diff --git a/framework/Date/lib/Horde/Date/Repeater/SeasonName.php b/framework/Date/lib/Horde/Date/Repeater/SeasonName.php
index 1e1d59031..c292bb615 100644
--- a/framework/Date/lib/Horde/Date/Repeater/SeasonName.php
+++ b/framework/Date/lib/Horde/Date/Repeater/SeasonName.php
@@ -1,4 +1,18 @@
 <?php
+/**
+ * Copyright 2009-2010 The Horde Project (http://www.horde.org/)
+ *
+ * See the enclosed file COPYING for license information (LGPL). If you
+ * did not receive this file, see http://www.fsf.org/copyleft/lgpl.html.
+ *
+ * @category Horde
+ * @package  Date
+ */
+
+/**
+ * @category Horde
+ * @package  Date
+ */
 class Horde_Date_Repeater_SeasonName extends Horde_Date_Repeater_Season
 {
     /**
diff --git a/framework/Date/lib/Horde/Date/Repeater/Second.php b/framework/Date/lib/Horde/Date/Repeater/Second.php
index 1e16b7ed6..b6317b74b 100644
--- a/framework/Date/lib/Horde/Date/Repeater/Second.php
+++ b/framework/Date/lib/Horde/Date/Repeater/Second.php
@@ -1,4 +1,18 @@
 <?php
+/**
+ * Copyright 2009-2010 The Horde Project (http://www.horde.org/)
+ *
+ * See the enclosed file COPYING for license information (LGPL). If you
+ * did not receive this file, see http://www.fsf.org/copyleft/lgpl.html.
+ *
+ * @category Horde
+ * @package  Date
+ */
+
+/**
+ * @category Horde
+ * @package  Date
+ */
 class Horde_Date_Repeater_Second extends Horde_Date_Repeater
 {
     public $secondStart;
diff --git a/framework/Date/lib/Horde/Date/Repeater/Time.php b/framework/Date/lib/Horde/Date/Repeater/Time.php
index 21e37f56c..41d2484a8 100644
--- a/framework/Date/lib/Horde/Date/Repeater/Time.php
+++ b/framework/Date/lib/Horde/Date/Repeater/Time.php
@@ -1,4 +1,18 @@
 <?php
+/**
+ * Copyright 2009-2010 The Horde Project (http://www.horde.org/)
+ *
+ * See the enclosed file COPYING for license information (LGPL). If you
+ * did not receive this file, see http://www.fsf.org/copyleft/lgpl.html.
+ *
+ * @category Horde
+ * @package  Date
+ */
+
+/**
+ * @category Horde
+ * @package  Date
+ */
 class Horde_Date_Repeater_Time extends Horde_Date_Repeater
 {
     public $currentTime;
diff --git a/framework/Date/lib/Horde/Date/Repeater/Week.php b/framework/Date/lib/Horde/Date/Repeater/Week.php
index 9424757bf..64a59e7b0 100644
--- a/framework/Date/lib/Horde/Date/Repeater/Week.php
+++ b/framework/Date/lib/Horde/Date/Repeater/Week.php
@@ -1,4 +1,18 @@
 <?php
+/**
+ * Copyright 2009-2010 The Horde Project (http://www.horde.org/)
+ *
+ * See the enclosed file COPYING for license information (LGPL). If you
+ * did not receive this file, see http://www.fsf.org/copyleft/lgpl.html.
+ *
+ * @category Horde
+ * @package  Date
+ */
+
+/**
+ * @category Horde
+ * @package  Date
+ */
 class Horde_Date_Repeater_Week extends Horde_Date_Repeater
 {
     /**
diff --git a/framework/Date/lib/Horde/Date/Repeater/Weekend.php b/framework/Date/lib/Horde/Date/Repeater/Weekend.php
index 3af4b1691..07db65b38 100644
--- a/framework/Date/lib/Horde/Date/Repeater/Weekend.php
+++ b/framework/Date/lib/Horde/Date/Repeater/Weekend.php
@@ -1,4 +1,18 @@
 <?php
+/**
+ * Copyright 2009-2010 The Horde Project (http://www.horde.org/)
+ *
+ * See the enclosed file COPYING for license information (LGPL). If you
+ * did not receive this file, see http://www.fsf.org/copyleft/lgpl.html.
+ *
+ * @category Horde
+ * @package  Date
+ */
+
+/**
+ * @category Horde
+ * @package  Date
+ */
 class Horde_Date_Repeater_Weekend extends Horde_Date_Repeater
 {
     /**
diff --git a/framework/Date/lib/Horde/Date/Repeater/Year.php b/framework/Date/lib/Horde/Date/Repeater/Year.php
index 806c46cc3..83d92a88c 100644
--- a/framework/Date/lib/Horde/Date/Repeater/Year.php
+++ b/framework/Date/lib/Horde/Date/Repeater/Year.php
@@ -1,4 +1,18 @@
 <?php
+/**
+ * Copyright 2009-2010 The Horde Project (http://www.horde.org/)
+ *
+ * See the enclosed file COPYING for license information (LGPL). If you
+ * did not receive this file, see http://www.fsf.org/copyleft/lgpl.html.
+ *
+ * @category Horde
+ * @package  Date
+ */
+
+/**
+ * @category Horde
+ * @package  Date
+ */
 class Horde_Date_Repeater_Year extends Horde_Date_Repeater
 {
     public $currentYearStart;
diff --git a/framework/Date/lib/Horde/Date/Span.php b/framework/Date/lib/Horde/Date/Span.php
index 364a40806..ad7d584a6 100644
--- a/framework/Date/lib/Horde/Date/Span.php
+++ b/framework/Date/lib/Horde/Date/Span.php
@@ -1,12 +1,20 @@
 <?php
 /**
- * A Span represents a range of time.
+ * Copyright 2009-2010 The Horde Project (http://www.horde.org/)
+ *
+ * See the enclosed file COPYING for license information (LGPL). If you
+ * did not receive this file, see http://www.fsf.org/copyleft/lgpl.html.
  *
- * @package Horde_Date
+ * @category Horde
+ * @package  Date
  */
 
 /**
- * @package Horde_Date
+ * A Span represents a range of time.
+ *
+ * @author   Chuck Hagenbuch <chuck@horde.org>
+ * @category Horde
+ * @package  Date
  */
 class Horde_Date_Span
 {
diff --git a/framework/Date/lib/Horde/Date/Utils.php b/framework/Date/lib/Horde/Date/Utils.php
index 991a4eda0..05abe6d8a 100644
--- a/framework/Date/lib/Horde/Date/Utils.php
+++ b/framework/Date/lib/Horde/Date/Utils.php
@@ -1,15 +1,15 @@
 <?php
 /**
- * Horde Date wrapper/logic class, including some calculation
- * functions.
- *
  * @category Horde
- * @package  Horde_Date
+ * @package  Date
  */
 
 /**
+ * Horde Date wrapper/logic class, including some calculation
+ * functions.
+ *
  * @category Horde
- * @package  Horde_Date
+ * @package  Date
  */
 class Horde_Date_Utils
 {
-- 
2.11.0