locate(1)                  DG/UX 4.30                   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



     Licensed material--property of copyright holder(s)         Page 1

     locate(1)                  DG/UX 4.30                   locate(1)



          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) in the Programmer's Reference for the DG/UX System.

     WARNINGS
          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)         Page 2