Clean up power button module

No functional changes

BUG=chrome-os-partner:15579
BRANCH=none
TEST=boot system, power off with power button, power on with power button

Change-Id: I25aa5c527b7b9f9db6f5c539cecb37ac4bc197f8
Signed-off-by: Randall Spangler <rspangler@chromium.org>
Reviewed-on: https://gerrit.chromium.org/gerrit/36820
Reviewed-by: Simon Glass <sjg@chromium.org>

1 files changed, 14 insertions, 8 deletions

diff --git a/include/power_button.h b/include/power_button.h
index bc80bfb54c..12919acf7b 100644
--- a/include/power_button.h
+++ b/include/power_button.h
@@ -11,21 +11,27 @@
 #include "common.h"
 #include "gpio.h"
 
-/*
- * Interrupt handler for the power button and lid switch.  Passed the signal
- * which triggered the interrupt.
+/**
+ * Interrupt handler for the power button and lid switch.
+ *
+ * @param signal	Signal which triggered the interrupt.
  */
 void power_button_interrupt(enum gpio_signal signal);
 
-/* Power button task */
+/**
+ * Power button task.
+ */
 void power_button_task(void);
 
-/* Return non-zero if AC power is present. */
+/**
+ * Return non-zero if AC power is present.
+ */
 int power_ac_present(void);
 
-/*
- * Return non-zero if lid is open.  Uses the debounced lid state, not the raw
- * signal from the GPIO.
+/**
+ * Return non-zero if lid is open.
+ *
+ * Uses the debounced lid state, not the raw signal from the GPIO.
  */
 int power_lid_open_debounced(void);