[PATCH 8/8] lib: fwts_wakealarm.c: add more comments

[Keng-Yu Lin]

On Fri, May 25, 2012 at 6:40 PM, Colin King <colin.king at canonical.com> wrote:
> From: Colin Ian King <colin.king at canonical.com>
>
> Signed-off-by: Colin Ian King <colin.king at canonical.com>
> ---
>  src/lib/src/fwts_wakealarm.c |   14 ++++++++++++++
>  1 file changed, 14 insertions(+)
>
> diff --git a/src/lib/src/fwts_wakealarm.c b/src/lib/src/fwts_wakealarm.c
> index f830717..56d4317 100644
> --- a/src/lib/src/fwts_wakealarm.c
> +++ b/src/lib/src/fwts_wakealarm.c
> @@ -27,6 +27,11 @@
>
>  static char *fwts_wkalarm = "/sys/class/rtc/rtc0/wakealarm";
>
> +/*
> + *  fwts_wakealarm_get_irq_state()
> + *     get wakealarm IRQ state.  checks if alarm_IRQ exists and if
> + *     it is set.
> + */
>  int fwts_wakealarm_get_irq_state(void)
>  {
>        FILE *fp;
> @@ -47,6 +52,10 @@ int fwts_wakealarm_get_irq_state(void)
>        return FWTS_ERROR;
>  }
>
> +/*
> + *  fwts_wakealarm_trigger()
> + *     trigger the RTC wakealarm to fire in 'seconds' seconds from now.
> + */
>  int fwts_wakealarm_trigger(fwts_framework *fw, const int seconds)
>  {
>        char buffer[32];
> @@ -72,6 +81,11 @@ int fwts_wakealarm_trigger(fwts_framework *fw, const int seconds)
>        return FWTS_OK;
>  }
>
> +/*
> + *  fwts_wakealarm_test_firing()
> + *     test RTC wakealarm trigger and firing from 'seconds' seconds time
> + *     from now.  returns FWTS_OK if passed, otherwise FWTS_ERROR.
> + */
>  int fwts_wakealarm_test_firing(fwts_framework *fw, const int seconds)
>  {
>        int ret;
> --
> 1.7.10
>
Acked-by: Keng-Yu Lin <kengyu at canonical.com>