-#ifndef CON_UTILS_H
+/*
+ * (C) Copyright 2014 Leo C. <erbl259-lmu@yahoo.de>
+ *
+ * SPDX-License-Identifier: GPL-2.0+
+ */
+
+/*
+ * Console utilities
+ */
+
+#ifndef CON_UTILS_H
#define CON_UTILS_H
uint_fast8_t tstc(void);
-int my_getchar(void);
+int my_getchar(uint_fast8_t waitforchar);
-/* test if ctrl-c was pressed */
+/* Test if ctrl-c was pressed */
uint_fast8_t ctrlc(void);
-
-/* pass 1 to disable ctrlc() checking, 0 to enable.
- * returns previous state
- */
+/* Pass 1 to disable ctrlc() checking, 0 to enable. Returns previous state. */
uint_fast8_t disable_ctrlc(uint_fast8_t disable);
uint_fast8_t had_ctrlc (void);
void clear_ctrlc(void);
-#endif /* CON_UTILS_H */
-
+/* Reads user's confirmation. Returns 1 if user's input is "y", "Y", "yes" or "YES" */
+uint_fast8_t confirm_yes(void);
+#endif /* CON_UTILS_H */