-/* vi: set sw=4 ts=4:
- *
- * help.c - Show help for toybox
+/* help.c - Show help for toybox commands
*
* Copyright 2007 Rob Landley <rob@landley.net>
*
- * Not in SUSv3, but exists as a bash builtin.
+ * Often a shell builtin.
-USE_HELP(NEWTOY(help, "<1", TOYFLAG_BIN))
+USE_HELP(NEWTOY(help, ""USE_HELP_EXTRAS("ah"), TOYFLAG_BIN))
config HELP
- bool "help"
- default y
- help
- usage: help [command]
+ bool "help"
+ default y
+ depends on TOYBOX_HELP
+ help
+ usage: help [command]
+
+ Show usage information for toybox commands.
+ Run "toybox" with no arguments for a list of available commands.
+
+config HELP_EXTRAS
+ bool "help -ah"
+ default y
+ depends on TOYBOX
+ depends on HELP
+ help
+ usage: help [-ah]
- Show usage information for toybox commands.
- Run "toybox" with no arguments for a list of available commands.
+ -a All commands
+ -h HTML output
*/
-
+#define FOR_help
#include "toys.h"
-#include "generated/help.h"
-#undef NEWTOY
-#undef OLDTOY
-#define NEWTOY(name,opt,flags) help_##name "\0"
-#define OLDTOY(name,oldname,opts,flags) "\xff" #oldname "\0"
-static char *help_data =
-#include "generated/newtoys.h"
-;
+static void do_help(struct toy_list *t)
+{
+ if (toys.optflags & FLAG_h)
+ xprintf("<a name=\"%s\"><h1>%s</h1><blockquote><pre>\n", t->name, t->name);
+
+ toys.which = t;
+ show_help(stdout);
+
+ if (toys.optflags & FLAG_h) xprintf("</blockquote></pre>\n");
+}
+
+// The simple help is just toys.which = toy_find("name"); show_help(stdout);
+// But iterating through html output and all commands is a big more
void help_main(void)
{
- struct toy_list *t = toy_find(*toys.optargs);
- int i = t-toy_list;
- char *s = help_data;
-
- if (!t) error_exit("Unknown command '%s'", *toys.optargs);
- for (;;) {
- while (i--) s += strlen(s) + 1;
- if (*s != 255) break;
- i = toy_find(++s)-toy_list;
- s = help_data;
- }
-
- fprintf(toys.exithelp ? stderr : stdout, "%s", s);
+ int i;
+
+ if (!(toys.optflags & FLAG_a)) {
+ struct toy_list *t = toys.which;
+
+ if (*toys.optargs && !(t = toy_find(*toys.optargs)))
+ error_exit("Unknown command '%s'", *toys.optargs);
+ do_help(t);
+ return;
+ }
+
+ if (toys.optflags & FLAG_h) {
+ xprintf("<html>\n<title>Toybox command list</title>\n<body>\n<p>\n");
+ for (i=0; i < toys.toycount; i++)
+ xprintf("<a href=\"#%s\">%s</a>\n", toy_list[i].name,
+ toy_list[i].name);
+ xprintf("</p>\n");
+ }
+
+ for (i = 0; i < toys.toycount; i++) {
+ if (toys.optflags & FLAG_h) xprintf("<hr>\n<pre>\n");
+ do_help(toy_list+i);
+ if (toys.optflags & FLAG_h) xprintf("</pre>\n");
+ }
+
+ if (toys.optflags & FLAG_h) xprintf("</html>");
}