locate(1)                        DG/UX R4.11                       locate(1)


NAME
       locate - identify a command using keywords

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

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

       If locate is entered without arguments, the initial locate screen is
       displayed.  A user may enter keywords and receive a list of DG/UX
       system commands whose functional attributes match those in the
       keyword list, or the user may quit and return to the shell by typing
       q.  For example, if you wish to print the contents of a file, enter k
       for keywords then the keywords print and file.  The locate command
       will then print the names of all commands related to the keywords.

       Keywords may also be entered directly from the shell as arguments to
       the locate command (see 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 entering d (description), e (example), or o
       (options).

       From any screen in the Help Facility, a user may execute a command
       via the shell (sh(1)) by typing a ! followed by the command to be
       executed.  The screen will be redrawn if the command that was
       executed was entered at the initial locate screen.  If entered at any
       other menu screen, 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 cleared before printing
       the data (non-scrolling), set the shell environment variable SCROLL
       to no.  If you use the Bourne shell, sh(1), do this by adding the
       following line to your .profile file (see profile(4)):

          SCROLL=no ; export SCROLL

       If you use the C shell, csh(1), do this by adding the following line
       to your .login file:

          setenv SCROLL no

       If you later decide that you want scrolling, set SCROLL to yes
       instead.

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


EXAMPLES
       $ locate

       Prints a menu screen that prompts you to enter a set of keywords
       related to the command you want to find.

       $ locate print file format

       Prints a screen containing a list of DG/UX system commands whose
       functions are related to the keywords print file and format.  It also
       prints a menu that allows you to enter new keywords or request
       detailed information about any command.

SEE ALSO
       glossary(1), help(1), sh(1), csh(1), starter(1), usage(1).
       term(5).

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


Licensed material--property of copyright holder(s)