phpdoc

horde · Mar 28, 2014 · 4ea6424 · 4ea6424
1 parent 7aab641
commit 4ea6424
Show file tree

Hide file tree

Showing 2 changed files with 14 additions and 1 deletion.
diff --git a/framework/Service_Weather/lib/Horde/Service/Weather/Station.php b/framework/Service_Weather/lib/Horde/Service/Weather/Station.php
@@ -17,6 +17,17 @@
  * @author   Michael J Rubinsky <mrubinsk@horde.org>
  * @category Horde
  * @package  Service_Weather
+ *
+ * @property string name          The station's common name.
+ * @property string city          The city.
+ * @property string state         The state.
+ * @property string country       The country's iso3166 name (if available).
+ * @property string country_name  The country's common name.
+ * @property string tz            The timezone name (if available).
+ * @property string lat           The lattitude (if available).
+ * @property string lon           The longitude (if available).
+ * @property string zip           The postal code.
+ * @property string code          The internal identifier for the API.
  */
 class Horde_Service_Weather_Station
 {

diff --git a/framework/Service_Weather/lib/Horde/Service/Weather/Wwo.php b/framework/Service_Weather/lib/Horde/Service/Weather/Wwo.php
@@ -225,7 +225,9 @@ protected function _parseStation($station)
             'state' => $station->region[0]->value,
             'country' => $station->country[0]->value,
             'country_name' => '',
-            'tz' => '', // Not provided, can we assume it's the location's local?
+            // Only the *current* UTC offset is provided, with no indication
+            // if we are in DST or not, so this is pretty useless.
+            'tz' => '',
             'lat' => $station->latitude,
             'lon' => $station->longitude,
             'zip' => '',