man.c revision 1.26 1 /* $NetBSD: man.c,v 1.26 2001/02/19 23:03:49 cgd Exp $ */
2
3 /*
4 * Copyright (c) 1987, 1993, 1994, 1995
5 * The Regents of the University of California. All rights reserved.
6 *
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
9 * are met:
10 * 1. Redistributions of source code must retain the above copyright
11 * notice, this list of conditions and the following disclaimer.
12 * 2. Redistributions in binary form must reproduce the above copyright
13 * notice, this list of conditions and the following disclaimer in the
14 * documentation and/or other materials provided with the distribution.
15 * 3. All advertising materials mentioning features or use of this software
16 * must display the following acknowledgement:
17 * This product includes software developed by the University of
18 * California, Berkeley and its contributors.
19 * 4. Neither the name of the University nor the names of its contributors
20 * may be used to endorse or promote products derived from this software
21 * without specific prior written permission.
22 *
23 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
24 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
25 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
26 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
27 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
28 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
29 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
30 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
31 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
32 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
33 * SUCH DAMAGE.
34 */
35
36 #include <sys/cdefs.h>
37
38 #ifndef lint
39 __COPYRIGHT("@(#) Copyright (c) 1987, 1993, 1994, 1995\n\
40 The Regents of the University of California. All rights reserved.\n");
41 #endif /* not lint */
42
43 #ifndef lint
44 #if 0
45 static char sccsid[] = "@(#)man.c 8.17 (Berkeley) 1/31/95";
46 #else
47 __RCSID("$NetBSD: man.c,v 1.26 2001/02/19 23:03:49 cgd Exp $");
48 #endif
49 #endif /* not lint */
50
51 #include <sys/param.h>
52 #include <sys/queue.h>
53 #include <sys/utsname.h>
54
55 #include <ctype.h>
56 #include <err.h>
57 #include <errno.h>
58 #include <fcntl.h>
59 #include <fnmatch.h>
60 #include <glob.h>
61 #include <signal.h>
62 #include <stdio.h>
63 #include <stdlib.h>
64 #include <string.h>
65 #include <unistd.h>
66
67 #include "config.h"
68 #include "pathnames.h"
69
70 int f_all, f_where;
71
72 int main __P((int, char **));
73 static void build_page __P((char *, char **));
74 static void cat __P((char *));
75 static const char *check_pager __P((const char *));
76 static int cleanup __P((void));
77 static void how __P((char *));
78 static void jump __P((char **, char *, char *));
79 static int manual __P((char *, TAG *, glob_t *, const char *));
80 static void onsig __P((int));
81 static void usage __P((void));
82
83 int
84 main(argc, argv)
85 int argc;
86 char *argv[];
87 {
88 TAG *defp, *section, *newpathp, *subp;
89 ENTRY *e_defp, *e_subp;
90 glob_t pg;
91 size_t len;
92 int ch, f_cat, f_how, found, abs_section;
93 char **ap, *cmd, *p, *p_add, *p_path;
94 const char *machine, *pager, *conffile, *pathsearch, *sectionname;
95 char buf[MAXPATHLEN * 2];
96
97 #ifdef __GNUC__
98 pager = NULL; /* XXX gcc -Wuninitialized */
99 #endif
100
101 f_cat = f_how = 0;
102 sectionname = pathsearch = conffile = p_add = p_path = NULL;
103 while ((ch = getopt(argc, argv, "-aC:cfhkM:m:P:s:S:w")) != -1)
104 switch (ch) {
105 case 'a':
106 f_all = 1;
107 break;
108 case 'C':
109 conffile = optarg;
110 break;
111 case 'c':
112 case '-': /* Deprecated. */
113 f_cat = 1;
114 break;
115 case 'h':
116 f_how = 1;
117 break;
118 case 'm':
119 p_add = optarg;
120 break;
121 case 'M':
122 case 'P': /* Backward compatibility. */
123 p_path = strdup(optarg);
124 break;
125 /*
126 * The -f and -k options are backward compatible,
127 * undocumented ways of calling whatis(1) and apropos(1).
128 */
129 case 'f':
130 jump(argv, "-f", "whatis");
131 /* NOTREACHED */
132 case 'k':
133 jump(argv, "-k", "apropos");
134 /* NOTREACHED */
135 case 's':
136 if (sectionname != NULL)
137 usage();
138 sectionname = optarg;
139 break;
140 case 'S':
141 pathsearch = optarg;
142 break;
143 case 'w':
144 f_all = f_where = 1;
145 break;
146 case '?':
147 default:
148 usage();
149 }
150 argc -= optind;
151 argv += optind;
152
153 if (!argc)
154 usage();
155
156 if (!f_cat && !f_how && !f_where) {
157 if (!isatty(STDOUT_FILENO)) {
158 f_cat = 1;
159 } else {
160 if ((pager = getenv("PAGER")) != NULL &&
161 pager[0] != '\0')
162 pager = check_pager(pager);
163 else
164 pager = _PATH_PAGER;
165 }
166 }
167
168 /* Read the configuration file. */
169 config(conffile);
170
171 /* Get the machine type. */
172 if ((machine = getenv("MACHINE")) == NULL) {
173 struct utsname utsname;
174
175 if (uname(&utsname) == -1) {
176 perror("uname");
177 exit(1);
178 }
179 machine = utsname.machine;
180 }
181
182 /* create an empty _default list if the config file didn't have one */
183 if ((defp = getlist("_default")) == NULL)
184 defp = addlist("_default");
185
186 /* if -M wasn't specified, check for MANPATH */
187 if (p_path == NULL)
188 p_path = getenv("MANPATH");
189
190 /*
191 * get section. abs_section will be non-zero iff the user
192 * specified a section and it had absolute (rather than
193 * relative) paths in the man.conf file.
194 */
195 if ((argc > 1 || sectionname != NULL) &&
196 (section = getlist(sectionname ? sectionname : *argv)) != NULL) {
197 if (sectionname == NULL) {
198 argv++;
199 argc--;
200 }
201 abs_section = (TAILQ_FIRST(§ion->list) != NULL &&
202 *(TAILQ_FIRST(§ion->list)->s) == '/');
203 } else {
204 section = NULL;
205 abs_section = 0;
206 }
207
208 /* get subdir list */
209 subp = getlist("_subdir");
210 if (!subp)
211 subp = addlist("_subdir");
212
213 /*
214 * now that we have all the inputs we must generate a search path.
215 */
216
217 /*
218 * 1: If user specified a section and it has absolute paths
219 * in the config file, then that overrides _default, MANPATH and
220 * path passed via -M.
221 */
222 if (abs_section) {
223 p_path = NULL; /* zap -M/MANPATH */
224 defp = section; /* zap _default */
225 section = NULL; /* promoted to defp */
226 }
227
228
229 /*
230 * 2: Section can be non-null only if a section was specified
231 * and the config file has relative paths - the section list
232 * overrides _subdir in this case.
233 */
234 if (section)
235 subp = section;
236
237
238 /*
239 * 3: now we either have text string path (p_path) or a tag
240 * based path (defp). we need to append subp and machine
241 * to each element in the path.
242 *
243 * for backward compat, we do not append subp if abs_section
244 * and the path does not end in "/".
245 */
246 newpathp = addlist("_new_path");
247 if (p_path) {
248 /* use p_path */
249 for (; (p = strtok(p_path, ":")) != NULL; p_path = NULL) {
250 for ( e_subp = TAILQ_FIRST(&subp->list) ;
251 e_subp != NULL ;
252 e_subp = TAILQ_NEXT(e_subp, q)) {
253 snprintf(buf, sizeof(buf), "%s/%s{/%s,}",
254 p, e_subp->s, machine);
255 addentry(newpathp, buf, 0);
256 }
257 }
258 } else {
259 /* use defp rather than p_path */
260 for (e_defp = TAILQ_FIRST(&defp->list) ;
261 e_defp != NULL ;
262 e_defp = TAILQ_NEXT(e_defp, q)) {
263
264 /* handle trailing "/" magic here ... */
265 if (abs_section &&
266 e_defp->s[strlen(e_defp->s) - 1] != '/') {
267
268 (void)snprintf(buf, sizeof(buf),
269 "%s{/%s,}", e_defp->s, machine);
270 addentry(newpathp, buf, 0);
271 continue;
272 }
273
274 for ( e_subp = TAILQ_FIRST(&subp->list) ;
275 e_subp != NULL ;
276 e_subp = TAILQ_NEXT(e_subp, q)) {
277 snprintf(buf, sizeof(buf), "%s%s%s{/%s,}",
278 e_defp->s, (abs_section) ? "" : "/",
279 e_subp->s, machine);
280 addentry(newpathp, buf, 0);
281 }
282 }
283 } /* using defp ... */
284
285 /* now replace the current path with the new one */
286 defp = newpathp;
287
288 /*
289 * 4: prepend the "-m" path, if specified. we always add
290 * subp and machine to this part of the path.
291 */
292
293 if (p_add) {
294 for (p = strtok(p_add, ":") ; p ; p = strtok(NULL, ":")) {
295 for ( e_subp = TAILQ_FIRST(&subp->list) ;
296 e_subp != NULL ;
297 e_subp = TAILQ_NEXT(e_subp, q)) {
298 snprintf(buf, sizeof(buf), "%s/%s{/%s,}",
299 p, e_subp->s, machine);
300 addentry(newpathp, buf, 1);
301 }
302 }
303 }
304
305
306 /*
307 * 5: Search for the files. Set up an interrupt handler, so the
308 * temporary files go away.
309 */
310 (void)signal(SIGINT, onsig);
311 (void)signal(SIGHUP, onsig);
312 (void)signal(SIGPIPE, onsig);
313
314 memset(&pg, 0, sizeof(pg));
315 for (found = 0; *argv; ++argv)
316 if (manual(*argv, defp, &pg, pathsearch))
317 found = 1;
318
319 /* 6: If nothing found, we're done. */
320 if (!found) {
321 (void)cleanup();
322 exit (1);
323 }
324
325 /* 7: If it's simple, display it fast. */
326 if (f_cat) {
327 for (ap = pg.gl_pathv; *ap != NULL; ++ap) {
328 if (**ap == '\0')
329 continue;
330 cat(*ap);
331 }
332 exit (cleanup());
333 }
334 if (f_how) {
335 for (ap = pg.gl_pathv; *ap != NULL; ++ap) {
336 if (**ap == '\0')
337 continue;
338 how(*ap);
339 }
340 exit(cleanup());
341 }
342 if (f_where) {
343 for (ap = pg.gl_pathv; *ap != NULL; ++ap) {
344 if (**ap == '\0')
345 continue;
346 (void)printf("%s\n", *ap);
347 }
348 exit(cleanup());
349 }
350
351 /*
352 * 8: We display things in a single command; build a list of things
353 * to display.
354 */
355 for (ap = pg.gl_pathv, len = strlen(pager) + 1; *ap != NULL; ++ap) {
356 if (**ap == '\0')
357 continue;
358 len += strlen(*ap) + 1;
359 }
360 if ((cmd = malloc(len)) == NULL) {
361 warn("malloc");
362 (void)cleanup();
363 exit(1);
364 }
365 p = cmd;
366 len = strlen(pager);
367 memmove(p, pager, len);
368 p += len;
369 *p++ = ' ';
370 for (ap = pg.gl_pathv; *ap != NULL; ++ap) {
371 if (**ap == '\0')
372 continue;
373 len = strlen(*ap);
374 memmove(p, *ap, len);
375 p += len;
376 *p++ = ' ';
377 }
378 *--p = '\0';
379
380 /* Use system(3) in case someone's pager is "pager arg1 arg2". */
381 (void)system(cmd);
382
383 exit(cleanup());
384 }
385
386 /*
387 * manual --
388 * Search the manuals for the pages.
389 */
390 static int
391 manual(page, tag, pg, pathsearch)
392 char *page;
393 TAG *tag;
394 glob_t *pg;
395 const char *pathsearch;
396 {
397 ENTRY *ep, *e_sufp, *e_tag;
398 TAG *missp, *sufp;
399 int anyfound, cnt, error, found;
400 char *p, buf[MAXPATHLEN];
401
402 anyfound = 0;
403 buf[0] = '*';
404
405 /* For each element in the list... */
406 e_tag = tag == NULL ? NULL : tag->list.tqh_first;
407 for (; e_tag != NULL; e_tag = e_tag->q.tqe_next) {
408 (void)snprintf(buf, sizeof(buf), "%s/%s.*", e_tag->s, page);
409 if ((error = glob(buf,
410 GLOB_APPEND | GLOB_BRACE | GLOB_NOSORT, NULL, pg)) != 0) {
411 if (error == GLOB_NOMATCH)
412 continue;
413 else {
414 warn("globbing");
415 (void)cleanup();
416 exit(1);
417 }
418 }
419 if (pg->gl_matchc == 0)
420 continue;
421
422 /* Find out if it's really a man page. */
423 for (cnt = pg->gl_pathc - pg->gl_matchc;
424 cnt < pg->gl_pathc; ++cnt) {
425
426 if (pathsearch) {
427 p = strstr(pg->gl_pathv[cnt], pathsearch);
428 if (!p || strchr(p, '/') == NULL) {
429 pg->gl_pathv[cnt] = "";
430 continue;
431 }
432 }
433
434 /*
435 * Try the _suffix key words first.
436 *
437 * XXX
438 * Older versions of man.conf didn't have the suffix
439 * key words, it was assumed that everything was a .0.
440 * We just test for .0 first, it's fast and probably
441 * going to hit.
442 */
443 (void)snprintf(buf, sizeof(buf), "*/%s.0", page);
444 if (!fnmatch(buf, pg->gl_pathv[cnt], 0))
445 goto next;
446
447 e_sufp = (sufp = getlist("_suffix")) == NULL ?
448 NULL : sufp->list.tqh_first;
449 for (found = 0;
450 e_sufp != NULL; e_sufp = e_sufp->q.tqe_next) {
451 (void)snprintf(buf,
452 sizeof(buf), "*/%s%s", page, e_sufp->s);
453 if (!fnmatch(buf, pg->gl_pathv[cnt], 0)) {
454 found = 1;
455 break;
456 }
457 }
458 if (found)
459 goto next;
460
461 /* Try the _build key words next. */
462 e_sufp = (sufp = getlist("_build")) == NULL ?
463 NULL : sufp->list.tqh_first;
464 for (found = 0;
465 e_sufp != NULL; e_sufp = e_sufp->q.tqe_next) {
466 for (p = e_sufp->s;
467 *p != '\0' && !isspace((unsigned char)*p); ++p);
468 if (*p == '\0')
469 continue;
470 *p = '\0';
471 (void)snprintf(buf,
472 sizeof(buf), "*/%s%s", page, e_sufp->s);
473 if (!fnmatch(buf, pg->gl_pathv[cnt], 0)) {
474 if (!f_where)
475 build_page(p + 1,
476 &pg->gl_pathv[cnt]);
477 *p = ' ';
478 found = 1;
479 break;
480 }
481 *p = ' ';
482 }
483 if (found) {
484 next: anyfound = 1;
485 if (!f_all) {
486 /* Delete any other matches. */
487 while (++cnt< pg->gl_pathc)
488 pg->gl_pathv[cnt] = "";
489 break;
490 }
491 continue;
492 }
493
494 /* It's not a man page, forget about it. */
495 pg->gl_pathv[cnt] = "";
496 }
497
498 if (anyfound && !f_all)
499 break;
500 }
501
502 /* If not found, enter onto the missing list. */
503 if (!anyfound) {
504 if ((missp = getlist("_missing")) == NULL)
505 missp = addlist("_missing");
506 if ((ep = malloc(sizeof(ENTRY))) == NULL ||
507 (ep->s = strdup(page)) == NULL) {
508 warn("malloc");
509 (void)cleanup();
510 exit(1);
511 }
512 TAILQ_INSERT_TAIL(&missp->list, ep, q);
513 }
514 return (anyfound);
515 }
516
517 /*
518 * build_page --
519 * Build a man page for display.
520 */
521 static void
522 build_page(fmt, pathp)
523 char *fmt, **pathp;
524 {
525 static int warned;
526 ENTRY *ep;
527 TAG *intmpp;
528 int fd, n;
529 char *p, *b;
530 char buf[MAXPATHLEN], cmd[MAXPATHLEN], tpath[MAXPATHLEN];
531 const char *tmpdir;
532
533 /* Let the user know this may take awhile. */
534 if (!warned) {
535 warned = 1;
536 warnx("Formatting manual page...");
537 }
538
539 /*
540 * Historically man chdir'd to the root of the man tree.
541 * This was used in man pages that contained relative ".so"
542 * directives (including other man pages for command aliases etc.)
543 * It even went one step farther, by examining the first line
544 * of the man page and parsing the .so filename so it would
545 * make hard(?) links to the cat'ted man pages for space savings.
546 * (We don't do that here, but we could).
547 */
548
549 /* copy and find the end */
550 for (b = buf, p = *pathp; (*b++ = *p++) != '\0';)
551 continue;
552
553 /* skip the last two path components, page name and man[n] */
554 for (--b, --p, n = 2; b != buf; b--, p--)
555 if (*b == '/')
556 if (--n == 0) {
557 *b = '\0';
558 (void) chdir(buf);
559 p++;
560 break;
561 }
562
563
564 /* Add a remove-when-done list. */
565 if ((intmpp = getlist("_intmp")) == NULL)
566 intmpp = addlist("_intmp");
567
568 /* Move to the printf(3) format string. */
569 for (; *fmt && isspace((unsigned char)*fmt); ++fmt)
570 continue;
571
572 /*
573 * Get a temporary file and build a version of the file
574 * to display. Replace the old file name with the new one.
575 */
576 if ((tmpdir = getenv("TMPDIR")) == NULL)
577 tmpdir = _PATH_TMP;
578 (void)snprintf(tpath, sizeof (tpath), "%s/%s", tmpdir, TMPFILE);
579 if ((fd = mkstemp(tpath)) == -1) {
580 warn("%s", tpath);
581 (void)cleanup();
582 exit(1);
583 }
584 (void)snprintf(buf, sizeof(buf), "%s > %s", fmt, tpath);
585 (void)snprintf(cmd, sizeof(cmd), buf, p);
586 (void)system(cmd);
587 (void)close(fd);
588 if ((*pathp = strdup(tpath)) == NULL) {
589 warn("malloc");
590 (void)cleanup();
591 exit(1);
592 }
593
594 /* Link the built file into the remove-when-done list. */
595 if ((ep = malloc(sizeof(ENTRY))) == NULL) {
596 warn("malloc");
597 (void)cleanup();
598 exit(1);
599 }
600 ep->s = *pathp;
601 TAILQ_INSERT_TAIL(&intmpp->list, ep, q);
602 }
603
604 /*
605 * how --
606 * display how information
607 */
608 static void
609 how(fname)
610 char *fname;
611 {
612 FILE *fp;
613
614 int lcnt, print;
615 char *p, buf[256];
616
617 if (!(fp = fopen(fname, "r"))) {
618 warn("%s", fname);
619 (void)cleanup();
620 exit (1);
621 }
622 #define S1 "SYNOPSIS"
623 #define S2 "S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS"
624 #define D1 "DESCRIPTION"
625 #define D2 "D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN"
626 for (lcnt = print = 0; fgets(buf, sizeof(buf), fp);) {
627 if (!strncmp(buf, S1, sizeof(S1) - 1) ||
628 !strncmp(buf, S2, sizeof(S2) - 1)) {
629 print = 1;
630 continue;
631 } else if (!strncmp(buf, D1, sizeof(D1) - 1) ||
632 !strncmp(buf, D2, sizeof(D2) - 1))
633 return;
634 if (!print)
635 continue;
636 if (*buf == '\n')
637 ++lcnt;
638 else {
639 for(; lcnt; --lcnt)
640 (void)putchar('\n');
641 for (p = buf; isspace((unsigned char)*p); ++p)
642 continue;
643 (void)fputs(p, stdout);
644 }
645 }
646 (void)fclose(fp);
647 }
648
649 /*
650 * cat --
651 * cat out the file
652 */
653 static void
654 cat(fname)
655 char *fname;
656 {
657 int fd, n;
658 char buf[2048];
659
660 if ((fd = open(fname, O_RDONLY, 0)) < 0) {
661 warn("%s", fname);
662 (void)cleanup();
663 exit(1);
664 }
665 while ((n = read(fd, buf, sizeof(buf))) > 0)
666 if (write(STDOUT_FILENO, buf, n) != n) {
667 warn("write");
668 (void)cleanup();
669 exit (1);
670 }
671 if (n == -1) {
672 warn("read");
673 (void)cleanup();
674 exit(1);
675 }
676 (void)close(fd);
677 }
678
679 /*
680 * check_pager --
681 * check the user supplied page information
682 */
683 static const char *
684 check_pager(name)
685 const char *name;
686 {
687 const char *p;
688
689 /*
690 * if the user uses "more", we make it "more -s"; watch out for
691 * PAGER = "mypager /usr/ucb/more"
692 */
693 for (p = name; *p && !isspace((unsigned char)*p); ++p)
694 continue;
695 for (; p > name && *p != '/'; --p);
696 if (p != name)
697 ++p;
698
699 /* make sure it's "more", not "morex" */
700 if (!strncmp(p, "more", 4) && (!p[4] || isspace((unsigned char)p[4]))){
701 char *newname;
702 (void)asprintf(&newname, "%s %s", p, "-s");
703 name = newname;
704 }
705
706 return (name);
707 }
708
709 /*
710 * jump --
711 * strip out flag argument and jump
712 */
713 static void
714 jump(argv, flag, name)
715 char **argv, *flag, *name;
716 {
717 char **arg;
718
719 argv[0] = name;
720 for (arg = argv + 1; *arg; ++arg)
721 if (!strcmp(*arg, flag))
722 break;
723 for (; *arg; ++arg)
724 arg[0] = arg[1];
725 execvp(name, argv);
726 (void)fprintf(stderr, "%s: Command not found.\n", name);
727 exit(1);
728 }
729
730 /*
731 * onsig --
732 * If signaled, delete the temporary files.
733 */
734 static void
735 onsig(signo)
736 int signo;
737 {
738 sigset_t set;
739
740 (void)cleanup();
741
742 (void)signal(signo, SIG_DFL);
743
744 /* unblock the signal */
745 sigemptyset(&set);
746 sigaddset(&set, signo);
747 sigprocmask(SIG_UNBLOCK, &set, (sigset_t *) NULL);
748
749 (void)kill(getpid(), signo);
750
751 /* NOTREACHED */
752 exit (1);
753 }
754
755 /*
756 * cleanup --
757 * Clean up temporary files, show any error messages.
758 */
759 static int
760 cleanup()
761 {
762 TAG *intmpp, *missp;
763 ENTRY *ep;
764 int rval;
765
766 rval = 0;
767 ep = (missp = getlist("_missing")) == NULL ?
768 NULL : missp->list.tqh_first;
769 if (ep != NULL)
770 for (; ep != NULL; ep = ep->q.tqe_next) {
771 warnx("no entry for %s in the manual.", ep->s);
772 rval = 1;
773 }
774
775 ep = (intmpp = getlist("_intmp")) == NULL ?
776 NULL : intmpp->list.tqh_first;
777 for (; ep != NULL; ep = ep->q.tqe_next)
778 (void)unlink(ep->s);
779 return (rval);
780 }
781
782 /*
783 * usage --
784 * print usage message and die
785 */
786 static void
787 usage()
788 {
789
790 (void)fprintf(stderr, "Usage: %s [-achw] [-C file] [-M path] [-m path]"
791 "[-S srch] [[-s] section] title ...\n", getprogname());
792 exit(1);
793 }
794