










                          Wilkes Editor
                            for OS/2

                 Copyright 1989 by Roger E. Wilkes

        Member of ASP - Association of Shareware Professionals


        Distributed by: Wilkes Software, inc.
                        5231 Longwood Drive
                        Memphis, TN  38134




                          Table of Contents

        License....................................................   i
        Warranty...................................................  ii
        Registration Fee........................................... iii

        Files......................................................   1
        Help.......................................................   2
        How WE Works...............................................   3
        Control Keys...............................................   6
            Cursor Movement Keys...................................   6
                CURSOR TO BEGINNING OF NEXT LINE...................   6
                CURSOR TO NEXT SENTENCE............................   7
                CURSOR TO NEXT WORD................................   8
                CURSOR TO PREVIOUS WORD............................   9
                CURSOR TO PREVIOUS SENTENCE........................  10
                CURSOR TO END OF LINE..............................  11
                CURSOR TO BEGINNING OF LINE........................  12
                CURSOR TO END OF DOCUMENT..........................  13
                CURSOR TO TOP OF DOCUMENT..........................  14
                CURSOR UP..........................................  15
                PAGE UP............................................  16
                CURSOR DOWN........................................  17
                PAGE DOWN..........................................  18
                CURSOR LEFT........................................  19
                CURSOR RIGHT.......................................  20
                CURSOR TO NEXT TAB POSITION........................  21
                BACKSPACE..........................................  22
            File Controls..........................................  23
                OPEN NEW FILE - ADD TO ACTIVE LIST.................  23
                GO TO THE NEXT ACTIVE FILE.........................  24
                SAVE FILE - EXIT EDITOR OR NEXT FILE...............  25
                ESCAPE FROM WHERE YOU CURRENTLY ARE................  26
            Deleting...............................................  27
                DELETE CHARACTER...................................  27
                DELETE WORD........................................  28
                DELETE LINE........................................  29
            Text Block Control.....................................  30
                BEGIN BLOCK........................................  30
                END BLOCK..........................................  31
                DELETE BLOCK.......................................  32
                COPY BLOCK.........................................  33
            Searching and Replacing................................  34
                SET SEARCH LITERAL.................................  34
                SEARCH FOR LITERAL ENTERED.........................  35
                SEARCH BACKWARD FOR LITERAL ENTERED................  36
                SET LITERAL TO CHANGE TO...........................  37
                SEARCH FOR AND CHANGE LITERAL......................  38
                SEARCH BACKWARD AND CHANGE LITERAL.................  39


        Table of Contents (cont.)



            Help...................................................  40
            Set Video Attributes...................................  41
            Save Current Controls..................................  42
            Other Controls.........................................  43
                UNDO LINE OR BLOCK.................................  43
                CHANGE CONTROL CHARACTERS..........................  44
                INSERT MODE (ON/OFF)...............................  45
                BLANKS AT END OF LINE (ON/OFF).....................  46
                SET SEARCH CASE SENSITIVE (ON/OFF).................  47

                                                                      i



            LICENSE
            -------

    Wilkes Editor, version 1.0, is being distributed under the "shareware" or
user supported concept.  This software is NOT free software.  The use or
reproduction of this software outside of the limits specified in this license
agreement is prohibited.

    Non-registered users are granted a limited license to use this software
for a period not to exceed thirty days.  During this period they should test
and evaluate the software to determine if it will meet their needs. The use of
this software beyond this limited time period requires registration.
Non-registered users are not allowed to distribute this software without the
express written permission of Wilkes Software inc.  The only exceptions to this
distribution restriction are SYSOPS of electronic bulletin boards and
distributors of public domain and user supported software.  SYSOPS and
software distributors must abide by the copying restrictions specified below.

    Registered users are granted the right to use Wilkes Editor on only
one computer at any time.  Site licensing agreements are available for
businesses, corporations, and government agencies.  Registered users are also
granted the right to copy and distribute Wilkes Editor subject to the
following conditions.

    Wilkes Editor must be copied in its original unmodified form.

    All of the files must be included in the copy.

    Wilkes Editor may not be distributed in conjunction with any other
    product without the express written consent of Wilkes Software inc.

                                                                     ii


                WARRANTY
                --------

    Wilkes Software makes no warranty of any kind, express or implied,
including without limitation, any warranties of merchantability and or fitness
for a particular purpose.  Wilkes Software shall not be liable for any
damages, whether direct, indirect, special or consequential arising from a
failure of this software to operate in the manner desired by the user.
Wilkes Software shall not be liable for any damage to data or property which
may be caused directly or indirectly by use of the program.

    IN NO EVENT WILL Wilkes Software BE LIABLE TO YOU FOR ANY DAMAGES,
INCLUDING ANY LOST PROFITS, LOST SAVINGS OR OTHER INCIDENTAL OR CONSEQUENTIAL
DAMAGES ARISING OUT OF YOUR USE OR INABILITY TO USE THE PROGRAM, OR FOR ANY
CLAIM BY ANY OTHER PARTY.

                                                                    iii



            REGISTRATION FEES
            -----------------

The registration fee for Wilkes Editor, version 1.2, is only $45.00, with
quantity discount for 10 or more copies to $30.00/copy.

Government and Education registration fee is only $35.00, with quantity
discount for 10 or more copies to $25.00/copy.

You may fill out and return the registration page below or register on-line
at (901)377-5608.  Enter "s" from the main menu and select the software you
wish to register.

Future updates of the site license copy are provided as follows. The first
update is free.   All others $15.00.

Prices are for a titled master copy and cover all charges including shipping.
Licensees will be informed when updates become available and given the option
to update at will.  There is NO penalty for skipping updates.

                                                                     iv



    If you should require assistance in the use of the Wilkes Editor, you
may call the WSI BBS at (901)377-5608.

    If you like this software please let me know.  If you have enhancements
you would like to see in this software, please let me know those also.  If you
have complaints about the way the Wilkes Editor functions I would even like to
hear those.

    The following is a registration form.  In addition to the licensing use,
I will also use this information to correlate requests for additional
functionality and for Wilkes Software mailing list purpose (only by Wilkes
Software).  When Wilkes Software offers other software into the shareware
system in the future, information will be sent to registered users of the
Wilkes Editor.  If you register a non-current version, I will send the
current version to you.

                                                                      v

to: Wilkes Software, inc.
    5231 Longwood Drive
    Memphis, TN  38134


    Name (first) ____________________  (last) ____________________

    Title    ___________________________________

    Company  ___________________________________

    Address  ___________________________________

             ___________________________________

    City     _________________________  State  ___  Zip code _______

    Where software obtained: ________________________________________

    Version of Wilkes Editor: 1.2

    System: ____________________

    OS/2 Version: _____     Media: __ 5 1/4 (360) __ 3 1/2 (720)
                                   __ 5 1/4 (1.2) __ 3 1.2 (1.44)
    Phone: (____) ____ - _____

    If Gov./Ed. please specify: _____________________________________

COST:

    $45/copy - 10 + copies  $30/copy
    Gov/Ed $35/copy - 10 + copies  $25/copy

    Tennessee Residents: sales tax is 7.75%

    # copies _________ x your price: ____________ + TN sales tax __________

        = Total _________________

METHOD OF PAYMENT:

    VISA/MASTERCARD/CHECK: __________

    V/MC account #: ___________________________  Expiration Date: _________

    Signature: __________________________________________________

                                                                      1




        Files:
        ------

            In WE12.EXE
            You should have the files WE.DOC, WE.EXE,
                                      DETAB.DOC and DETAB.EXE


        Edit Files:
        -----------

            You can have a maximum of 10 text files concurrently being
        edited. The cumulative file sizes may be as much as OS/2 will
        allow.


        Editor Control File:
        --------------------

            This file will be created the first time WE.EXE runs.
        The location of this file is controlled by the environment
        variable EDTCTL (short for Editor Control).  The environment
        variable can be set in "startup.cmd" (remember to run startup
        at the beginning of a new session or direct the system to run
        a startup session when it comes up).  The OS/2 instruction to
        be placed inside "startup.cmd" is

                    SET EDTCTL=<name of directory>

        There should be no spaces before or after the "=".

            The file "EDITOR.CTL" will be created in the specified
        directory.

            If the environment variable EDTCTL is not set, the file
        "EDITOR.CTL" will be created in the current directory.

            When the EDITOR.CTL file is created, it will contain
        all of the default control keys, video attributes and initial
        control settings.

            EDITOR.CTL contains the control keys, video attributes
        and various control initialization settings.  Any changes
        you make to control keys, video attributes, etc. will be
        kept in this file (if you save the changes).

                                                                      2




        Help:
        -----

            Help is obtained to display the control keys current
        settings by striking the F1 key.

            While the Help screen is displayed, you may use the
        control keys PgUp, PgDn, up and down arrow keys and the
        begin and end of document keys.

            The ESC key will get you out of the help screen and
        return you to the text file you were in prior to asking
        for HELP.

            The control keys are listed in the left hand column,
        and may represent the depression of multiple keys.  If a
        "+" is shown in this column, you must simultaneously
        depress the key before and after the "+".  The abreviations
        shown are:

            enter  - enter key
            ctl    - control (Ctrl) key
            end    - End key
            home   - Home key
            pgup   - page up (PgUp) key
            pgdn   - page down (PgDn) key
            curu   - cursor up (up arrow) key
            curd   - cursor down (down arrow) key
            curr   - cursor right (right arrow) key
            curl   - cursor left (left arrow) key
            tab    - Tab (right) key
            fn     - where n is the function key number
            sfn    - where n is the shifted function key number
            afn    - where n is the function key number to depress
                     with the Alt key
            ins    - insert (Ins) key
            del    - delete (Del) key
            backspace - backspace (Backspace) key
            esc    - escape (Esc) key

            All other keys shown are the actual keys.  For instance,
            "ctl+t" would be accomplished by holding down the Ctrl key
            and striking the "t" key.  Note that both keys must be
            simultaneously down to accomplish "ctl+t".

                                                                      3




        How WE Works:
        -------------

            When you run WE, you must name the text file you wish to
        edit on the command line:

                WE letter.bob

        Note: The name of the text file is an OS/2 file name (see
        Operating System/2 reference manual for file names) and may
        be no longer than 39 characters maximum with full pathing.

            Example: WE c:\mailbox\outbound\letter.bob

        This restriction will also apply to files added to the working
        list of text files within WE.  This restriction is created by
        the space alloted to the file name on the status (bottom) line
        of the WE display screen.  There is room for only 39 characters
        for the file name.


        The Display Screen:
        -------------------

            The screen is broken up into 3 areas.  The first area is
        where text is displayed and updated.  The second area is the
        Control line, where you will enter information to control the
        functioning of WE.  The Control line is located just below the
        Text area.  The third area of the screen is the status line at
        the bottom of the screen, containing the current location
        within the text file (CUR <line>,<column>), the insert status,
        whether ON or OFF, a reminder that a tab character will be
        shown as up to 4 spaces, which text file is currently being
        displayed (TXn - where n is 0-9) and the name of the file
        currently displayed.


        Display Lines:
        --------------

            A given line of text cannot be longer than 254 characters.
        Since only 80 characters of any given line can be shown on the
        screen at one time, the cursor control keys (right arrow, end,
        etc.) can be used to view any unshown portion of a line.  If
        you move the cursor outside the first 80 characters of a line,
        the entire screen will shift right or left to display the same
        columns for all lines.

                                                                      4





            The cursor will stay within columns 70-80 while the columns
        being displayed are outside the first 80 columns.  Don't be
        alarmed when everything on the screen shifts left or right.
        You can always get the screen back to the first 80 columns of
        each line by hitting the "home" key.  If someone has modified
        the home key, you can find the control key for "home" with
        "help".  If someone has changed the location of the "help"
        key, you can either locate that person, play with the keyboard
        or return to OS/2 and reset the environment variable EDTCTL to
        point to a different directory or delete the "EDITOR.CTL" file.
        The last option should be used only sparingly if there are more
        than one persons using WE on the same machine.


        Cursor Positioning:
        -------------------

            During finds, changes, block insertions, undo's, etc. WE
        will attempt to maintain the cursor close to the center of
        the screen.  When you perform one of the functions which uses
        this method of positioning the text on the screen, don't be
        startled.  The reason for this positioning is to be able to
        see text prior to and after the located, inserted, manipulated
        text.


        User Friendly:
        --------------

            Every attempt has been made with WE to strike a proper
        balance between "don't slow the user down" and "don't let
        the user hurt himself".  There are only a few places which
        stop and question the motives of the user.  Hopefully, these
        few instances represent the places where you would wish to
        be questioned.  If you attempt to edit a file which does not
        exist you will be asked if you really wish to create the file.
        If you attempt to Esc a file which has had modifications made
        to it, you will be asked if you really wish to drop the changes
        you have made.

            The attempt was made to have a user seductive, rather than
        a user friendly Editor.

                                                                      5




        Ascii Graphics:
        ---------------

            WE will allow most Ascii Graphic characters - where they
        do not conflict with control keys.  As the Esc character is
        used heavily with "ANSI.SYS" graphics, a special character is
        set aside to introduce the ESC character into text, while
        having the Esc key always represent the escape control key.
        The escape control key is the only non-modifiable control key.
        The method of entering an ESC character into a text file is to
        depress the Alt key and enter 1 then 9 on the numeric key pad,
        then lifting the Alt key (i.e. keep the Alt key depressed while
        entering both the 1 and the 9 keys).

            Ascii Graphic characters must be entered in the same way
        as the special ESC.  Keep the Alt key depressed while entering
        the number representing the Ascii Graphic character.


        Tab Character:
        --------------

            WE does not use tab characters internally but will accept
        text files which use them.  Since WE acts as if a tab stop
        were set at every 4th column (i.e. columns 4, 8, 12, 16, 20,
        etc.) the tab characters will be translated to spaces in order
        to move to these tab stops.  If you have text files containing
        tab characters, you may wish to run "DETAB.EXE" on them before
        using WE.  The DETAB program will translate tab characters to
        the desired number of spaces.

                                                                      6




        Control Keys:
        -------------

            Cursor Movement Keys:
            ---------------------

                enter: CURSOR TO BEGINNING OF NEXT LINE
                ---------------------------------------

                    The action of the enter key works in one of two
                ways, depending on the current setting of "insert".

                1) Insert ON - The current line will be broken into
                               two lines consisting of the portion of
                               the line prior to the cursor position
                               and the portion of the line under the
                               cursor to the end of the line.  The
                               second line will be positioned at the
                               beginning of the newly introduced line.

                2) Insert OFF - The cursor will move to the beginning
                               of the next line.  If you are on the
                               last line of the text you will receive
                               a message on the control line to the
                               effect that you are on the last line of
                               text with insert OFF.

                The enter key is the only way to introduce new lines
                of text other than BLOCK COPY and UNDO.  In order to
                insert a new line (open line) into the text, place the
                cursor at the beginning of the line just below the
                position of the open line and hit the enter key.  You
                can also simply key in the new line text and hit the
                enter key to break the line at the position of the
                cursor.

                                                                      7




                ctl+t: CURSOR TO NEXT SENTENCE
                ------------------------------

                    This control will move the cursor to the position
                in the text to the position of the first text following
                one of the sentence termination characters:

                . (period)
                ! (exclamation point)
                ? (question mark)

                This control was introduced to facilitate the writing
                of correspondence - for programmers who write letters
                with their editor.

                    see CURSOR TO PREVIOUS SENTENCE

                                                                      8




                ctl+w: CURSOR TO NEXT WORD
                --------------------------

                    The CURSOR TO NEXT WORD will move the cursor down
                in the text to the first non-blank character following
                one or more blank characters.

                    A word is considered to be any contiguous set of
                non-blanks.

                    see CURSOR TO PREVIOUS WORD

                                                                      9




                alt+w: CURSOR TO PREVIOUS WORD
                ------------------------------

                    The CURSOR TO PREVIOUS WORD will move the cursor
                up in the text to the beginning of the current word
                or to the previous word if the cursor is positioned
                to the immediate right of the beginning of the line
                or to the immediate right of a space.

                    A word is considered to be any contiguous set of
                non-blanks.

                    see CURSOR TO NEXT WORD

                                                                     10




                alt+t: CURSOR TO PREVIOUS SENTENCE
                ----------------------------------

                    The CURSOR TO PREVIOUS SENTENCE will move the
                cursor to the beginning of the current sentence or
                to the beginning of the previous sentence, where a
                sentence is terminated by the characters:

                . (period)
                ! (exclamation point)
                ? (question mark)

                If any characters other than blanks are between the
                cursor and the prior sentence terminator the cursor
                will be moved to the beginning of the current
                sentence.

                    see CURSOR TO NEXT SENTENCE

                                                                     11




                end: CURSOR TO END OF LINE
                --------------------------

                    The CURSOR TO END OF LINE control will move the
                cursor to the end of the current line.

                    If the line is longer than 80 characters,  all
                lines displayed will be shifted to correspond to the
                line the cursor is on.

                    see CURSOR TO BEGINNING OF LINE

                                                                     12





                home: CURSOR TO BEGINNING OF LINE
                ---------------------------------

                    The CURSOR TO BEGINNING OF LINE control will
                position the cursor to the first column of the current
                line.  If the lines currently displayed do not show
                text from the beginning of the line, all lines of the
                display will shift right to display from the first
                column.

                    see CURSOR TO END OF LINE

                                                                     13





                ctl+pgdn: CURSOR TO END OF DOCUMENT
                -----------------------------------

                    The CURSOR TO END OF DOCUMENT will move the cursor
                to the last line of the text.

                    see CURSOR TO TOP OF DOCUMENT

                                                                     14




                ctl+pgup: CURSOR TO TOP OF DOCUMENT
                -----------------------------------

                    The CURSOR TO TOP OF DOCUMENT will move the cursor
                to the first line of text.

                    see CURSOR TO END OF DOCUMENT

                                                                     15




                curu: CURSOR UP
                ---------------

                    CURSOR UP moves the cursor to the previous line
                of text, if there is a previous line of text.  If the
                cursor is already at the first line of text, there
                will be no action.  The column in which the cursor
                resides is unchanged.

                    see CURSOR DOWN, CURSOR RIGHT and CURSOR LEFT

                                                                     16




                pgup: PAGE UP
                -------------

                    The PAGE UP control will bring the previous 23
                lines of text onto the screen.  If there are less than
                23 lines of text prior to the first line currently
                being displayed, the displayed lines will begin with
                the first line of text in the document.

                    see PAGE DOWN

                                                                     17




                curd: CURSOR DOWN
                -----------------

                    The CURSOR DOWN control will position the cursor to
                the next line, in the same column it is presently in.

                    If the cursor is on the last line of the document,
                no action will be taken.

                    see CURSOR UP, CURSOR RIGHT and CURSOR LEFT

                                                                     18




                pgdn: PAGE DOWN
                ---------------

                    The PAGE DOWN control will bring the next 23
                lines of text onto the screen.  If the number of
                lines of text after the line on which the cursor
                resides is less than 23, then the last lines of text
                will be displayed.

                    see PAGE UP

                                                                     19




                curl: CURSOR LEFT
                -----------------

                    The CURSOR LEFT control moves the cursor one
                position to the left.  If the cursor is at the first
                column of the line, no action will be taken.

                    see CURSOR UP, CURSOR DOWN and CURSOR RIGHT

                                                                     20




                curr: CURSOR RIGHT
                ------------------

                    The CURSOR RIGHT control moves the cursor one
                position to the right.  If the cursor moves beyond
                the first 80 columns of the line, all lines displayed
                will shift left to keep the cursor within columns
                70-80.  If the cursor attempts to move beyond the
                maximum length of a line, a message to that effect
                will be displayed on the control line.

                    see CURSOR UP, CURSOR DOWN and CURSOR LEFT

                                                                     21




                tab: CURSOR TO NEXT TAB POSITION
                --------------------------------

                    There are automatic tab stops at every 4th column
                of the line.  Striking the TAB key will move the
                cursor to the next tab stop and insert spaces into
                the text sufficient to correspond to the way the text
                looks on the screen.

                                                                     22




                backspace: BACKSPACE
                --------------------

                    The BACKSPACE control will act in one of two
                ways, depending on the current setting of the INS
                (insert) control:

                1) Insert ON - The cursor will move left one position,
                               deleting the character which was in
                               that position, and the text following
                               the cursor on the line will be shifted
                               left one position.

                2) Insert OFF - The cursor will move left one position,
                                and delete the character in the column
                                to which it moves, but the text under
                                and after the cursor for the line will
                                remain in position.

                                                                     23




            File Controls:
            --------------

                f4: OPEN NEW FILE - ADD TO ACTIVE LIST
                --------------------------------------

                    WE can work with up to 10 active files at a
                time.

                    In order to add a new file to the active files
                list, hit the F4 key.  You will be asked for the
                file name on the control line.  Enter up to 39
                characters for the OS/2 file name and hit the
                enter key.  The new file will be brought to the
                screen.

                    If a requested file does not exist, you will
                be asked, on the control line, if you wish to
                create the file.  If you answer "n", the cursor
                will move back to the text position it was on
                prior to F4 having been struck.  If you answer "y",
                you will be presented with a blank text area in
                which to enter text.

                    If you attempt to excede the maximum of 10
                active files, you will be notified on the control
                line.

                    see GO TO THE NEXT ACTIVE FILE, SET VIDEO
                ATTRIBUTES, SAVE FILE - EXIT EDITOR OR NEXT FILE
                and ESCAPE FROM WHERE YOU CURRENTLY ARE

                                                                     24




                af4: GO TO THE NEXT ACTIVE FILE
                -------------------------------

                    The name of the current active text file is
                displayed on the status line, and just in front of
                the file name is an indicator of which of the 10
                active text files you are currently working in.
                If you have multiple copies of the same text file
                active the TXn indicator on the status line will
                help distinguish the text file iteration.  You may
                also set the video attributes separately for each
                of the 10 active files in order to further
                distinguish which text file is being worked in.

                    see OPEN NEW FILE - ADD TO ACTIVE LIST, SET VIDEO
                ATTRIBUTES, SAVE FILE - EXIT EDITOR OR NEXT FILE
                and ESCAPE FROM WHERE YOU CURRENTLY ARE

                                                                     25




                cf1: SAVE FILE - EXIT EDITOR OR NEXT FILE
                -----------------------------------------

                    Saving a file to disk is accomplished by holding
                the control key down and hitting the F1 key.  The
                text file will be written to disk.  The text file
                already on disk by the same name will be renamed to
                have a file name extension of .BAK.  If the file name
                of the text file contains a file name of .BAK, it
                will be renamed to have a file name extension of .BK2.

                    If a file is saved which has had no modifications
                made to it, a message to that effect will be displayed
                on the control line, or if there are no more active
                files, it will be displayed upon return to OS/2.

                    When a text file has been saved to disk, there
                will be an additional open position in which you may
                add another text file to the active list.

                    see OPEN NEW FILE - ADD TO ACTIVE LIST, GO TO THE
                NEXT ACTIVE FILE, SET VIDEO ATTRIBUTES,
                and ESCAPE FROM WHERE YOU CURRENTLY ARE

                                                                     26




                esc: ESCAPE FROM WHERE YOU CURRENTLY ARE
                ----------------------------------------

                    The reason ESC was included in the file controls
                is that this is where it has its strongest effect.

                    If the cursor is within the text area of the
                screen, the ESC will drop the text without saving
                it to disk.  If you have made changes to the text
                a prompt will appear on the control line:

                    Drop Changes (y/n)?

                If you wish to drop the changes made to this text
                answer "y" and the text will go away.  If you have
                made changes which you don't wish to destroy,
                answer "n" and the ESC will be forgotten and you
                will be returned to the text area of the same
                text file on which you were working.  Note that
                this prompt is the only prompt from which you
                cannot escape.  You must answer "y" or "n".

                    The ESC control is the only control which cannot
                be modified.

                    ESC will generally escape you from whereever
                you are.  For instance, if you are entering a new
                file name to be added to the active list, and
                decide not to add a new file at this time, hitting
                the ESC key will move the cursor back to the text
                area of the screen for you to continue to work in
                the current text file.

                    see OPEN NEW FILE - ADD TO ACTIVE LIST, GO TO THE
                NEXT ACTIVE FILE, SET VIDEO ATTRIBUTES and
                SAVE FILE - EXIT EDITOR OR NEXT FILE

                                                                     27




            Deleting:
            ---------

                del: DELETE CHARACTER
                ---------------------

                    The DELETE CHARACTER control will delete the
                character under the cursor and move the text to the
                right of the cursor one position to the left to
                close up the deleted character position.

                    see DELETE WORD, DELETE LINE and DELETE BLOCK

                                                                     28




                sf6: DELETE WORD
                ----------------

                    The DELETE WORD control will delete the word
                under the cursor and draw the text following the
                deleted word left to close up the gap created by
                deleting the word.  If the cursor is sitting on
                a blank, no action will be taken.

                    see DELETE CHARACTER, DELETE LINE and DELETE
                BLOCK

                                                                     29




                f6: DELETE LINE
                ---------------

                    The DELETE LINE control will take one of two
                actions depending on where the cursor is on the
                line:

                1) Cursor at first position of the line - The
                   entire line will be deleted and following
                   text lines shifted up to fill in the gap
                   created by the deleted line.

                2) Cursor not at first position of the line - The
                   text under and following the cursor on the line
                   will be deleted.  The line will remain in place.

                    see DELETE CHARACTER, DELETE WORD and DELETE
                BLOCK

                                                                     30




            Text Block Control:
            ------------------------

                ctl+home: BEGIN BLOCK
                ---------------------

                    The BEGIN BLOCK control marks the position of
                the cursor as the beginning of a block.

                    If any changes are made to the text (other than
                cursor movement), the begin block marking will be
                terminated.

                    The purpose of the begin block marking is to
                subsequently mark the end of the block, in order to
                copy the contents of the block or to delete the
                block of text.

                                                                     31




                ctl+end: END BLOCK
                ------------------

                    The END BLOCK control marks the end of a text
                block.

                    When the end of the block is marked, the entire
                block is copied to a new memory location, in order
                to preserve the contents of the block if the block
                is subsequently deleted.  This allows us to copy the
                block of text into a new location even after the
                block has been deleted from its original location.

                                                                     32




                ctl+del: DELETE BLOCK
                ---------------------

                    The DELETE BLOCK control will delete the marked
                block from the text file it was defined for.  If you
                mark a block and change text files, you will not be
                allowed to delete the block until you return to the
                text file for which the block was originally defined.

                                                                     33




                ctl+b: COPY BLOCK
                -----------------

                    The COPY BLOCK control allows you to copy a block
                of information from one point in the text to another
                point.  This includes the ability to copy the block
                from one text file into another text file.

                                                                     34




            Searching and Replacing:
            ------------------------

                alt+l: SET SEARCH LITERAL
                -------------------------

                    When you enter the SET SEARCH LITERAL control
                you will be prompted on the control line for the
                search literal.  Enter the text to be searched for
                at the cursor, then hit the enter key.  The cursor
                will be returned to the text area.  The search
                literal will be retained until you either change
                the search literal by performing the SET SEARCH
                LITERAL control again or exit WE.

                    see SEARCH FOR LITERAL ENTERED,
                SEARCH BACKWARD FOR LITERAL ENTERED,
                SEARCH FOR AND CHANGE LITERAL and
                SEARCH BACKWARD AND CHANGE LITERAL

                                                                     35




                alt+f: SEARCH FOR LITERAL ENTERED
                ---------------------------------

                    The literal entered refers to the literal
                entered during the SET SEARCH LITERAL control.

                    The search's case sensitivity may be altered
                by the SET SEARCH CASE SENSITIVITY (ON/OFF)
                control.  See this control below.

                    When a matching literal is found, the cursor
                will be placed at the end of the literal, in
                order not to find that same literal on successive
                searches.  This also allows the search backward
                to find this literal first.

                    see SET SEARCH LITERAL and
                SET SEARCH CASE SENSITIVITY (ON/OFF)

                                                                     36




                alt+g: SEARCH BACKWARD FOR LITERAL ENTERED
                ------------------------------------------

                    Similar to SEARCH FOR LITERAL ENTERED control,
                except that the literal is searched for backward
                through the text.

                    see SET SEARCH LITERAL, SEARCH FOR LITERAL
                ENTERED and SET SEARCH CASE SENSITIVITY (ON/OFF)

                                                                     37




                alt+h: SET LITERAL TO CHANGE TO
                -------------------------------

                    The SET LITERAL TO CHANGE TO control lets
                you specify a literal to be substituted for the
                literal specified in the SET SEARCH LITERAL.
                As this literal is specified independent of the
                SEARCH LITERAL, you may change the SEARCH LITERAL
                several times, changing several literals to the
                same LITERAL TO CHANGE TO.

                    see SEARCH FOR AND CHANGE LITERAL,
                SEARCH BACKWARD AND CHANGE LITERAL

                                                                     38




                alt+j: SEARCH FOR AND CHANGE LITERAL
                ------------------------------------

                    The SEARCH FOR AND CHANGE LITERAL control
                uses the SEARCH FOR LITERAL ENTERED routine to
                locate the literal to be replaced.

                    see SET LITERAL TO CHANGE TO,
                SET SEARCH LITERAL, SEARCH FOR LITERAL ENTERED and
                SET SEARCH CASE SENSITIVITY (ON/OFF)

                                                                     39




                alt+k: SEARCH BACKWARD AND CHANGE LITERAL
                -----------------------------------------

                    The SEARCH BACKWARD AND CHANGE LITERAL control
                uses the SEARCH BACKWARD FOR LITERAL ENTERED
                routine to locate the literal to be replaced.

                    see SET LITERAL TO CHANGE TO,
                SET SEARCH LITERAL, SEARCH BACKWARD FOR LITERAL
                ENTERED and SET SEARCH CASE SENSITIVITY (ON/OFF)

                                                                     40




            Help:
            -----

                help: HELP
                ----------

                    Help is similar to a separate text file which
                displays two columns:

                1) The current key(s) to access the control and
                2) An explaination of the control.

                    These columns cannot be modified directly, but
                will change if you modify the control keys with
                CHANGE CONTROL KEYS discussed below.

                    The help display is an exhaustive display of
                the control keys and their meanings.

                                                                     41




            Set Video Attributes:
            ---------------------

                ctl+v: SET VIDEO ATTRIBUTES
                ---------------------------

                    The video attributes are kept separately for
                each of the 10 possible active text files.

                    Each text file's video attributes consists of
                three attributes - corresponding to the screen
                areas:

                1) Text area - where you enter and modify text
                2) Control line - where you receive messages and
                   answer prompts (questions)
                3) Status line - at the bottom of the screen

                    You may modify only one or two of the areas
                video attributes if you wish by escaping (ESC)
                after making the modifications you wish.

                    The video attributes are modified only for
                the text file area you are currently working in.
                The video attributes will correspond to the "n" of
                status lines "TXn".

                                                                     42




            Save Current Controls:
            ----------------------

                ctl+y: SAVE THE CURRENT CONTROLS
                --------------------------------

                    The EDITOR.CTL file contains all of the
                control key settings, video attributes and
                control initialization settings.

                    If you have made changes to any of the
                above and wish to save them, depress the Ctrl
                key and hit "y".  This will write the current
                controls into the EDITOR.CTL file.

                    Since WE will create a new EDITOR.CTL file
                if it is missing, you may move back to the
                default control settings by deleting the
                EDITOR.CTL file from the OS/2 prompt.

                                                                     43




            Other Controls:
            ---------------

                ctl+u: UNDO LINE OR BLOCK
                -------------------------

                    When a line is updated (the update takes place
                when you move the cursor from the modified line)
                it is stored in its original form.  In this way we
                can recover text which has been modified, back to
                its original contents.

                    The UNDO will undo a line or block at a time.

                    The scope of the undo is by individual text file.
                If you wish to undo changes made to several files,
                you will have to go to each text file and undo them
                individually.

                    Undo will only undo while you are within WE.
                When WE is exited, all information pertaining to
                undo is forgotten.

                    The maximum number of lines/blocks which may
                be undone is 100 per text file.  If you need to go
                back further than this, you may need to escape the
                text file and drop all changes.

                    Note that the undo will be stored until you
                undo or it is pushed off the undo stack (100 entries).
                If you undo a line/block, modify a line, and undo
                the modifications to that line, the other entries
                on the undo stack are still available to be undone.

                                                                     44




                f2: CHANGE CONTROL CHARACTERS
                -----------------------------

                    If you wish to change the key(s) associated with
                a particular control, this control will allow you
                to make that change.

                    If, for instance, you wish to have the OPEN
                NEW FILE control to be placed on the F9 key rather
                than the F4 key (default), strike F2.  The control
                line will contain "Enter CURRENT Control Character".
                Hit the control character to be changed - F4.  The
                current control setting for F4 will be displayed
                and a prompt for the control key(s) to be the new
                key(s) for opening a new file.  Enter F9.  The
                control key change is accomplished.

                    There are several control key combinations with
                the Ctrl key + another key and Alt key + another
                key.

                    You will not be allowed to change a control to
                a key which is already being used as a control key.

                                                                     45




                ins: INSERT MODE (ON/OFF)
                -------------------------

                    The insert mode current setting is displayed
                on the status line at the bottom of the screen.

                    The insert mode setting will alter the way
                the enter and backspace keys work.

                    If insert mode is OFF, you will be overtyping
                text.  If insert mode is ON, you will be inserting
                text at the position of the cursor.

                                                                     46




                alt+1: BLANKS AT END OF LINE (ON/OFF)
                -------------------------------------

                    The BLANKS AT END OF LINE control determines
                whether any terminating blanks will be saved or
                not.  This action takes place when the line is
                updated, and applies only at the line update level.

                    If you set this control to ON, modify a line and
                move the cursor to a new line, any blanks at the end
                of the line will be retained.

                    If you set this control to OFF, modify a line
                and move the cursor to a new line, blanks at the end
                of the updated line will be removed.

                    This control does not display, but you can find
                out if it is on or off by testing it.  When you move
                to the end of the line with the END control, you are
                moving to the position just past the end of the line
                and if there are blanks at the end of the line, the
                cursor will be to the right of these blanks.

                                                                     47




                af1: SET SEARCH CASE SENSITIVE (ON/OFF)
                ---------------------------------------

                    This control determines whether upper case and
                lower case will match on a search.  It is defaulted
                to on, but may be changed and saved.

                    Example: If we are searching for "screen" and
                case sensitive is ON, we would not get a match on
                text containing "Screen".  If case sensitive is off
                "screen" would match "Screen".

                    The case sensitive control determines matches on
                both searches and search and replace.

                    As this control is not displayed, you may determine
                if it is on or off by testing it.


