[ACR-296] Update tutorial for alarm
authorInkyun Kil <inkyun.kil@samsung.com>
Tue, 23 Jun 2015 02:39:18 +0000 (11:39 +0900)
committerInkyun Kil <inkyun.kil@samsung.com>
Tue, 23 Jun 2015 02:39:18 +0000 (11:39 +0900)
Change-Id: If035521ae046b3a78cf5e476437d8575f36b3a3c
Signed-off-by: Inkyun Kil <inkyun.kil@samsung.com>
org.tizen.tutorials/html/native/app_framework/application_tutorial_n.htm

index 9b6e3a2..c65680a 100644 (file)
@@ -398,6 +398,17 @@ if (ret != APP_CONTROL_ERROR_NONE)
 
 <h2 id="scenario_1" name="scenario_1">Setting an Alarm after Specific Time</h2>
 
+   <table class="note">
+    <tbody>
+     <tr>
+      <th class="note">Note</th>
+     </tr>
+     <tr>
+      <td class="note">Since 2.4, <span style="font-family: Courier New,Courier,monospace">alarm_schedule_after_delay()</span> method does not support exact period and delay for minimizing the wakeups of the device. The system can adjust when the alarm expires.</td>
+     </tr>
+    </tbody>
+   </table>
+
 <p>To set an alarm after a specific time:</p>
 
 <ol>
@@ -429,8 +440,8 @@ bool init_alarm()
        <p>To schedule an alarm after a delay, the function requires 4 parameters:</p>
   <ul>
        <li>[in] <span style="font-family: Courier New,Courier,monospace">app_control</span>: The destination <span style="font-family: Courier New,Courier,monospace">app_control</span> to perform the specific work when the alarm is triggered</li> 
-       <li>[in] <span style="font-family: Courier New,Courier,monospace">delay</span>: The amount of time before the first execution (in seconds) </li>
-       <li>[in] <span style="font-family: Courier New,Courier,monospace">period</span>: The amount of time before a subsequent alarm (in seconds). If set to 0, there is only 1 execution.</li>
+       <li>[in] <span style="font-family: Courier New,Courier,monospace">delay</span>: The amount of time before the first execution (in seconds) Since 2.4, Although this is inexact, the alarm will not fire before this time</li>
+       <li>[in] <span style="font-family: Courier New,Courier,monospace">period</span>: The amount of time before a subsequent alarm (in seconds). Since 2.4, This value does not guarantee the accuracy. The actual interval is calculated by the OS. The minimum value is 600sec.</li>
        <li>[out] <span style="font-family: Courier New,Courier,monospace">alarm_id</span> The alarm ID that uniquely identifies an alarm</li>
   </ul>
 
@@ -531,6 +542,18 @@ date.tm_sec+=4;
 ret = alarm_schedule_at_date(app, &amp;date, 0, &amp;alarm_id);        
 </pre>
 
+
+   <table class="note">
+    <tbody>
+     <tr>
+      <th class="note">Note</th>
+     </tr>
+     <tr>
+      <td class="note">The <span style="font-family: Courier New,Courier,monospace">alarm_schedule_at_date()</span> method has been deprecated since Tizen 2.4. Use the <span style="font-family: Courier New,Courier,monospace">alarm_schedule_once_at_date()</span> method instead.</td>
+     </tr>
+    </tbody>
+   </table>
+
 <h2 id="scenario_3" name="scenario_3">Setting a Recurring Alarm at a Specific Time of the Day</h2>