Weather properties.

1 files changed, 121 insertions, 16 deletions

diff --git a/spec/context.xml b/spec/context.xml
index 061a432f..fc315526 100644
--- a/spec/context.xml
+++ b/spec/context.xml
@@ -35,10 +35,9 @@ by the graphics hardware.  _(stable)_
       </key>
       <key name="IsCovered" type="TRUTH">
 	<doc>
-Whether or not the main display screen is covered and can
-not be seen by the user.  This might mean that the device is
-laying face down on a table, or that its lid is closed if it
-has one.  _(stable)_
+Whether or not the main display screen is covered and can thus not be
+seen by the user.  This might mean that the device is laying face down
+on a table, or that its lid is closed if it has one.  _(stable)_
 	</doc>
       </key>
     </node>
@@ -51,33 +50,33 @@ Information about the geographic location of the device.
       </doc>
       <key name="Streets" type="STRING">
 	<doc>
-The names of the nearby streets, as a list of strings.  The list might
+The names of the nearby streets, as a set of strings.  The set might
 be empty when the current location is not near any street, or there
-might be more than one name in the list, when we are at an
+might be more than one name in the list when we are at an
 intersection.
 	</doc>
       </key>
       <key name="City" type="STRING">
 	<doc>
-The name of the current city in the users language, as a string.
+The localized name of the current city, as a string.
 	</doc>
       </key>
       <key name="State" type="STRING">
 	<doc>
-The name of the current state in the users language, as a string.
+The localized name of the current state, as a string.
 	</doc>
       </key>
       <key name="StateCode" type="STRING">
 	<doc>
 The ISO 3166-2 code of the current state, as a string.  See
 link:http://en.wikipedia.org/wiki/ISO_3166-2[here] for more
-information.  This value of this property includes the IS3166-1
+information.  The value of this property includes the ISO 3166-1
 alpha-2 prefix, as is usual for ISO 3166-2 codes.
 	</doc>
       </key>
       <key name="Country" type="STRING">
 	<doc>
-The name of the current country in the users language, as a string.
+The localized name of the current country, as a string.
 	</doc>
       </key>
       <key name="CountryCode" type="STRING">
@@ -89,12 +88,13 @@ information.
       </key>
       <key name="Continent" type="STRING">
 	<doc>
-The name of the current continent, as a string.
+The localized name of the current continent, as a string.
 	</doc>
       </key>
       <key name="Planet" type="STRING">
 	<doc>
-The name of the current planet (or dwarf planet), as a string.
+The localized name of the current planet (or dwarf planet), as a
+string.
 	</doc>
       </key>
     </node>
@@ -106,18 +106,123 @@ Network connectivity
 Information about the network connectivity of the device.
       </doc>
     </node>
-    <node name="Situation">
+    <node name="Environment">
       <doc>
-Situations
-----------
+Environment
+-----------
 
-Information about the _situation_ the device is in.
+Information about the environment the device is in.
       </doc>
       <key name="IsDark" type="TRUTH">
 	<doc>
 Whether or not it is dark.
 	</doc>
       </key>
+      <key name="SunRise" type="INT">
+	<doc>
+The time of sun rise.
+	</doc>
+      </key>
+      <key name="SunSet" type="INT">
+	<doc>
+The time of sun set.
+	</doc>
+      </key>
+      <node name="Weather">
+	<doc>
+Weather
+~~~~~~~
+
+The current weather.  (Right now, it's a set of properties, but we
+might unify this as a single property with a big dictionary as its
+value.  Or not.)  See http://www.ominous-valve.com/wx_codes.txt for
+more information about codifying weather conditions.  We should lift
+something from there, if just for extra geek points.
+	</doc>
+	<key name="Condition" type="STRING">
+	  <doc>
+The current weather condition, as a localized, human readable string.
+Examples are "Cloudy", "Raining", etc.
+	  </doc>
+	</key>
+	<key name="ConditionCode" type="STRING">
+	  <doc>
+The current weather condition, as a symbolic string.  The set of
+symbols is to be defined, but it will be fixed and quite small so that
+you can provide an icon for each of them, etc.
+	  </doc>
+	</key>
+	<key name="Humidity" type="INT">
+	  <doc>
+The relative humidity in percent.
+	  </doc>
+	</key>
+	<key name="Temperature" type="STRING">
+	  <doc>
+The temperature as a localized string.  This string represents the
+temperature in the way preferred by the user.  Most often this means
+either degrees Celsius or degrees Fahrenheit, but it could be some
+other unit entirely.
+	  </doc>
+	</key>
+	<key name="TemperatureK" type="DOUBLE">
+	  <doc>
+The temperature in Kelvin.
+	  </doc>
+	</key>
+	<key name="FeltTemperature" type="STRING">
+	  <doc>
+The felt temperature as a localized string, analogous to Temperature.
+	  </doc>
+	</key>
+	<key name="FeltTemperatureK" type="DOUBLE">
+	  <doc>
+The felt temperature in Kelvin.
+	  </doc>
+	</key>
+	<key name="DewPoint" type="DOUBLE">
+	  <doc>
+The dew point as a localized string, analogous to Temperature.
+	  </doc>
+	</key>
+	<key name="DewPointK" type="DOUBLE">
+	  <doc>
+The dew point in Kelvin.
+	  </doc>
+	</key>
+	<key name="Pressure" type="DOUBLE">
+	  <doc>
+The atmospheric pressure in milli bar.
+	  </doc>
+	</key>
+	<key name="Precipitation" type="DOUBLE">
+	  <doc>
+The rain or snow fall in millimeter per square meter per hour (or some
+other more common unit).
+	  </doc>
+	</key>
+	<key name="Visibility" type="DOUBLE">
+	  <doc>
+The visibility in meter.
+	  </doc>
+	</key>
+	<key name="WindSpeed" type="DOUBLE">
+	  <doc>
+The wind speed in meters per second.
+	  </doc>
+	</key>
+	<key name="WindDirection" type="STRING">
+	  <doc>
+The wind direction as a localized string.  The direction is given in
+compass terms: North, South-West, etc.
+	  </doc>
+	</key>
+	<key name="WindDirectionD" type="INT">
+	  <doc>
+The wind direction in degrees.  North is 0, east is 90, etc.
+	  </doc>
+	</key>
+      </node> 
     </node>
   </node>
 </properties>