/* help.c - Show help for toybox commands * * Copyright 2007 Rob Landley * * Often a shell builtin. USE_HELP(NEWTOY(help, "ahu", TOYFLAG_BIN|TOYFLAG_MAYFORK)) config HELP bool "help" default y depends on TOYBOX_HELP help usage: help [-ahu] [COMMAND] -a All commands -u Usage only -h HTML output Show usage information for toybox commands. Run "toybox" with no arguments for a list of available commands. */ #define FOR_help #include "toys.h" static void do_help(struct toy_list *t) { if (FLAG(h)) xprintf("

%s

\n", t->name, t->name);

  toys.which = t;
  show_help(stdout, HELP_USAGE*FLAG(u) + (HELP_SEE|HELP_HTML)*FLAG(h));

  if (FLAG(h)) xprintf("

\n"); } // Simple help is just toys.which = toy_find("name"); show_help(stdout, 0); // but iterating through html output and all commands is a bit more void help_main(void) { long i; // If called with no arguments as a builtin from the shell, show all builtins if (toys.rebound && !*toys.optargs && !toys.optflags) { for (i = 0; i < toys.toycount; i++) { if (!(toy_list[i].flags&(TOYFLAG_NOFORK|TOYFLAG_MAYFORK))) continue; toys.which = toy_list+i; show_help(stdout, HELP_SEE|HELP_USAGE*!toys.optflags); } return; } if (!FLAG(a)) { struct toy_list *t = toys.which, *tt; // Zero which to include "toybox" in search, put it back for error msg toys.which = 0; tt = *toys.optargs ? toy_find(*toys.optargs) : t; toys.which = t; if (tt) return do_help(tt); else error_exit("Unknown command '%s'", *toys.optargs); } if (FLAG(h)) { sprintf(toybuf, "Toybox %s command help", toybox_version); xprintf("\n%s\n\n

%s

", toybuf, toybuf); for (i = 0; i%s\n", toy_list[i].name,toy_list[i].name); xprintf("

\n"); } for (i = 0; i < toys.toycount; i++) { if (!toy_list[i].flags) continue; if (FLAG(h)) xprintf("

\n");
    else if (!FLAG(u)) {
      memset(toybuf, '-', 78);
      memcpy(toybuf+3, toy_list[i].name, strlen(toy_list[i].name));
      printf("\n%s\n\n", toybuf);
    }
    do_help(toy_list+i);
    if (FLAG(h)) xprintf("

\n"); } if (FLAG(h)) xprintf(""); }