Annotation of cci/usr/src/man/man1/man.1, revision 1.1.1.1

1.1       root        1: .TH MAN 1 "18 January 1983"
                      2: .UC 4
                      3: .SH NAME
                      4: man \- find manual information by keywords; print out the manual
                      5: .SH SYNOPSIS
                      6: .br
                      7: .B man
                      8: .B \-k
                      9: keyword ...
                     10: .br
                     11: .B man
                     12: .B \-f
                     13: file ...
                     14: .br
                     15: .B man
                     16: [
                     17: .B \-
                     18: ] [
                     19: .B \-t
                     20: ] [
                     21: section
                     22: ]
                     23: title ...
                     24: .SH DESCRIPTION
                     25: .I Man
                     26: is a program which gives information from the programmers manual.
                     27: It can be asked for one line descriptions of commands specified by
                     28: name, or for all commands whose description contains any of a set of
                     29: keywords.  It can also provide on-line access to the sections of the
                     30: printed manual.
                     31: .PP
                     32: When given the option
                     33: .B \-k
                     34: and a set of keywords,
                     35: .I man
                     36: prints out a one line synopsis of each manual sections whose
                     37: listing in the table of contents contains that keyword.
                     38: .PP
                     39: When given the option
                     40: .B \-f
                     41: and a list of file names, \fIman\fR attempts to locate manual
                     42: sections related to those files, printing out the table of contents
                     43: lines for those sections.
                     44: .PP
                     45: When neither
                     46: .B \-k
                     47: nor
                     48: .B \-f
                     49: is specified,
                     50: .I man
                     51: formats a specified set of manual pages.
                     52: If a section specifier is given
                     53: .I man
                     54: looks in the that section of the manual for the given
                     55: .I titles.
                     56: .I Section
                     57: is an Arabic section number (3 for instance).  The number may followed by
                     58: a single letter classifier (1g for instance)
                     59: indicating a graphics program in section 1.  If
                     60: .I section
                     61: is omitted,
                     62: .I man
                     63: searches all sections of the manual, giving preference to commands
                     64: over subroutines in system libraries, and printing the first section
                     65: it finds, if any.
                     66: .PP
                     67: If the standard output is a teletype, or if the flag
                     68: .B \-
                     69: is given,
                     70: .I man
                     71: pipes its output through
                     72: .IR cat (1)
                     73: with the option
                     74: .B \-s
                     75: to crush out useless blank lines,
                     76: .IR ul (1)
                     77: to create proper underlines for different terminals, and through
                     78: .IR more (1)
                     79: to stop after each page on the screen.
                     80: Hit a space to continue,
                     81: a control-D to scroll 11 more lines when the output stops.
                     82: .PP
                     83: The
                     84: .B \-t
                     85: flag causes
                     86: .I man
                     87: to arrange for the specified section to be
                     88: .I troff'ed
                     89: to a suitable raster output device; see
                     90: .IR vtroff (1).
                     91: .SH FILES
                     92: /usr/man/man?/*
                     93: .br
                     94: /usr/man/cat?/*
                     95: .SH SEE\ ALSO
                     96: more(1), ul(1), whereis(1), catman(8)
                     97: .SH BUGS
                     98: The manual is supposed to be reproducible either on the phototypesetter
                     99: or on a typewriter.
                    100: However, on a typewriter some information is necessarily lost.

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.