maemo.org Bugzilla – Full Text Bug Listing
|Summary:||libalarm API reference lacks details on time fields|
|Product:||[Documentation] API Documents||Reporter:||Tapio Nieminen <tapiono>|
|Component:||SDK repositories||Assignee:||Marcell Lengyel <marcell>|
|Status:||VERIFIED FIXED||QA Contact:||documentation <documentation>|
|Priority:||Low||CC:||andre_klapper, dneary, soumya.3.bijjal|
Copypaste from https://bugs.maemo.org/show_bug.cgi?id=6313: Andre Klapper wrote: > time(¤t_time); > alarm_time = localtime(¤t_time); > alarm_time->tm_sec += 2; > event->alarm_tm = *alarm_time; > > The alarm is set 2 secs in to the future, however alarmd will > round up the triggering time to the next full minute. > > If one really wants to specify triggering time with one second > accuracy, then the event->alarm_time field can be used: > event->alarm_time = time(0) + 2; > > Note: if alarm_time field is used, then the triggering time will > not be adjusted when timezone changes. > > But if I'm not wrong these details are missing from the alarm api > documentation? >
Maemo SDK project manager is responsible of publishing Maemo API documents because they are generated form Maemo SDK rootstrap sources. Reassigning this to Soumya Bijjal.
I am no longer involved in Fremantle SDK. Moving to Marcell who is now the project manager.
Ok, so where should this triggering accuracy be documented? In the API reference (generated from the code: http://maemo.org/api_refs/5.0/5.0-final/libalarm/ ) or the Developer Guide (http://wiki.maemo.org/Documentation/Maemo_5_Developer_Guide/Using_Generic_Platform_Components/Alarm_Framework) or both?
(In reply to comment #3) > Ok, so where should this triggering accuracy be documented? In the API > reference (generated from the code: > http://maemo.org/api_refs/5.0/5.0-final/libalarm/ ) or the Developer Guide > (http://wiki.maemo.org/Documentation/Maemo_5_Developer_Guide/Using_Generic_Platform_Components/Alarm_Framework) > or both? > Both, but I already added a notebox to the Developer Guide (feel free to change it), so only API reference is missing the info.
I have reported this internall to the team responsible for the alarmd component.
(In reply to comment #5) > I have reported this internall to the team responsible for the alarmd > component. > Fixed internally, will be released in PR1.2
Fixed internally. Fix will be included for the next public update.
[Rearrangement of Documentation bug reports.] Mass-moving old closed Developer Platform > Documentation tickets. You can filter bugmail by searching for this comment.