Improved windows library header file comments.

[plomrogue] / src / misc.h

diff --git a/src/misc.h b/src/misc.h
index 39efe6ac0ef64032b78a82b14889810e34862e2d..259a511e124596bc6398c78a15493cfbf609f993 100644 (file)
--- a/src/misc.h
+++ b/src/misc.h
@@ -54,8 +54,11 @@ extern void save_game(struct World * world);
 
 
 
-/* Toggle display of a window "win". */
-extern void toggle_window(struct WinMeta * win_meta, struct Win * win);
+/* Toggle display of a window "win".
+ *
+ * Return 0 on success, 1 on (ncurses pad/window memory allocation) error.
+ */
+extern uint8_t toggle_window(struct WinMeta * win_meta, struct Win * win);
 
 
 
@@ -70,8 +73,10 @@ extern void scroll_pad(struct WinMeta * win_meta, char dir);
 /* Try to grow or shrink the active window horizontally ("change" = "*"/"_") or
  * vertically ("change = "+"/"-") by one cell size, subject to the limitations
  * provided by the window manager via resize_active_win().
+ *
+ * Return 0 on success, 1 on (ncurses pad/window memory allocation) error.
  */
-extern void growshrink_active_window(struct WinMeta * win_meta, char change);
+extern uint8_t growshrink_active_window(struct WinMeta * win_meta, char change);