From 8f61765e0bda304343df0716288766f88ee92f61 Mon Sep 17 00:00:00 2001
From: arnoaugustin <arnoaugustin@2b470e98-0d58-463d-a4d8-8e2adae1ed80>
Date: Mon, 17 Sep 2012 11:03:08 +0000
Subject: [PATCH] SUNRISE_EL update to new functionallity. Added CIVIL, NAUTIC,
 ASTRONOMIC, REAL and HORIZON parameter

git-svn-id: https://fhem.svn.sourceforge.net/svnroot/fhem/trunk/fhem@1857 2b470e98-0d58-463d-a4d8-8e2adae1ed80
---
 docs/commandref.html | 28 ++++++++++++++++++++++++----
 1 file changed, 24 insertions(+), 4 deletions(-)

diff --git a/docs/commandref.html b/docs/commandref.html
index 3fc1c00eb..1ebc3f5c9 100644
--- a/docs/commandref.html
+++ b/docs/commandref.html
@@ -11050,7 +11050,7 @@ isday</pre>
   values, which should be in the form of a floating point value).  The default
   value is Frankfurt am Main, Germany.
   <br><br>
-  The default altitude ($altit in SUNRISE_EL.pm) defines the sunrise/sunset
+  The default altitude ($defaultaltit in SUNRISE_EL.pm) defines the sunrise/sunset
   for Civil twilight (i.e. one can no longer read outside without artificial
   illumination), which differs from sunrise/sunset times found on different
   websites.  See perldoc "DateTime::Event::Sunrise" for alternatives.
@@ -11071,11 +11071,31 @@ isday</pre>
     <li>The second and third specify min and max values (format: "HH:MM").
   </ul>
   <br>
-
   isday() can be used in some notify or at commands to check if the sun is up or
-  down.
-  <br><br>
+  down.<br><br>
 
+  Optionally, for all functions you can set first argument which defines a horizon value
+  which then is used instead of the $defaultaltit in SUNRISE_EL.pm.<br>
+  Possible values are: "REAL", "CIVIL", "NAUTIC", "ASTRONOMIC" or a 
+  positive or negative number preceded by "HORIZON"<br>
+  REAL is 0, CIVIL is -6, NATUIC is -12, ASTRONOMIC is -18 degrees above horizon.<br><br>
+  Example:<br>
+  <ul>
+  <PRE>
+    # When sun is 6 degrees below horizon - same as sunrise();
+    sunrise("CIVIL");
+
+    # When sun is 3 degrees below (-3 above) horizon (Between real and civil sunset)
+    sunset("HORIZON -3");
+
+    # When sun is 1 degree above horizon
+    sunset("HORIZON 1");
+
+    # Switch lamp1 on at real sunset, not before 18:00 and not after 21:00
+    define a15 at *{sunset("REAL",0,"18:00","21:00")} set lamp1 on
+  </PRE>
+  </ul>
+  
   <b>Define</b> <ul>N/A</ul><br>
 
   <b>Set</b> <ul>N/A</ul><br>