diff options
author | Rob Landley <rob@landley.net> | 2019-04-26 18:50:09 -0500 |
---|---|---|
committer | Rob Landley <rob@landley.net> | 2019-04-26 18:50:09 -0500 |
commit | fc7e28de64a3a485425034e4cc4aff2b781450cd (patch) | |
tree | 6434c711b81704255d965449d6627489777c14a5 /toys/pending | |
parent | 663bf3c0c7e9590c183ed00c68964d28cadad8a7 (diff) | |
download | toybox-fc7e28de64a3a485425034e4cc4aff2b781450cd.tar.gz |
Read .gz/.xz man pages and check sections in "man man" order.
Diffstat (limited to 'toys/pending')
-rw-r--r-- | toys/pending/man.c | 98 |
1 files changed, 69 insertions, 29 deletions
diff --git a/toys/pending/man.c b/toys/pending/man.c index 912be8b5..1ccae72f 100644 --- a/toys/pending/man.c +++ b/toys/pending/man.c @@ -4,15 +4,26 @@ * * See http://pubs.opengroup.org/onlinepubs/9699919799/utilities/man.html -USE_MAN(NEWTOY(man, "<1>1", TOYFLAG_USR|TOYFLAG_BIN)) +USE_MAN(NEWTOY(man, "<1>2k:", TOYFLAG_USR|TOYFLAG_BIN)) config MAN bool "man" default n help - usage: man COMMAND + usage: man [-k STRING] | [SECTION] COMMAND - Read manual for system command. + Read manual page for system command. + + -k Search short + + Man pages are divided into 8 sections, each with an info page (man 8 info). + 1) executables, 2) syscalls, 3) library functions, 4) /dev files, + 5) file formats (ala /etc/hosts), 6) games, 7) miscelanous, 8) sysadmin + + If you don't specify a section it'll show the lowest numbered one, + but "man 1 mkdir" and "man 2 mkdir" are different things. + + The shell builtins don't have section 1 man pages, see the "help" command. */ #define FOR_man @@ -20,6 +31,8 @@ config MAN #include <glob.h> GLOBALS( + char *k; + char any, cell, *f, *line; ) @@ -29,6 +42,7 @@ static void newln() if (TT.any && TT.cell != 2) putchar('\n'); // gawk alias TT.any = TT.cell = 0; } + static void put(char *x) { while (*x && *x != '\n') TT.any = putchar(*x++); @@ -59,6 +73,7 @@ static void do_man(FILE *fp) { size_t len = 0; char *line = 0; + while (getline(&line, &len, fp) > 0) { TT.line = line; s("\\fB", ""), s("\\fI", ""), s("\\fP", ""), s("\\fR", ""); // bash bold,ita @@ -68,9 +83,11 @@ static void do_man(FILE *fp) s("\\&", ""), s("\\f(CW", ""); // gawk,rsync fancy s("\\-", "-"), s("\\(", ""), s("\\^", ""), s("\\e", "\\"); // bash escape s("\\*(", "#"); // gawk var + if (start(".BR")) trim(".BR "), s(" ", ""); // bash boldpunct if (start(".IP")) newln(), trim(".IP "); // bash list if (start(".IR")) trim(".IR "), s(" ", ""); // bash itapunct + trim(".B "); // bash bold trim(".BI "); // gawk boldita trim(".FN "); // bash filename @@ -84,42 +101,65 @@ static void do_man(FILE *fp) else if (start(".TP")) newln(), TT.cell = 1; // bash table else if (start(".") || start("\'")); // bash,git garbage else if (!*TT.line); // emerge - else ((TT.cell != 0) && TT.cell++), put(" "), put(TT.line); + else { + if (TT.cell) TT.cell++; + put(" "); + put(TT.line); + } } newln(); free(line); fclose(fp); } -static FILE *bzcat() +// Try opening all the possible file extensions. +int tryfile(char *section, char *name) { - char cmd[FILENAME_MAX]; - snprintf(cmd, sizeof(cmd), "bzcat %s", TT.f); - return popen(cmd, "r"); -} + char *suf[] = {".gz", ".bz2", ".xz", ""}, *end, + *s = xmprintf("/usr/share/man/man%s/%s.%s.bz2", section, name, section); + int fd, i, and = 1; -static char *find(char *path, int suf) -{ - glob_t g; - int i; - size_t len = strlen(*toys.optargs); - char *name; - glob(path, 0, 0, &g); - for (i = 0; !TT.f && i < g.gl_pathc; i++) { - name = basename(g.gl_pathv[i]); - if (strlen(name) == len + suf && !strncmp(name, *toys.optargs, len)) - TT.f = strdup(g.gl_pathv[i]); - } - globfree(&g); - return TT.f; + end = s+strlen(s); + do { + for (i = 0; i<ARRAY_LEN(suf); i++) { + strcpy(end-4, suf[i]); + if ((fd = open(s, O_RDONLY))!= -1) { + if (*suf[i]) { + int fds[] = {fd, -1}; + + sprintf(toybuf, "%czcat"+(2*!i), suf[i][1]); + xpopen_both((char *[]){toybuf, s, 0}, fds); + fd = fds[1]; + } + goto done; + } + } + end -= strlen(section)+1; + } while (and--); + +done: + free(s); + return fd; } void man_main(void) { - chdir("/usr/share/man"); - if (find("man?/*.?.bz2", 6)) do_man(bzcat()); // curl_strequal - else if (find("man?/*.bz2", 4)) do_man(bzcat()); // curl_strequal.3 - else if (find("man?/*.?", 2)) do_man(fopen(TT.f, "r")); // curl_strnequal - else if (find("man?/*", 0)) do_man(fopen(TT.f, "r")); // curl_strnequal.3 - if (TT.f) free(TT.f); + char *order = "18325467"; + int fd; + + if (!toys.optc || FLAG(k)) error_exit("not yet"); + + if (toys.optc == 1) { + if (strchr(*toys.optargs, '/')) fd = xopen(*toys.optargs, O_RDONLY); + else for (order = "18325467"; *order; order++) { + *toybuf = *order; + if (-1 != (fd = tryfile(toybuf, *toys.optargs))) break; + } + if (!*order) error_exit("no %s", *toys.optargs); + + // If they specified a section, look for file in that section + } else if (-1 == (fd = tryfile(toys.optargs[0], toys.optargs[1]))) + error_exit("section %s no %s", toys.optargs[0], toys.optargs[1]); + + do_man(fdopen(fd, "r")); } |