.TH findprog 1
.SH NAME
findprog \- find program information
.SH SYNTAX
.B findprog
[
.B \-help
] [
.B \-verbose
] [
.B \-terse
] [
.B \-search
.I regexp
] [
.B \-man
.I program name
] [
.I program name...
]
.br
.SH DESCRIPTION
The
.B findprog
command reads a dbm database of program keywords
and information.  If called with no argments, it
starts up in interactive mode.  If any arguments
are given, they are interpreted and run as sequential
commands.
.sp 2
The format of the raw database is decribed in
.B findprog.db(5)
and the dbm files are built with
.B findprog_build(8)
.SH COMMANDS
From the interactive prompt, the following
command description is given if you type `?'
or an empty line:
.RS
.sp 2
.nf
findprog> ?
Typing a program name displays information for
that program.

Other Commands: 

        ?               - print this message
        verbose         - set verbose mode (default)
        terse           - set terse mode
        man prog        - show the man page for the program prog
        search regexp   - display all records matching the
                          perl regular expression regexp.
                          (regexp searches are always
                           terse.)
        quit (or ^D)    - quit program

.fi
.RE
.SH OUTPUT
The
.B verbose
output of findprog looks like this:
.sp 2
.RS
.nf
findprog> rn
Program Name: rn
Description: new read news program
Location: sipb
Comments:  

For more information, read the man page in
the sipb locker as follows:

        athena% add sipb
        athena% man rn
.fi
.RE
.sp 2
The
.B terse
output looks like this:
.sp 2
.RS
.nf
findprog> terse
terse mode set
findprog> rn
rn - new read news program (sipb)
.fi
.RE
.sp 2
Typing
.B man
.I prog
displays the man page
for
.I prog.
.sp 2
The 
.B search
command
allows you
to specify a perl regular expression.  It matches
this expression against the text of the line
in the database, so it matches on descriptions and
comments as well as program names.  It displays
(in terse mode) the list of all matching entries.
.SH FILES
/mit/sipb/lib/@sys/findprog.db     \- raw database
/mit/sipb/lib/@sys/findprog.db.dir \- dbm file
/mti/sipb/lib/@sys/findprog.db.pag \- dbm file
.SH ENVIRONMENT
PAGER \- program to page long output - defaults to more(1)
.SH SEE ALSO
findprog.db(5), dbm_open(3), perl(1), man(1), findprog_build(8)