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

1.1     ! root        1: .TH WHEREIS 1 "24 February 1979"
        !             2: .UC
        !             3: .SH NAME
        !             4: whereis \- locate source, binary, and or manual for program
        !             5: .SH SYNOPSIS
        !             6: .B whereis
        !             7: [
        !             8: .B \-sbm
        !             9: ] [
        !            10: .B \-u
        !            11: ] [
        !            12: .B \-SBM
        !            13: dir ...
        !            14: .B \-f
        !            15: ] name ...
        !            16: .SH DESCRIPTION
        !            17: .I Whereis
        !            18: locates source/binary and manuals sections for specified files.
        !            19: The supplied names are first stripped of leading pathname components
        !            20: and any (single) trailing extension of the form ``.ext'', e.g. ``.c''.
        !            21: Prefixes of ``s.'' resulting from use of source code control are also
        !            22: dealt with.
        !            23: .I Whereis
        !            24: then attempts to locate the desired program in a list of standard places.
        !            25: If any of the
        !            26: .B \-b,
        !            27: .B \-s
        !            28: or
        !            29: .B \-m
        !            30: flags are given then
        !            31: .I whereis
        !            32: searches only for binaries, sources or manual sections respectively
        !            33: (or any two thereof).
        !            34: The
        !            35: .B \-u
        !            36: flag may be used to search for unusual entries.
        !            37: A file is said to be unusual if it does not have one entry of
        !            38: each requested type.
        !            39: Thus ``whereis -m -u *'' asks for those files in the current
        !            40: directory which have no documentation.
        !            41: .sp
        !            42: Finally, the
        !            43: .B \-B
        !            44: .B \-M
        !            45: and
        !            46: .B \-S
        !            47: flags may be used to change or otherwise limit the places where
        !            48: .I whereis
        !            49: searches.
        !            50: The
        !            51: .B \-f
        !            52: file flags is used to terminate the last such directory list
        !            53: and signal the start of file names.
        !            54: .SH EXAMPLE
        !            55: The following finds all the files in /usr/bin which are not documented
        !            56: in /usr/man/man1 with source in /usr/src/cmd:
        !            57: .IP
        !            58: cd /usr/ucb
        !            59: .br
        !            60: whereis \-u \-M /usr/man/man1 \-S /usr/src/cmd \-f *
        !            61: .SH FILES
        !            62: /usr/src/*
        !            63: .br
        !            64: /usr/{doc,man}/*
        !            65: .br
        !            66: /lib, /etc, /usr/{lib,bin,ucb,old,new,local}
        !            67: .SH AUTHOR
        !            68: William Joy
        !            69: .SH BUGS
        !            70: Since the program uses
        !            71: .IR chdir (2)
        !            72: to run faster, pathnames given with the
        !            73: .B \-M
        !            74: .B \-S
        !            75: and
        !            76: .B \-B
        !            77: must be full; i.e. they must begin with a ``/''.

unix.superglobalmegacorp.com

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