LOCATE(1-SysV)      RISC/os Reference Manual       LOCATE(1-SysV)



NAME
     locate - identify a UNIX system command using keywords

SYNOPSIS
     [ help ] locate
     [ help ] locate [ keyword1 [ keyword2 ] ... ]

DESCRIPTION
     The locate command is part of the UNIX system Help Facility,
     and provides on-line assistance with identifying UNIX system
     commands.

     Without arguments, the initial locate screen is displayed
     from which the user may enter keywords functionally related
     to the action of the desired UNIX system commands they wish
     to have identified.  A user may enter keywords and receive a
     list of UNIX system commands whose functional attributes
     match those in the keyword list, or may exit to the shell by
     typing q (for "quit").  For example, if you wish to print
     the contents of a file, enter the keywords "print" and
     "file".  The locate command would then print the names of
     all commands related to these keywords.

     Keywords may also be entered directly from the shell, as
     shown above.  In this case, the initial screen is not
     displayed, and the resulting command list is printed.

     More detailed information on a command in the list produced
     by locate can be obtained by accessing the usage module of
     the UNIX system Help Facility.  Access is made by entering
     the appropriate menu choice after the command list is
     displayed.

     From any screen in the Help Facility, a user may execute a
     command via the shell (sh(1)) by typing a ! and the command
     to be executed.  The screen will be redrawn if the command
     that was executed was entered at a first level prompt.  If
     entered at any other prompt level, only the prompt will be
     redrawn.

     By default, the Help Facility scrolls the data that is
     presented to the user.  If you prefer to have the screen
     clear before printing the data (non-scrolling), the shell
     variable SCROLL must be set to no and exported so it will
     become part of your environment.  This is done by adding the
     following line to your .profile file (see profile(4)):
     ``export SCROLL ; SCROLL=no''.  If you later decide that
     scrolling is desired, SCROLL must be set to yes.

     Information on each of the Help Facility commands (starter,
     locate, usage, glossary, and help) is located on their
     respective manual pages.



                         Printed 1/15/91                   Page 1

LOCATE(1-SysV)      RISC/os Reference Manual       LOCATE(1-SysV)



SEE ALSO
     glossary(1), help(1), sh(1), starter(1), usage(1).
     term(5) in the Programmer's Reference Manual.

WARNINGS
     If the shell variable TERM (see sh(1)) is not set in the
     user's .profile file, then TERM will default to the terminal
     value type 450 (a hard-copy terminal).  For a list of valid
     terminal types, refer to term(5).














































 Page 2                  Printed 1/15/91