ui/ncurses: Add support for help screens

Add a textscreen-based help screen system, triggered from the cui
module's cui_show_help()

Signed-off-by: Jeremy Kerr <jk@ozlabs.org>

5 files changed, 127 insertions, 0 deletions

diff --git a/ui/ncurses/Makefile.am b/ui/ncurses/Makefile.am
index c03bdb7..8160298 100644
--- a/ui/ncurses/Makefile.am
+++ b/ui/ncurses/Makefile.am
@@ -35,6 +35,8 @@ libpbnc_la_SOURCES = \
 	nc-cui.h \
 	nc-boot-editor.c \
 	nc-boot-editor.h \
+	nc-helpscreen.c \
+	nc-helpscreen.h \
 	nc-menu.c \
 	nc-menu.h \
 	nc-scr.c \
diff --git a/ui/ncurses/nc-cui.c b/ui/ncurses/nc-cui.c
index e342273..650e903 100644
--- a/ui/ncurses/nc-cui.c
+++ b/ui/ncurses/nc-cui.c
@@ -38,6 +38,7 @@
 #include "nc-boot-editor.h"
 #include "nc-config.h"
 #include "nc-sysinfo.h"
+#include "nc-helpscreen.h"
 
 static void cui_start(void)
 {
@@ -246,6 +247,28 @@ void cui_show_config(struct cui *cui)
 	cui_set_current(cui, config_screen_scr(cui->config_screen));
 }
 
+static void cui_help_exit(struct cui *cui)
+{
+	cui_set_current(cui, help_screen_return_scr(cui->help_screen));
+	talloc_free(cui->help_screen);
+	cui->help_screen = NULL;
+}
+
+void cui_show_help(struct cui *cui, const char *title, const char *text)
+{
+	if (!cui->current)
+		return;
+
+	if (cui->help_screen)
+		return;
+
+	cui->help_screen = help_screen_init(cui, cui->current,
+			title, text, cui_help_exit);
+
+	if (cui->help_screen)
+		cui_set_current(cui, help_screen_scr(cui->help_screen));
+}
+
 /**
  * cui_set_current - Set the currently active screen and redraw it.
  */
diff --git a/ui/ncurses/nc-cui.h b/ui/ncurses/nc-cui.h
index 90af361..e59a6b6 100644
--- a/ui/ncurses/nc-cui.h
+++ b/ui/ncurses/nc-cui.h
@@ -59,6 +59,7 @@ struct cui {
 	struct config *config;
 	struct config_screen *config_screen;
 	struct boot_editor *boot_editor;
+	struct help_screen *help_screen;
 	struct pjs *pjs;
 	void *platform_info;
 	unsigned int default_item;
@@ -74,6 +75,7 @@ void cui_item_edit(struct pmenu_item *item);
 void cui_item_new(struct pmenu *menu);
 void cui_show_sysinfo(struct cui *cui);
 void cui_show_config(struct cui *cui);
+void cui_show_help(struct cui *cui, const char *title, const char *text);
 int cui_send_config(struct cui *cui, struct config *config);
 
 /* convenience routines */
diff --git a/ui/ncurses/nc-helpscreen.c b/ui/ncurses/nc-helpscreen.c
new file mode 100644
index 0000000..d70a8ec
--- /dev/null
+++ b/ui/ncurses/nc-helpscreen.c
@@ -0,0 +1,69 @@
+/*
+ *  Copyright (C) 2013 IBM Corporation
+ *
+ *  This program is free software; you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation; version 2 of the License.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program; if not, write to the Free Software
+ *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ */
+
+#if defined(HAVE_CONFIG_H)
+#include "config.h"
+#endif
+
+#include <string.h>
+
+#include <talloc/talloc.h>
+#include <types/types.h>
+#include <log/log.h>
+#include <util/util.h>
+
+#include "nc-cui.h"
+#include "nc-textscreen.h"
+#include "nc-helpscreen.h"
+
+struct help_screen {
+	struct text_screen text_scr;
+	struct nc_scr *return_scr;
+};
+
+struct nc_scr *help_screen_scr(struct help_screen *screen)
+{
+	return text_screen_scr(&screen->text_scr);
+}
+
+struct nc_scr *help_screen_return_scr(struct help_screen *screen)
+{
+	return screen->return_scr;
+}
+
+struct help_screen *help_screen_init(struct cui *cui,
+		struct nc_scr *current_scr,
+		const char *title_suffix, const char *text,
+		void (*on_exit)(struct cui *))
+{
+	struct help_screen *screen;
+	const char *title;
+
+	screen = talloc_zero(cui, struct help_screen);
+	screen->return_scr = current_scr;
+
+	title = "Petitboot help";
+	if (title_suffix)
+		title = talloc_asprintf(screen,
+				"Petitboot help: %s", title_suffix);
+
+	text_screen_init(&screen->text_scr, cui, title, on_exit);
+	text_screen_set_text(&screen->text_scr, text);
+	text_screen_draw(&screen->text_scr);
+
+	return screen;
+}
diff --git a/ui/ncurses/nc-helpscreen.h b/ui/ncurses/nc-helpscreen.h
new file mode 100644
index 0000000..f104411
--- /dev/null
+++ b/ui/ncurses/nc-helpscreen.h
@@ -0,0 +1,31 @@
+/*
+ *  Copyright (C) 2013 IBM Corporation
+ *
+ *  This program is free software; you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation; version 2 of the License.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program; if not, write to the Free Software
+ *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ */
+
+#ifndef _NC_HELPSCREEN_H
+#define _NC_HELPSCREEN_H
+
+struct help_screen;
+
+struct nc_scr *help_screen_scr(struct help_screen *screen);
+struct nc_scr *help_screen_return_scr(struct help_screen *screen);
+
+struct help_screen *help_screen_init(struct cui *cui,
+		struct nc_scr *current_scr,
+		const char *title_suffix, const char *text,
+		void (*on_exit)(struct cui *));
+
+#endif /* defined _NC_HELPSCREEN_H */