The Developer Connection…ice Driver Kit for OS/2 3/DEV3-D1.ISO/editors/enved/enved.doc

Text File | 1993-12-09 | 11.9 KB | 570 lines

                                                                EnvE-v110-0






























        ===================================================================
        ENVED
        An Environment Editor
        Version 1.10






















        (C) Copyright IBM Corporation 1987, 1993






        (C) Copyright IBM Corporation 1987, 1993



        -------------------------------------------------------------------
        Version 1.10, December 1993

        This program was written by:

        Tim Baldwin

        IBM UK Laboratories
        Hursley Park
        Winchester
        Hampshire, SO21 2JN

        BALDWINT at WINVMB
        [e-mail]


        (C) Copyright IBM Corporation 1987, 1993.  All Rights Reserved.
        -------------------------------------------------------------------







































                                                                    Page  i


        (C) Copyright IBM Corporation 1987, 1993



        CONTENTS


          1.0 Introduction  . . . . . . . . . . . . . . . . . . . . . . . 1
          1.1 What Is ENVED?    . . . . . . . . . . . . . . . . . . . . . 1
          1.2 What You Need   . . . . . . . . . . . . . . . . . . . . . . 1
          1.3 Using ENVED   . . . . . . . . . . . . . . . . . . . . . . . 2
            1.3.1 Installing The Editor   . . . . . . . . . . . . . . . . 2
            1.3.2 Starting The Editor   . . . . . . . . . . . . . . . . . 2
            1.3.3 Making Changes  . . . . . . . . . . . . . . . . . . . . 2
            1.3.4 Ending The Editor   . . . . . . . . . . . . . . . . . . 3
          1.4 Keyboard Summary  . . . . . . . . . . . . . . . . . . . . . 3













































                                                               Contents  ii


        (C) Copyright IBM Corporation 1987, 1993



        1.0 INTRODUCTION



        1.1 WHAT IS ENVED?

        ENVED is program to allow you to edit the environment strings
        associated with an OS/2 process.  The environment consists of a set
        of variable names each variable having a simple text string value.
        Programs running in that OS/2 process may examine the environment
        and obtain the value of one or more of these environment variables.
        Such programs often use the values they obtain to tailor their
        behaviour for an individual user.

        Many environment variables are established and given initial values
        as OS/2 starts up and processes its CONFIG.SYS file.  The
        environment can be displayed by issuing the SET command from and
        OS/2 command prompt, the result shows the variables and their
        associated values and looks something like this:

        COMPSEC=C:\OS2\CMD.EXE
        PATH=C:\OS2;C:\OS2\SYSTEM;D:\TOOLS
        DPATH=C:\OS2;C:\OS2\SYSTEM
        etc.


        The SET command can also be used to add new environment variables,
        to remove variables and to replace an existing variable's value.
        However these values are often quite lengthy and rather than
        replacing the entire value you may just want to make a few small
        changes, this is where an Environment Editor such as ENVED proves
        useful.

        ENVED may be particularly useful to program developers, since most
        compilers make extensive use of environment variables to control
        the characteristics of the compilation process.  ENVED makes
        altering those environment variables for debugging, testing or
        experimentation very simple.


        1.2 WHAT YOU NEED

        ENVED will run under IBM's OS/2 2.0 or any later version and
        requires that REXX is installed (which is the default).  It should
        also run under IBM's OS/2 1.3 or 1.2 Extended Edition, but these
        older systems have not been fully tested.

        ENVED is supplied as a single file ENVED.ZIP.  This should be
        unpacked using PKUNZIP to give:

        ENVED.CMD    This is a REXX program to run the editor.

        ENVED.DLL    This a library of functions required by the REXX
                     program.



                                                            Introduction  1


        (C) Copyright IBM Corporation 1987, 1993



        ENVED.DOC    This is the full documentation in a plain ASCII
                     printable format.

        In addition the package will contain the following important file:

        LICENSE.TXT  This contains the terms and conditions under which IBM
                     makes this program available.



        1.3 USING ENVED



        1.3.1 INSTALLING THE EDITOR

        Simply ensure that ENVED.CMD is placed in a subdirectory that is
        listed in your PATH and that ENVED.DLL is placed in a subdirectory
        that is listed in your LIBPATH.


        1.3.2 STARTING THE EDITOR

        From an OS/2 full screen or windowed command session enter the
        following command at the OS/2 prompt:

        ENVED <var1> <var2> ...


        You can put any number, including zero, of environment variable
        names after the ENVED command.  Each variable that you specify will
        be presented in a full screen edit panel (one variable per line)
        together with its current value.  If any of the variables are
        currently not set they will be displayed with a blank value.  If
        you do not specify any variable names the a complete copy the the
        current environment will be displayed.  The list of environment
        variables is always initially displayed sorted into alphabetical
        order.


        1.3.3 MAKING CHANGES

        You may move the cursor anywhere between the "Top of Environment"
        and "End of Environment" markers using the cursor control keys and
        you may make any changes you wish.  The editor starts in "replace"
        mode whereby any characters you type overwrite those already
        present, you may toggle to "insert" mode by pressing the Ins or
        Insert key.  The current mode is indicated by the size of the
        cursor.

        You may change the value of any environment variable by altering
        the text to the right of the "=" sign, or you may change the name
        of the variable to the left of the "=" sign (or you may change
        both).  If you change a variable's name this will effectively add
        a new variable leaving the old one unchanged.


                                                            Introduction  2


        (C) Copyright IBM Corporation 1987, 1993



        To add a new environment variable either press Ctrl-Enter to add a
        blank line and the type both the variable name and its value, or
        choose the existing variable that most closely matches the new one,
        press Alt-R to duplicate it, then make the required changes.

        To remove an environment variable you must set its value to
        nothing, like this:

        VARIABLE=


        The Alt-T (truncate line) key is useful for doing this.

        Note: Pressing Ctrl-Backspace (delete line) simply removes a
        variable from the list currently being edited; it does not delete
        the variable or its value from the environment.


        1.3.4 ENDING THE EDITOR

        To end ENVED and return to the OS/2 command prompt press either F3
        or F10.

        -  F3 will discard any changes you made, leaving the environment
           settings exactly as they were before ENVED was invoked.

        -  F10 will update the current environment with all the changes you
           made.



        1.4 KEYBOARD SUMMARY

        The following lists all the editing key actions that are available
        in ENVED.  These keys are similar to those used by the TINYED
        editor, although only a subset of TINYED's keys are provided.

        Right            Move the cursor one character to the right.

        Left             Move the cursor one character to the left.

        Up               Move the cursor up one line.

        Down             Move the cursor down one line.

        Ctrl-Right       Move the cursor forward to the start of the next
                         word.

        Ctrl-Left        Move the cursor back to the start of the previous
                         word.

        Tab              Move the cursor forward to the next tab position
                         (tabs are every eight columns).

        Shift-Tab        Move the cursor back to the previous tab position


                                                            Introduction  3


        (C) Copyright IBM Corporation 1987, 1993



                         (tabs are every eight columns).

        Home             Move the cursor to the start of the current line.

        End              Move the cursor to the end of the current line.

        Ctrl-Home        Move the cursor to the top of the list of
                         environment variables.

        Ctrl-End         Move the cursor to the end of the list of
                         environment variables.

        Page Up          Scroll the list of environment variables up by one
                         screenful.

        Page Down        Scroll the list of environment variables down by
                         one screenful.

        Enter            Move the cursor down one one and back to the start
                         of the line.

        Ctrl-Enter       Add a new blank line to the list of environment
                         variables.

        Backspace        Delete the character to the left of the cursor.

        Ctrl-Backspace   Remove the current environment variable from the
                         list being edited.

        Delete           Delete the character at the cursor position.

        Insert           Toggle between "replace" "insert" typing mode.

        Alt-J            Join the next line to the end of the current line.

        Alt-R            Repeat the current line (insert a new copy of the
                         current environment variable into the list).

        Alt-S            Split the current line at the cursor position.

        Alt-T            Truncate the current line (delete all the
                         characters from the cursor position to the end of
                         the line).

        F1               Display some help information; press Esc to remove
                         the help panel.

        F3               Quit the editor without making any changes.

        F10              Update the environment will all the changes made.

        Others           You can also enter any ASCII character by holding
                         down the Alt key, typing the character's ASCII
                         value (in decimal, from 1 to 255) on the numeric
                         keypad and releasing the Alt key.


                                                            Introduction  4


        (C) Copyright IBM Corporation 1987, 1993




























































                                                            Introduction  5


        ===================================================================















        ===================================================================

        (C) Copyright IBM Corporation 1987, 1993










































                                                        Printed in the U.K.