Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ locate(1) — DG/UX 4.00

Media Vault

Software Library

Restoration Projects

Artifacts Sought



                                                                locate(1)



        _________________________________________________________________
        locate                                                    Command
        identify a DG/UX system command using keywords
        _________________________________________________________________


        SYNTAX

        [ 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 may return to the shell by typing q (for
        "quit").  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 would 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 ! and 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), the shell environment variable
        SCROLL must be set to no.  This is done in the Bourne shell,
        sh(1), by adding the following line to your .profile file (see
        profile(4)):  "SCROLL=no ; export SCROLL".  In the csh(1), add
        the following line to your .login file: "setenv SCROLL no".  If
        you later decide that scrolling is desired, SCROLL must be set to
        yes.



        DG/UX 4.00                                                 Page 1
               Licensed material--property of copyright holder(s)





                                                                locate(1)



        Information on each of the Help Facility commands (starter,
        locate, usage, glossary, and help) is located on 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, 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).
















        DG/UX 4.00                                                 Page 2
               Licensed material--property of copyright holder(s)



Typewritten Software • bear@typewritten.org • Edmonds, WA 98026